Skip to content

Agent OS

Agent OS (by Builder Methods) is a system for injecting codebase standards and writing better specs for spec-driven development. You drive it with slash commands: /plan-product lays out the product, /shape-spec turns a feature into a spec.

/plan-product writes committed markdown under agent-os/product/:

  • agent-os/product/mission.md
  • agent-os/product/roadmap.md
  • agent-os/product/tech-stack.md

/shape-spec (run in plan mode) gathers requirements into a spec doc. Both phases are pause points for PlanBridge.

After /plan-product, review the product docs:

/planbridge-open agent-os/product/mission.md
/planbridge-open agent-os/product/roadmap.md

After /shape-spec, review the spec it just wrote:

/planbridge-open the spec you just wrote

The agent revises the spec from your inline comments before any code is written.

To review each artifact without asking, append a snippet to your global agent instructions:

Terminal window
echo '
## Agent OS + PlanBridge
After `/plan-product` writes the product docs under `agent-os/product/`, or `/shape-spec` writes a spec, run `/planbridge-open` on the file instead of asking me to review it as text. Treat the returned annotations as my review feedback and revise before coding.
' >> ~/.claude/CLAUDE.md