`ship-spec planning`

Spec-driven feature planning with AI-guided clarification, PRD, Tech Spec, and agent-ready task prompts.

ship-spec planning --cloud-ok
ship-spec planning "Add user authentication" --cloud-ok
ship-spec planning --track <track-id> --cloud-ok   # resume
ship-spec planning --reindex --cloud-ok            # re-index codebase first

Options:

Flag	Description	Default
`--track <id>`	Resume an existing planning session	Creates new
`--reindex`	Force full code re-index	`false`
`--no-save`	Print outputs only	`false`
`--cloud-ok`	Consent to cloud LLM usage	Required
`--local-only`	Use only local models (Ollama)	`false`

Workflow phases:

Clarification — AI asks follow-ups
PRD generation & review
Tech Spec generation & review
Task generation — agent-ready prompts

Outputs: .ship-spec/planning/<track-id>/

prd.md
tech-spec.md
tasks.md (agent-ready prompts)
context.md (clarification Q&A)
track.json

Key benefits:

Human-in-the-loop approvals at every stage
Session persistence (--track) for long-running work
Hybrid RAG over your codebase for context-aware specs