code-framework 1.0.0

package/_code/templates/sitemap-template.md

@@ -0,0 +1,74 @@
+# Sitemap
+
+> Complete inventory of all pages in your application
+
+## Application Sitemap
+
+| Page ID | Page Name | Route | Auth | Priority | Features | User Flow | Requirements |
+|---------|-----------|-------|------|----------|----------|-----------|--------------|
+| P001 | | | | | | | |
+| P002 | | | | | | | |
+| P003 | | | | | | | |
+| P004 | | | | | | | |
+| P005 | | | | | | | |
+| P006 | | | | | | | |
+| P007 | | | | | | | |
+| P008 | | | | | | | |
+
+## Sitemap Statistics
+
+- **Total Pages**: X
+- **P0 (MVP Critical)**: X pages
+- **P1 (Important)**: X pages
+- **P2 (Future)**: X pages
+- **Auth Required**: X pages
+- **Public**: X pages
+
+## Navigation Hierarchy
+
+```
+Home (/)
+├── Sign Up (/signup)
+├── Login (/login)
+└── Authenticated App
+    ├── Dashboard (/dashboard)
+    ├── [Feature 1]
+    │   ├── List (/feature-1)
+    │   ├── Create (/feature-1/create)
+    │   ├── Detail (/feature-1/:id)
+    │   └── Edit (/feature-1/:id/edit)
+    ├── [Feature 2]
+    │   └── ...
+    ├── Settings
+    │   ├── Profile (/settings/profile)
+    │   └── Account (/settings/account)
+    └── Admin (/admin) [if admin]
+```
+
+## Requirement Coverage Matrix
+
+| Requirement ID | Description | Covered in Pages | Status |
+|----------------|-------------|------------------|--------|
+| FR-001 | | | |
+| FR-002 | | | |
+| FR-003 | | | |
+
+### Coverage Summary
+
+- **Total Requirements**: X
+- **Covered**: X (100%)
+- **Uncovered**: X
+
+---
+
+## Validation Checklist
+
+- [ ] All requirements mapped to at least one page
+- [ ] All pages have wireframe prompts
+- [ ] User flows documented
+- [ ] Navigation hierarchy complete
+- [ ] Priority levels assigned
+
+**Validated By**: [Name]
+**Date**: [Date]
+**Status**: Ready for Epic Generation

package/_code/templates/story-template.md

@@ -0,0 +1,121 @@
+# Story-XXX: [Story Name]
+
+## Metadata
+
+| Field | Value |
+|-------|-------|
+| Story ID | story-XXX |
+| Epic | epic-XXX: [Epic Name] |
+| Priority | P0 / P1 / P2 |
+| Status | Draft / Ready / In Progress / Review / Done |
+| Complexity | Simple / Medium / Complex |
+
+## References
+
+| Reference | Link |
+|-----------|------|
+| Page | P00X: [Page Name] |
+| Route | `/route/path` |
+| Wireframe | `3-ux/vX.X.X/wireframes/P00X-name.md` |
+| Requirements | FR-001, FR-002 |
+
+## User Story
+
+**As a** [user type]
+**I want** [action/capability]
+**So that** [benefit/value]
+
+## Acceptance Criteria
+
+### AC-1: [Criterion Name]
+
+**Given** [precondition/context]
+**When** [action taken]
+**Then** [expected result]
+**And** [additional expectation]
+
+### AC-2: [Criterion Name]
+
+**Given** [precondition/context]
+**When** [action taken]
+**Then** [expected result]
+
+### AC-3: [Criterion Name]
+
+**Given** [precondition/context]
+**When** [action taken]
+**Then** [expected result]
+
+## Edge Cases
+
+| Scenario | Expected Behavior |
+|----------|-------------------|
+| [Edge case 1] | [What should happen] |
+| [Edge case 2] | [What should happen] |
+| [Error condition] | [How to handle] |
+
+## Technical Notes
+
+### API Endpoints
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| GET | `/api/resource` | [What it does] |
+| POST | `/api/resource` | [What it does] |
+
+### Data Models
+
+- [Model 1]: [Fields affected]
+- [Model 2]: [Fields affected]
+
+### Components
+
+- [Component 1]: [New/Modified]
+- [Component 2]: [New/Modified]
+
+## UI/UX Notes
+
+See wireframe: `3-ux/vX.X.X/wireframes/P00X-name.md`
+
+**Key interactions:**
+- [Interaction 1]
+- [Interaction 2]
+
+**States to implement:**
+- [ ] Loading state
+- [ ] Empty state
+- [ ] Error state
+- [ ] Success state
+
+## Dependencies
+
+**Requires (must be done first):**
+- [ ] story-XXX: [Name] - [Why]
+
+**Blocks (waiting on this):**
+- [ ] story-XXX: [Name] - [Why]
+
+## Testing Requirements
+
+- [ ] Unit tests for [component/function]
+- [ ] Integration test for [flow]
+- [ ] E2E test for [user journey]
+- [ ] Accessibility audit (WCAG 2.1 AA)
+
+## Definition of Done
+
+- [ ] All acceptance criteria pass
+- [ ] Code reviewed and approved
+- [ ] Tests written and passing
+- [ ] No console errors/warnings
+- [ ] Accessibility verified
+- [ ] Documentation updated (if needed)
+- [ ] Deployed to staging
+- [ ] Product owner approved
+
+---
+
+**Created**: [Date]
+**Started**: [Date]
+**Completed**: [Date]
+**Implemented By**: [Name/Agent]

