The plan-product
command kicks off this essential first phase of the spec-driven development workflow with Agent OS. It is typically run only once at the beginning a new project, or on the day you install Agent OS into an existing project.
The product planning phase is where you define the strategic product mission, its projected feature development roadmap, and its technology stack.
What gets created
The plan-product
command ultimately creates three core documents in your project's product folder: agent-os/product/
:
- mission.md - Product mission, vision, target users, use cases, differentiators, etc.
- roadmap.md - Prioritized feature list to serve as a general guide for development.
- tech-stack.md - Technology choices for frontend, backend, infrastructure, etc.
These documents are then used by your agents when planning specs and implementing features to ensure alignment with your high-level goals of your product.
How to run
Multi-Agent Mode
Run command, /plan-product
When you're running Agent OS in multi-agent mode (typically in Claude Code), you can initiate and run the entire product planning phase with a single command:
/plan-product
The product-planner subagent will then gather information interactively and create all documents in the agent-os/product/
folder.
Single-Agent Mode
Run these four prompts sequentially
Run each of the following prompts sequentially in your AI tool. You can simply @ reference the prompt markdown file and append "run this" (or similar) to your prompt to instruct your AI tool to read and run the instructions in that file.
@agent-os/commands/plan-product/1-plan-product.md run this
These next three prompts can be run one after another, or (if your AI tool supports it) you can queue them all up to run one after another automatically.
@agent-os/commands/plan-product/2-create-mission.md run this
@agent-os/commands/plan-product/3-create-roadmap.md run this
@agent-os/commands/plan-product/4-create-tech-stack.md run this
Next step
Now that you have your product plan documented, you're ready to start planning your first spec.