init | Scaffold or refresh repository configuration and check prerequisites. | Local | Writes configuration and approved setup files. | Updated configuration with your existing values preserved, plus any prerequisite gaps it found. |
spec <user story> | Turn a rough request into an approved GitHub issue. The canonical issue-drafting command. | Local | Creates one issue, only after you approve the draft. | An approved issue. It is ready to implement when its Blocked section holds no unresolved decision. |
create-issue <user story> | Transitional alias for spec — turn a rough request into an approved GitHub issue. Prefer spec for new work. | Local | Creates one issue, only after you approve the draft. | An approved issue. It is ready to implement when its Blocked section holds no unresolved decision. |
implement <issue number> | Carry an issue through to a pull request. | Local, and a comment on an issue | Creates or adopts a branch, commits, pushes and creates or updates a pull request. | A review-ready or draft pull request with recorded verification evidence, or a Blocked result naming what a person must do. |
review [pull request number] [--issue N] | Assess a pull request or the current branch. | Local, and a comment on a pull request | Nothing in the reviewed tree. In pull-request mode it can post comments and a formal review. | Findings and a verdict, with any incomplete check reported. |
review-and-fix [pull request number] [--push-each-iteration] [--issue N] | Assess changes and commit authorized corrections. | Local, and a comment on a pull request | Commits corrections. A local run pushes only with --push-each-iteration; a comment-triggered run pushes to the pull request branch. | Corrections followed by recorded verification, or a report naming unresolved findings. |
pr-description [issue number] | Generate or refresh the current branch’s pull request body. | Local, and a comment on a pull request | Updates an existing pull request body. Makes no file edits. | A structured description, or plain text when no pull request exists. |
fix [pull request number or feedback] | Verify review feedback you received and address what meets the correction threshold. | Local | Can edit files on the active branch and run tests, after verifying the feedback. | Verified dispositions, authorized corrections and verification evidence, or a report naming blockers. |
requesting-code-review | Ask an independent reviewer to assess the current work. | Local | Nothing. The reviewer does not edit the tree. | Review findings returned to your session. |
docs | Run the internal, external and release-note documentation sequence. | Local | Edits documentation files. Does not commit. | A branch-wide documentation pass and a summary. |
docs-sync-internal | Bring developer docs in line with changed code. | Local | Edits internal documentation. | Internal docs matching the branch’s behavior changes. |
docs-sync-external | Bring public docs in line with internal sources and shipped behavior. | Local | Edits customer-facing documentation. | Updated public guidance with internal-only detail removed. |
docs-bootstrap-internal | Create or comprehensively reorganize developer docs. | Local | Creates and edits internal documentation. | A structured internal documentation set. |
docs-bootstrap-external | Create or comprehensively rebuild public docs from internal docs. | Local | Creates, edits and can remove customer-facing documentation. | A structured public documentation set. |
docs-verify [--report-only] [--lead docs|code] <topic> | Check one documentation topic against the code. | Local | Corrects internal docs by default. --report-only changes nothing. | Corrected topic docs, or a findings report. |
docs-release-notes | Add a release note where one applies and reconcile the changelog. | Local | Edits the configured release-note and changelog files. | A customer-facing note, or an explicit decision to skip. |
retrospective-weekly | Analyze recently merged work and file bounded improvements for human triage. | Local | Updates learning records, opens or updates a state pull request and files selected issues. | A report, a state pull request, filed issues and any blockers. |