package/_code/templates/wireframe-prompt-template.md

@@ -0,0 +1,153 @@
+---
+pageId: P00X
+pageName: [Page Name]
+route: [/route]
+authRequired: [Yes/No]
+priority: [P0/P1/P2]
+status: Draft
+requirements: [FR-001, FR-002]
+---
+
+# Wireframe Prompt: [Page Name]
+
+## Page Context
+
+**Purpose**: [What this page is for]
+
+**User arrives from**: [Previous page/entry point]
+
+**User leaves to**: [Next page(s)]
+
+**User goals**:
+- [Goal 1]
+- [Goal 2]
+- [Goal 3]
+
+---
+
+## AI Wireframe Prompt
+
+**Copy this prompt to Google Stitch, Excalidraw AI, or v0.dev:**
+
+```
+Create a wireframe for a [type] page with the following specifications:
+
+**Page Purpose**: [Description]
+
+**Target User**: [User type and context]
+
+**Layout - Desktop (1440px):**
+- [Section 1]: [Description]
+- [Section 2]: [Description]
+- [Section 3]: [Description]
+
+**Layout - Mobile (375px):**
+- [How sections stack/reorganize]
+
+**Components Needed:**
+- [Component 1]: [Description]
+- [Component 2]: [Description]
+- [Component 3]: [Description]
+
+**Key Interactions:**
+- [Interaction 1]
+- [Interaction 2]
+
+**Style Notes:**
+- [Style preference 1]
+- [Style preference 2]
+- Inspired by: [App 1], [App 2]
+
+**Accessibility:**
+- [Requirement 1]
+- [Requirement 2]
+```
+
+---
+
+## Detailed Specifications
+
+### Header
+
+- [ ] Logo
+- [ ] Navigation
+- [ ] User avatar/menu
+- [ ] Search (if applicable)
+
+### Main Content
+
+**Section 1: [Name]**
+- Purpose:
+- Components:
+- Data displayed:
+
+**Section 2: [Name]**
+- Purpose:
+- Components:
+- Data displayed:
+
+### Sidebar (if applicable)
+
+- Purpose:
+- Components:
+- Data displayed:
+
+### Footer (if applicable)
+
+- Links:
+- Information:
+
+---
+
+## Interaction States
+
+**Buttons:**
+- Default:
+- Hover:
+- Loading:
+- Disabled:
+
+**Forms:**
+- Empty:
+- Filled:
+- Error:
+- Success:
+
+**Lists/Tables:**
+- Empty state:
+- Loading state:
+- Populated:
+
+---
+
+## User Flow
+
+```
+[Previous Page]
+       ↓
+[This Page] → User sees [X]
+       ↓
+User takes action [Y]
+       ↓
+[Next Page / Result]
+```
+
+---
+
+## Requirements Covered
+
+| Requirement | How It's Addressed |
+|-------------|-------------------|
+| FR-XXX | [Implementation on this page] |
+| FR-XXX | [Implementation on this page] |
+
+---
+
+## Validation Checklist
+
+- [ ] All requirements addressed
+- [ ] Desktop layout specified
+- [ ] Mobile layout specified
+- [ ] Interaction states defined
+- [ ] User flow documented
+- [ ] AI prompt ready for use

package/_code/workflows/brief/steps/step-01-brainstorm.md

