design-rationale

Explanation: Prompt Workflow Design Rationale

We designed the prompts for deterministic, traceable, and extensible workflows, optimized for both greenfield and legacy codebases.

Key Principles

• Interactive, clarification-first authoring
• Spec as single source of truth post-confirmation
• Full traceability across Spec → Plan → Breakdown → Code → Docs
• Diátaxis-driven documentation tasks baked into plans
• ADR change control to evolve decisions safely

Greenfield vs Existing Projects

• Greenfield uses presets as suggestions only; then locks to the spec
• Existing projects detect and extend current architecture patterns first

Guardrails

• Presets are ignored after spec creation and by all downstream prompts
• Deviations require ADRs and propagation across artifacts