Commands

The command surface, without guessing

Reading commands answer. Writing commands dry-run by default and write only under --apply — and --force is never exposed.

Cited release v1.20.1

The forgeos command

Read commands report state. Write commands show a dry run first and require --apply before changing files.

Command	Purpose	Behavior
`forgeos status`	Where the project is: state ledger, work, gates, validation, and next capability	read-only
`forgeos next`	The next safe slice of work, with a drafted governance window and a copyable prompt	read-only
`forgeos prompt`	The complete next-session package: scope, policy, reading order, validation plan, and a paste-ready prompt	read-only
`forgeos brief`	The same next-session package held to a strict size budget, measured by the command itself	read-only
`forgeos intake`	What kind of project this is, how ready it is, and which prompt family the next session belongs to	read-only
`forgeos doctor`	Prerequisite report: shell, JSON reader, git, hook wiring, line endings, and manifest	read-only
`forgeos version`	Which ForgeOS this is; an unknown release is reported unknown, never inferred	read-only
`forgeos adopt`	Bring ForgeOS into a project by delegating to sync-blueprint	dry-run by default
`forgeos update`	Refresh an adopted project; refuses a target that never adopted	dry-run by default

forgeos status

forgeos status
forgeos status --json

forgeos next

forgeos next
forgeos next --json

forgeos prompt

forgeos prompt
forgeos prompt --json

forgeos brief

forgeos brief
forgeos brief --json

forgeos intake

forgeos intake
forgeos intake --json

forgeos doctor

forgeos doctor
forgeos doctor --json

forgeos version

forgeos version
forgeos version --json

forgeos adopt

forgeos adopt --target <project>
forgeos adopt --target <project> --apply

forgeos update

forgeos update --target <project>
forgeos update --target <project> --apply

The governed work loop, from definition to closure.

Command	Purpose	Behavior
`/discovery`	Define an undefined project — six phases, fires automatically	writes project facts
`/adopt`	Fill the blueprint from an existing codebase	writes adoption records
`/start-task`	Turn a request into a bounded task with observable criteria	writes task files
`/implement`	Apply it as the smallest complete change	writes scoped changes
`/review`	Independent correctness, safety, and evidence check	read-first review
`/finish-task`	Close only after the full Definition of Done	writes closure state
`/handoff`	Continuation record for another session	writes transfer context
`/adr`	Record a durable decision	writes decision records
`/build-context`	Package deterministic context for transfer	writes a context package
`/blueprint-validate`	Run every check	read-only validation