analysis-phase
<quick_start> Validate cross-artifact consistency and detect breaking changes:
- Check spec → plan → tasks alignment
- Detect breaking changes (API, database, UI, auth)
- Validate dependencies
- Generate analysis-report.md with findings
Inputs: spec.md, plan.md, tasks.md Outputs: analysis-report.md </quick_start>
Read spec.md requirements, verify each has corresponding plan component. Flag missing mappings in analysis report.
See references/examples.md for grep commands.
Read plan.md components, verify each broken into tasks in tasks.md.
Validate:
- Each plan component has ≥1 task
- Task acceptance criteria match spec success criteria
- No orphaned tasks (tasks without plan component)
Scan for patterns indicating breaking changes:
- API changes: Endpoint signature modifications, required parameter additions, response format changes
- Database changes: Schema modifications, required field additions, migrations affecting existing data
- UI changes: Component interface changes, prop requirement additions
- Auth changes: Permission model modifications, authentication flow changes
Flag with impact level (Low/Medium/High) using reference rubric.
Cross-reference:
- Imports and integrations mentioned in plan
- External dependencies in tasks
- Integration points in spec
Verify all dependencies documented and accounted for.
Create specs/NNN-slug/analysis-report.md:
# Analysis Report
## Consistency Check
- Spec-Plan: [✓/✗] Description
- Plan-Tasks: [✓/✗] Description
## Breaking Changes
- [High/Medium/Low] Description and impact
## Dependency Validation
- [✓/✗] Dependencies documented
## Recommendations
- Action items to fix inconsistencies
Update state.yaml: analysis.status = completed
- All spec requirements have plan component coverage
- All plan components have task breakdown
- Breaking changes flagged with impact level (Low/Medium/High)
- Analysis report generated with actionable findings
- No orphaned artifacts (tasks without plan, plan without spec)
<anti_patterns> ❌ Don't: Assume no breaking changes without scanning ✅ Do: Explicitly check API signatures, database schema, required fields, auth changes
Why: Breaking changes missed in analysis cause production issues post-deployment
Why: Missing mappings lead to incomplete implementation
Why: Undocumented dependencies cause integration failures
Why: Actionable findings enable quick remediation </anti_patterns>
<success_criteria>
- All spec requirements mapped to plan components (no gaps)
- All plan components broken into tasks (no orphans)
- Breaking changes documented with impact level (High/Medium/Low)
- Dependencies validated and documented
- analysis-report.md generated with actionable findings
- state.yaml updated (analysis.status = completed) </success_criteria>