Title: PRD Generation
Guardrails
- Trace only flows supported by source, docs, tests, or explicit user context.
- Label inferred lifecycle steps as assumptions.
- Keep the trace focused on primary flows. Do not add speculative components.
- Do not modify source code.
User Story: As a developer, I want to provide a high-level feature idea and receive a structured, unambiguous PRD so that a junior developer can implement it with minimal oversight.
Layer 1: User Journey (Flowchart)
Layer 2: Component Architecture
| Component | Logic Source | Responsibility | Key Reference |
|---|---|---|---|
| User Interface | System Prompt | Capture intent and selections | Prompt Entry |
| Clarification Processor | Rule: Process |
Generate lettered/numbered questions | PRD Mode: Step 2 |
| Generation Engine | Rule: Structure |
Format data into standard PRD sections | PRD Structure |
| Storage Manager | Rule: Output |
Write Markdown to specific directory | /tasks/prd-*.md |
Layer 3: Sequence Diagram
Key Design Patterns Used:
- Stateful Interaction: The system pauses for user feedback (Clarification Step) before proceeding to final generation, ensuring accuracy.
- Template Method: The PRD follows a rigid, predefined structure regardless of the feature content to ensure consistency.
- Persistence Ignorance: The logic focuses on document structure, while the storage rule dictates the final file path and naming convention.
Data Structures
Quick Reference
- Event Triggers: User prompt containing "new feature" or "PRD".
- File Format: Standard GFM (GitHub Flavored Markdown).
- Error Handling: If requirements are ambiguous, the AI must re-trigger the clarification loop.
- Validation: Final PRD must be legible by a "Junior Developer" profile.
Related Lifecycles
- Task Decomposition: Converting a PRD into a
tasks-prd-*.mdfile. - DAP Implementation: Creating a Deployment Action Plan for schema changes.
- System Onboarding: Generating
use_cases.mdfrom repo analysis.
Next Step: I can now save this lifecycle trace to .planning/memory/system/001_lifecycle_prd_generation.md. Would you like me to finalize the file creation?
Install:
npx skills add ChristopherAlphonse/calphonse-skills --skill application-lifecycle-trace