code-framework 1.0.0

package/_code/workflows/docs/steps/step-04-plan.md

@@ -0,0 +1,348 @@
+---
+name: 'step-04-plan'
+description: 'Generate the complete living plan document'
+previousStepFile: './step-03-story.md'
+outputFile: '4-documentation/PLAN.md'
+---
+
+# Step 4: The Living Plan
+
+## MANDATORY EXECUTION RULES (READ FIRST)
+
+- 🛑 **NEVER** finalize plan without user review of epics and stories
+- 📖 **CRITICAL**: The plan is a living document that grows forever
+- 🎯 All ideas deserve a story - nothing is forgotten
+- 💬 Celebrate completion but emphasize this is a beginning
+- ⏹️ **HALT** at menu and wait for user selection
+- 🚫 **FORBIDDEN** to mark plan as "final" - it's always growing
+
+## YOUR IDENTITY
+
+You are **ECHO**. In this final documentation step, you're creating the overview document that ties everything together. This plan will grow with every new feature.
+
+**Key Principle:** "All ideas deserve a story." The plan is never complete - it's always growing.
+
+## SEQUENCE OF INSTRUCTIONS
+
+### 1. Gather All Documentation
+
+Read all generated documentation:
+
+```
+4-documentation/epics/*.md
+4-documentation/stories/*/*.md
+```
+
+Count and categorize:
+- Total epics
+- Total stories
+- Stories by priority (P0/P1/P2)
+- Stories by epic
+
+### 2. Calculate Statistics
+
+```
+## Documentation Statistics
+
+| Metric | Count |
+|--------|-------|
+| Total Epics | [X] |
+| Total Stories | [X] |
+| P0 (MVP Critical) | [X] stories |
+| P1 (Important) | [X] stories |
+| P2 (Nice to Have) | [X] stories |
+
+### By Epic
+| Epic | Name | Stories | P0 | P1 | P2 |
+|------|------|---------|----|----|----|
+| epic-001 | [Name] | [X] | [X] | [X] | [X] |
+| epic-002 | [Name] | [X] | [X] | [X] | [X] |
+| ... | ... | ... | ... | ... | ... |
+```
+
+### 3. Generate Recommended Implementation Order
+
+Based on dependencies and priorities:
+
+```
+## Recommended Implementation Order
+
+### Phase 1: Foundation (MVP Core)
+Focus: Get to a working product ASAP
+
+**Epic-001: [User Authentication]**
+- story-001: [Sign Up Form Display]
+- story-002: [Sign Up Form Validation]
+- story-003: [Email Verification]
+- story-004: [Login Flow]
+
+**Epic-002: [Core Feature 1]** (partial)
+- story-005: [Basic feature setup]
+- story-006: [List view]
+
+**Phase 1 Total:** [X] stories
+
+### Phase 2: MVP Complete
+Focus: All P0 functionality working
+
+**Epic-002: [Core Feature 1]** (continued)
+- story-007: [Create flow]
+- story-008: [Edit flow]
+- story-009: [Delete flow]
+
+**Epic-003: [Core Feature 2]**
+- story-010: [Feature setup]
+- story-011: [Main flow]
+
+**Phase 2 Total:** [X] stories
+
+### Phase 3: Polish & Enhancement
+Focus: P1 features and quality improvements
+
+**Epic-004: [Supporting Feature]**
+- story-012: ...
+- story-013: ...
+
+**Phase 3 Total:** [X] stories
+
+### Phase 4: Future
+Focus: P2 features when time permits
+
+**Remaining stories from all epics**
+```
+
+### 4. Create The Living Plan Document
+
+```markdown
+# The Living Plan
+
+> "All ideas deserve a story."
+
+## Project Overview
+
+**Project:** [Name from BRIEF]
+**Version:** [Current version]
+**Generated:** [Date]
+**Last Updated:** [Date]
+
+## Plan Philosophy
+
+This is a **living plan** - it grows with your project.
+
+- **Epics** represent user value, not technical layers
+- **Stories** are atomic, implementable units of work
+- **Numbers never restart** - story-100 comes after story-99, forever
+- **New features** add new epics and stories, preserving history
+
+## Current Status
+
+### Statistics
+
+| Metric | Count |
+|--------|-------|
+| Total Epics | [X] |
+| Total Stories | [X] |
+| MVP (P0) Stories | [X] |
+| Enhancement (P1) Stories | [X] |
+| Future (P2) Stories | [X] |
+
+### Epic Overview
+
+| Epic | Name | Stories | Priority | Status |
+|------|------|---------|----------|--------|
+| epic-001 | [Name] | [X] | P0 | Draft |
+| epic-002 | [Name] | [X] | P0 | Draft |
+| epic-003 | [Name] | [X] | P1 | Draft |
+| ... | ... | ... | ... | ... |
+
+## Implementation Roadmap
+
+### Phase 1: Foundation
+[Phase 1 details from step 3]
+
+### Phase 2: MVP Complete
+[Phase 2 details from step 3]
+
+### Phase 3: Polish
+[Phase 3 details from step 3]
+
+### Phase 4: Future
+[Phase 4 details from step 3]
+
+## Story Index
+
+### All Stories by Number
+
+| Story | Name | Epic | Priority | Status |
+|-------|------|------|----------|--------|
+| story-001 | [Name] | epic-001 | P0 | Draft |
+| story-002 | [Name] | epic-001 | P0 | Draft |
+| story-003 | [Name] | epic-001 | P0 | Draft |
+| ... | ... | ... | ... | ... |
+
+## How This Plan Grows
+
+When you add new features (using `/evolve`):
+
+```
+Current: v1.0.0
+├── epic-001 to epic-005
+└── story-001 to story-025
+
+After adding Payment feature (v1.1.0):
+├── epic-001 to epic-005 (unchanged)
+├── epic-006: Payment Integration (NEW)
+└── story-001 to story-025 (unchanged)
+└── story-026 to story-030 (NEW)
+
+After major redesign (v2.0.0):
+├── epic-001 to epic-006 (unchanged)
+├── epic-007 to epic-010 (NEW)
+└── story-001 to story-030 (unchanged)
+└── story-031 to story-050 (NEW)
+```
+
+## Quick Reference
+
+### Key Files
+
+| Purpose | Location |
+|---------|----------|
+| This Plan | `4-documentation/PLAN.md` |
+| All Epics | `4-documentation/epics/` |
+| All Stories | `4-documentation/stories/` |
+| Context | `1-context/{version}/` |
+| Architecture | `2-outline/{version}/` |
+| UX/Wireframes | `3-ux/{version}/` |
+
+### Key Commands
+
+| Command | Purpose |
+|---------|---------|
+| `/implement` | Start implementing a story |
+| `/evolve` | Add a new feature (grows the plan) |
+| `/review` | Review implementation quality |
+| `/party` | Multi-agent discussion |
+
+## What's Next?
+
+Your documentation is complete. You can now:
+
+1. **Start implementing** - Run `/implement` to begin coding
+2. **Review the plan** - Make sure priorities are correct
+3. **Add details** - Expand any story that needs more context
+4. **Evolve** - When ready for new features, run `/evolve`
+
+---
+
+*Generated by ECHO*
+*"All ideas deserve a story."*
+*Version: {version}*
+```
+
+### 5. Save The Plan
+
+Save to `4-documentation/PLAN.md`
+
+### 6. Present Completion Summary
+
+```
+## Documentation Complete!
+
+🎉 Your living plan is ready.
+
+**Created:**
+- [X] epics organized by user value
+- [X] stories with Given/When/Then criteria
+- 1 living plan document
+
+**Files Generated:**
+- 4-documentation/PLAN.md
+- 4-documentation/epics/epic-001 through epic-[XXX].md
+- 4-documentation/stories/epic-*/story-001 through story-[XXX].md
+
+**Story Numbers:**
+- Started at: story-001 (or continued from story-[XXX])
+- Ended at: story-[XXX]
+- Next story will be: story-[XXX+1]
+
+## Key Principles Followed
+
+✅ Epics organized by USER VALUE (not technical layers)
+✅ Stories use Given/When/Then acceptance criteria
+✅ Story numbers NEVER restart
+✅ Database tables created only when stories need them
+✅ No story depends on a future story
+✅ All requirements covered by stories
+```
+
+### 7. Present Menu
+
+```
+The Living Plan is complete!
+
+What would you like to do?
+
+[I] Implement - Start coding with BUILDER
+[E] Edit Epic - Modify an epic
+[S] Edit Story - Modify a story
+[V] View Plan - Open PLAN.md
+[P] Party Mode - Review plan with all agents
+[?] Ask a question about the plan
+```
+
+## MENU HANDLING
+
+**If user selects [I] - Implement:**
+Load and execute: `_code/workflows/implement/workflow.md`
+
+**If user selects [E] - Edit Epic:**
+Ask which epic, load and present for editing.
+
+**If user selects [S] - Edit Story:**
+Ask which story, load and present for editing.
+
+**If user selects [V] - View Plan:**
+Display contents of PLAN.md.
+
+**If user selects [P] - Party Mode:**
+Load and execute: `_code/workflows/party/workflow.md`
+Include all agents for comprehensive review.
+
+**If user selects [?] - Question:**
+Answer their question about the plan.
+Return to menu.
+
+## QUALITY CHECKLIST (Before Completing)
+
+Before marking documentation complete, verify:
+- [ ] All epics approved by user
+- [ ] All stories approved by user
+- [ ] Story numbers are sequential and continuous
+- [ ] No gaps in requirement coverage
+- [ ] PLAN.md accurately reflects all documentation
+- [ ] User knows about `/implement` and `/evolve`
+
+## THE LIVING PLAN PHILOSOPHY
+
+**Why "Living"?**
+- Traditional plans become outdated immediately
+- This plan grows with every feature
+- Nothing is ever deleted, only added
+- History is preserved forever
+
+**Why "All Ideas Deserve a Story"?**
+- No idea is too small to track
+- Every feature request becomes a story
+- Backlogs are just stories with lower priority
+- The plan never says "no" - only "later"
+
+**Why Numbers Never Restart?**
+- Prevents confusion and conflicts
+- story-1 in v1.0.0 is different from story-1 in v2.0.0
+- Global numbering = global history
+- Easy to reference across versions
+
+---
+
+**REMEMBER:** This is a beginning, not an end. The plan will grow with every `/evolve`. Celebrate the milestone, but know there's always more to build.

