1. Habit
  2. Skills
  3. Architect skill
jsmastery-pro · 7K installs

Architect skill
Runs by itself, when a decision is still open.

Open decisions get settled and written down.

Install the Architect skill and make it a habit: follow https://gethabit.dev/skills/jsmastery-pro/architect.md

  1. 1Copy
  2. 2Paste into Claude Code, Codex or Cursor
  3. 3It runs by itself

7K installs2K starsMIT licenceSource on GitHub ↗

Architect

by jsmastery-pro · 7K installs

The skill

Helps you pick between options and writes the plan down.

Only when you ask.

Fewer wrong turns

Open decisions get settled and written down. Fewer guesses and less rework.

↻ Runs by itselfwhen a decision is still open

How the habit works.
You don't have to.

Three questionsWhen does it start? How does it check its work? What does it remember?

01

It starts by itself

decision owed or Assumed. Runs in Claude Code routine.

  • ↻ decision owed or Assumed
  • /develop records an Assumed spec, or you run /architect <topic>

02

It checks its work

you confirm the spec. If a check fails, it tells you.

  • ✓spec file exists in docs/specs/ with the next free NNNN
  • ✓spec has Requirements, Decision and Build plan sections
  • ✓no spec left in Assumed status after a ratify run

03

It remembers

spec folder. The next run reads it first: titles of existing specs and any Assumed spec for the topic.

docs/specs/

One run, step by step.
Then it stops.

Stop ruleStops after one decision spec per run.

  1. 01

    Pre-flight

    Your agent checks git freshness, resolves the spec folder, lists specs and reads AGENTS.md and the scope row.

  2. 02

    Check overlap

    It asks whether to create, update or supersede if a spec already overlaps.

  3. 03

    Design conversation

    It reads internal/design-conversation.md and asks only what you alone know.

  4. 04

    Recommend

    It states a pick, a one line reason and a runner up for each choice.

  5. 05

    Write the spec

    It reads agent-prompt.md, spec-template.md and the mode file, then writes the spec.

  6. 06

    Cross check

    It asks if you want a read only review of the drafted spec.

  7. 07

    Confirm and link

    You confirm, and it follows internal/after-subagent.md to update status and the scope row.

What it may do.
Nothing more.

Safe by defaultIt writes only in its own folder and asks you before anything goes out.

Is it for you?
Use it when it fits.

Quick checkRead both lists. If the left one sounds like you, the Architect skill helps.

Use it when

  • ✓ You pick between approaches
  • ✓ You design a feature or page
  • ✓ You choose a tech stack

Skip it when

  • – The decision is trivial
  • – You want code written now

Questions

Architect skill, answered.

Does it write code?

No. It writes specs only and never edits AGENTS.md or CLAUDE.md.

What is an Assumed spec?

A spec /develop recorded when you built before deciding. /architect ratifies or supersedes it.

How do I install the Architect skill?

Copy the prompt at the top into your agent. It installs the skill from jsmastery-pro/skills and sets up the habit. Or run npx skills add jsmastery-pro/skills --skill architect.

Is the Architect skill free?

Yes. It is published under MIT. Habit is free too.

Architect. Now as a habit.

Install the Architect skill and make it a habit: follow https://gethabit.dev/skills/jsmastery-pro/architect.md

  • Free
  • No account
  • Undo in one line

All jsmastery-pro skills →More planning skills →

Works in

  • Claude Code
  • Codex
  • Cursor
  • ChatGPT
  • Claude app

Made by jsmastery-pro, published under MIT. Habit links to the original and never changes it. Is this your skill?

Copying didn't work here. Select the line and copy it by hand.