Commands

Every SpecForge command is a skill namespaced by the plugin as /specforge:<name>. Skills whose side effects should be deliberate are user-invoked only — Claude won’t trigger them on its own.

Command	Auto-invocable?	Writes	Notes
/specforge:init	yes	specforge/ workspace	Safe to re-run; never clobbers
/specforge:constitution	yes	constitution.md	4–8 soft-gate principles
/specforge:reverse-engineer	yes	specs/000-baseline/*	Read-only on your code
/specforge:specify	yes	specs/NNN/spec.md	Sets the feature active
/specforge:clarify	yes	clarifications.md	Questions-in-a-file
/specforge:plan	yes	plan.md + companions	Constitution + tech-env checked
/specforge:tasks	yes	tasks.md	[P] tags + traceability
/specforge:analyze	yes	analysis.md	Read-only gap report
/specforge:approve <stage>	no	state.md	Human sign-off; opens the gate
/specforge:implement	no	your code	Gated on spec+plan approval
/specforge:loop	no	your code	Governed autonomous loop
/specforge:operate	yes	operations.md	Deploy/runbook/rollback/handoff plan
/specforge:quick	no	state.md	Audited fast-track
/specforge:status	yes	—	Read-only snapshot
/specforge:resume	yes	—	Continue after a context reset

Subagents

Each phase can delegate to a focused subagent:

Agent	Tools	Role
spec-analyst	Read/Write/Edit/Glob/Grep	Draft spec.md
architect	Read/Write/Edit/Glob/Grep	Produce plan.md + design
implementer	+ Bash	Execute tasks.md under gate
reviewer	Read/Glob/Grep (read-only)	Audit spec ↔ plan ↔ tasks
reverse-engineer	Read/Glob/Grep/Bash	Brownfield baseline

The state contract

specforge/state.md is the machine-readable source of truth the gate parses:

• Header markers: <!-- active: <feature|none> --> and <!-- fasttrack: on|off -->.
• An approvals table with rows | <feature> | <stage> | <pending|done|approved> | <date> |.

The gate allows code edits when the active feature’s specify and plan rows read approved (or fasttrack is on, or the edit is inside specforge/).