FILE-INDEX.md 6.7 KB
Agentic Development - File Index
Location: src/workflows/wds-5-agentic-development/
๐ Complete File Structure
agentic-development/
โ
โโโ AGENTIC-DEVELOPMENT-GUIDE.md โ START HERE (overview & quick reference)
โโโ workflow.md โ Workflow overview with phase links
โโโ PROTOTYPE-INITIATION-DIALOG.md โ Conversation scripts for initiation
โโโ CREATION-GUIDE.md โ Original detailed guide (reference)
โโโ PROTOTYPE-ANALYSIS.md โ Dog Week analysis (examples)
โ
โโโ steps-p/ โ Micro-step workflow files
โ โโโ 1-prototype-setup.md โ Phase 1: Environment setup
โ โโโ 2-scenario-analysis.md โ Phase 2: Analyze spec & create views
โ โโโ 3-logical-view-breakdown.md โ Phase 3: Break view into sections
โ โโโ 4a-announce-and-gather.md โ Phase 4a: Announce section
โ โโโ 4b-create-story-file.md โ Phase 4b: Create story file
โ โโโ 4c-implement-section.md โ Phase 4c: Implement code
โ โโโ 4d-present-for-testing.md โ Phase 4d: Present for testing
โ โโโ 4e-handle-issue.md โ Phase 4e: Fix issues (loop)
โ โโโ 4f-handle-improvement.md โ Phase 4f: Handle improvements (loop)
โ โโโ 4g-section-approved.md โ Phase 4g: Section approved
โ โโโ 5-finalization.md โ Phase 5: Integration test & approval
โ
โโโ templates/
โ โโโ work-file-template.yaml โ Planning document template
โ โโโ story-file-template.md โ Section implementation template
โ โโโ page-template.html โ Complete HTML page template
โ โโโ PROTOTYPE-ROADMAP-template.md โ Scenario roadmap template
โ โโโ demo-data-template.json โ Demo data structure template
โ โโโ components/
โ โโโ dev-mode.html โ Dev mode toggle button
โ โโโ dev-mode.js โ Dev mode logic (Shift+Click to copy IDs)
โ โโโ dev-mode.css โ Dev mode styles
โ โโโ DEV-MODE-GUIDE.md โ Dev mode usage guide
โ
โโโ examples/
โโโ (Dog Week prototypes as reference)
๐ What Each File Does
Core Documentation
AGENTIC-DEVELOPMENT-GUIDE.md
Purpose: Complete system overview For: All agents (Freya, Saga) Contains:
- System overview
- Folder structure
- Complete workflow summary
- Key principles
- Quick reference
- Success metrics
Read this: To understand the complete system
workflow.md
Purpose: Workflow overview with phase navigation For: Freya (primary), other agents (reference) Contains:
- Overview of all phases
- Clear links to step files
- When to use each phase
- What each phase creates
Read this: To understand the workflow structure
Step Files
steps-p/1-prototype-setup.md
Purpose: Environment setup instructions Contains: Device compatibility, design fidelity, languages, demo data creation Next: Phase 2
steps-p/2-scenario-analysis.md
Purpose: Scenario analysis and view identification Contains: Spec analysis, logical view mapping Next: Phase 3
steps-p/3-logical-view-breakdown.md
Purpose: Break view into implementable sections Contains: Section breakdown, work file creation Next: Phase 4
steps-p/4a-4g-*.md (Phase 4 Loop)
Purpose: Section-by-section implementation Contains: Announce, create story, implement, test, handle feedback, approve Flow: 4a โ 4b โ 4c โ 4d โ [4e/4f loop] โ 4g โ [next section]
steps-p/5-finalization.md
Purpose: Integration test and completion Contains: Final test, quality checklist, next steps Next: New page (Phase 3) or new scenario (Phase 1)
Templates
templates/work-file-template.yaml
Purpose: Planning document When to use: Start of EVERY implementation Created: Once per page at beginning Contains:
- Metadata (page info, device compatibility)
- Design tokens (Tailwind config)
- Page requirements (from spec)
- Demo data needs
- Object ID map
- Section breakdown (4-8 sections)
- Testing checklist
Use this: To create work file (plan BEFORE coding)
templates/story-file-template.md
Purpose: Section implementation guide When to use: Just-in-time (right before implementing each section) Created: Once per section (4-8 per page) Contains:
- Section goal
- What to build (HTML/JS)
- Tailwind classes to use
- Dependencies
- Acceptance criteria
- Test instructions
- Common issues
Use this: To create story file before each section
templates/page-template.html
Purpose: Complete HTML page structure When to use: Creating new HTML page Created: Once per page (at start of Section 1) Contains:
- Complete HTML structure
- Tailwind CDN setup
- Tailwind config inline
- Component examples
- Shared script includes
Use this: As starting point for new page HTML
๐ฏ Which File When?
Starting New Scenario
- Read:
workflow.md(understand phases) - Follow:
steps-p/1-prototype-setup.md(setup) - Use:
PROTOTYPE-ROADMAP-template.mdโ Create roadmap - Use:
demo-data-template.jsonโ Create demo data
Starting New Page
- Follow:
steps-p/2-scenario-analysis.md(analyze) - Follow:
steps-p/3-logical-view-breakdown.md(break down) - Use:
work-file-template.yamlโ Create work file - Get approval
Implementing Each Section
- Follow:
steps-p/4a-4g-*.md(loop) - Use:
story-file-template.mdโ Create story file (just-in-time) - Implement in HTML (incrementally)
- Test
- Get approval
- Repeat for next section
Finishing Page
- Follow:
steps-p/5-finalization.md(integration test) - Get final approval
- Choose: New page, new scenario, or done
๐ Template Usage Summary
| Template | When Created | How Many | Purpose |
|---|---|---|---|
| work-file | Start of page | 1 per page | Complete plan |
| story-file | Before each section | 4-8 per page | Section implementation |
| page | Start of Section 1 | 1 per page | HTML structure |
| roadmap | Start of scenario | 1 per scenario | Scenario overview |
| demo-data | Setup scenario | 1 per scenario | Auto-loading data |
All templates and micro-step instructions are ready!
Next step: Activate Freya and follow workflow.md โ steps-p/1-prototype-setup.md