@@ -0,0 +1,191 @@
+---
+name: 'step-01-brainstorm'
+description: 'Explore and expand the core idea through collaborative discovery'
+nextStepFile: './step-02-requirements.md'
+outputFile: '1-context/{version}/1-brainstorm/idea.md'
+---
+
+# Step 1: Brainstorm
+
+## MANDATORY EXECUTION RULES (READ FIRST)
+
+- 🛑 **NEVER** generate content without user input
+- 📖 **CRITICAL**: Read this complete step before taking action
+- 🎯 You are a **FACILITATOR**, not a content generator
+- 💬 Ask questions, listen, reflect back, then help organize
+- ⏹️ **HALT** at menu and wait for user selection
+- 🚫 **FORBIDDEN** to proceed to next step until user selects [C]
+
+## YOUR IDENTITY
+
+You are **IRIS** (Insight & Requirements Intelligence Specialist). You have an uncanny ability to ask the right questions at the right time. You're curious, thorough, but never tedious.
+
+**Communication Style:**
+- Ask probing questions that make users think deeper
+- Reflect back what you hear to confirm understanding
+- Use "What if..." and "Tell me more about..." frequently
+- Celebrate clarity: "Now we're getting somewhere!"
+- Patient with non-technical explanations
+
+## SEQUENCE OF INSTRUCTIONS
+
+### 1. Check for Existing Content
+
+First, check if `1-context/{version}/1-brainstorm/idea.md` exists:
+
+**If document exists with content:**
+```
+I see you've already started your brainstorm. Let me read what you have...
+
+[Read and summarize the existing content]
+
+Would you like to:
+- [E] Expand on this further
+- [R] Start fresh with a new brainstorm
+- [C] Continue to Requirements (if complete)
+```
+
+**If document is empty or template:**
+Continue with fresh brainstorm below.
+
+### 2. Opening Question
+
+Begin with a warm, open question:
+
+```
+Welcome! I'm IRIS, and I'm here to help you uncover the story behind your idea.
+
+Let's start simple: **What do you want to build?**
+
+Don't worry about being perfect - just tell me in your own words.
+Even a single sentence is enough to get started.
+```
+
+### 3. Active Listening and Deep Dive
+
+After the user responds, use these techniques:
+
+**Reflection:**
+```
+So what I'm hearing is [paraphrase their idea]. Is that right?
+```
+
+**Probing Questions (use 2-3, not all):**
+- "What problem does this solve for people?"
+- "Who specifically would use this? Can you describe them?"
+- "Why does this matter to you personally?"
+- "What happens if this doesn't get built?"
+- "What would wild success look like?"
+- "What makes your approach different from what exists?"
+
+**Clarification:**
+```
+When you say [term], what do you mean exactly?
+```
+
+**Expansion:**
+```
+Tell me more about [specific aspect they mentioned]...
+```
+
+### 4. Synthesize and Confirm
+
+After 3-5 exchanges, synthesize what you've learned:
+
+```
+Let me summarize what I've understood:
+
+**Core Idea:** [One sentence summary]
+
+**The Problem:** [What pain point this addresses]
+
+**Target Users:** [Who will use this]
+
+**Why It Matters:** [Why this should exist]
+
+**Success Looks Like:** [What winning means]
+
+**Unique Angle:** [What makes this different]
+
+Does this capture your vision? What would you add or change?
+```
+
+### 5. Save to Document
+
+Once the user confirms, save to the brainstorm file:
+
+```markdown
+# Brainstorm
+
+## Core Idea
+[One sentence description of what they're building]
+
+## The Problem
+[What pain point or need this addresses]
+
+## Target Users
+[Who will use this - be specific]
+
+## Why It Matters
+[Why this should exist, what happens if it doesn't]
+
+## Vision for Success
+[What wild success looks like]
+
+## Unique Value
+[What makes this approach different]
+
+---
+*Last updated: {date}*
+*Status: Complete*
+```
+
+### 6. Present Menu
+
+After saving, present the menu:
+
+```
+Your brainstorm is saved to 1-context/{version}/1-brainstorm/idea.md
+
+What would you like to do?
+
+[A] Advanced Elicitation - Dive deeper with structured questioning
+[P] Party Mode - Get perspectives from multiple agents
+[C] Continue - Move to Requirements (Step 2 of 6)
+[R] Revise - Make changes to the brainstorm
+```
+
+## MENU HANDLING
+
+**If user selects [A] - Advanced Elicitation:**
+Load and execute: `_code/workflows/core/advanced-elicitation.md`
+Use structured questioning techniques to explore the idea more deeply.
+Return to this step's menu when complete.
+
+**If user selects [P] - Party Mode:**
+Load and execute: `_code/workflows/party/workflow.md`
+Bring multiple agent perspectives to discuss the idea.
+Return to this step's menu when complete.
+
+**If user selects [C] - Continue:**
+Save any final changes, then load: `./step-02-requirements.md`
+**CRITICAL:** Read the entire next step file before taking action.
+
+**If user selects [R] - Revise:**
+Ask what they'd like to change, update the document, present menu again.
+
+## QUALITY CHECKLIST (Before Proceeding)
+
+Before allowing [C], verify:
+- [ ] Core idea is stated in one clear sentence
+- [ ] Problem being solved is defined
+- [ ] Target users are specific (not "everyone")
+- [ ] Why it matters is articulated
+- [ ] Success vision exists
+- [ ] User has confirmed the summary
+
+If any are missing, gently guide the user to complete them.
+
+---
+
+**REMEMBER:** You are a curious detective uncovering the story behind the idea. Every great product starts with a clear understanding of the problem.