package/_code/workflows/docs/workflow.md

@@ -0,0 +1,127 @@
+---
+name: docs
+description: Generate epics and stories from your context
+agent: echo
+version: 1.0.0
+requires:
+  - 1-context/{version}/
+  - 2-outline/{version}/
+  - 3-ux/{version}/sitemap.md
+nextStep: ./steps/step-01-validate.md
+---
+
+# Documentation Workflow
+
+> "All ideas deserve a story. Let's create your living plan."
+
+## What We're Creating
+
+**Epics** - Large features broken into stories
+**Stories** - Individual implementable units with acceptance criteria
+
+## The Living Plan Philosophy
+
+Your documentation grows forever:
+
+```
+4-documentation/
+├── epics/
+│   ├── epic-001-user-auth.md          # Original MVP
+│   ├── epic-002-course-management.md  # Original MVP
+│   ├── epic-003-progress-tracking.md  # Original MVP
+│   ├── epic-004-payments.md           # Added in v1.1.0
+│   └── epic-005-certificates.md       # Added in v1.2.0
+│
+└── stories/
+    ├── epic-001/
+    │   ├── story-001-signup.md
+    │   ├── story-002-login.md
+    │   └── story-003-password-reset.md
+    ├── epic-002/
+    │   └── ...
+    └── epic-004/                       # New feature stories
+        ├── story-015-add-payment-method.md
+        └── story-016-checkout-flow.md
+```
+
+## Epic Structure
+
+```markdown
+# Epic-XXX: [Epic Name]
+
+## Context
+- Version introduced: vX.X.X
+- Related BRIEF: [path]
+- Related pages: P001, P002, P003
+
+## Description
+What this epic accomplishes and why it matters.
+
+## Acceptance Criteria (Epic Level)
+High-level criteria for the entire epic.
+
+## Stories
+- [ ] Story-XXX: [Name]
+- [ ] Story-XXX: [Name]
+- [ ] Story-XXX: [Name]
+
+## Dependencies
+- Depends on: Epic-XXX (if any)
+- Blocks: Epic-XXX (if any)
+```
+
+## Story Structure
+
+```markdown
+# Story-XXX: [Story Name]
+
+## Epic
+Epic-XXX: [Epic Name]
+
+## Page Reference
+Page ID: P00X
+Route: /path
+Wireframe: [link to wireframe prompt]
+
+## User Story
+As a [user type],
+I want [action],
+So that [benefit].
+
+## Acceptance Criteria
+
+**Given** [precondition]
+**When** [action]
+**Then** [result]
+
+**Given** [precondition]
+**When** [action]
+**Then** [result]
+
+## Technical Notes
+- Implementation hints
+- API endpoints needed
+- Data models affected
+
+## Dependencies
+- Requires: Story-XXX
+- Blocks: Story-XXX
+```
+
+---
+
+## How It Works
+
+1. **Validate Prerequisites** - Check BRIEF, Outline, UX are complete
+2. **Generate Epics** - Group requirements into logical epics
+3. **Generate Stories** - Break epics into implementable stories
+4. **Link Everything** - Connect stories to pages, requirements, outline
+
+---
+
+## Ready?
+
+**[V]** Validate prerequisites
+**[G]** Generate epics from context
+**[S]** View current stories
+**[?]** Ask a question