Plan Generation Skill

Generate plan documentation following ML Odyssey's standard 9-section Template 1 format.

When to Use

• Creating new plan.md files for components or subsections
• Starting planning phase documentation
• Generating planning specifications before implementation
• Need to follow Template 1 format with all 9 sections

Quick Reference

# Validate existing plan has all 9 sections
grep -E "^## (Overview|Parent Plan|Child Plans|Inputs|Outputs|Steps|Success Criteria|Notes)" plan.md

# Generate from template
cat > plan.md << 'EOF'
# Component Name

## Overview
Brief description (2-3 sentences)

## Parent Plan
[Link or "None (top-level)"]

## Child Plans
[Links or "None (leaf node)"]

## Inputs
- Prerequisite 1

## Outputs
- Deliverable 1

## Steps
1. Step 1

## Success Criteria
- [ ] Criterion 1

## Notes
Additional context
EOF

Workflow

1. Create plan.md with all 9 required sections
2. Use relative paths for links (e.g., ../plan.md, not absolute)
3. Make inputs specific (list dependencies clearly)
4. Make outputs measurable (actual deliverables, not vague goals)
5. Make steps actionable (numbered, clear sequence)
6. Make criteria verifiable (checkboxes with specific outcomes)
7. Update parent plan's "Child Plans" section after creation
8. Regenerate GitHub issues: python3 scripts/regenerate_github_issues.py --section <section>

Template 1 Format (9 Sections)

# Component Name

## Overview
Brief description (2-3 sentences) of what this component does.

## Parent Plan
[../parent/plan.md](../parent/plan.md)
Or: "None (top-level)" for section-level plans

## Child Plans
- [child1/plan.md](child1/plan.md)
- [child2/plan.md](child2/plan.md)
Or: "None (leaf node)" for lowest-level plans

## Inputs
- Prerequisite 1
- Prerequisite 2
- Dependency 3

## Outputs
- Deliverable file/artifact 1
- Deliverable file/artifact 2
- Test files or documentation

## Steps
1. First step
2. Second step
3. Third step

## Success Criteria
- [ ] Criterion 1 (verifiable outcome)
- [ ] Criterion 2 (measurable result)

## Notes
Additional context, assumptions, or considerations.

Phase Dependencies

• Precedes: Test, Implementation, Package phases (plan must complete first)
• Receives input from: Design phase (specifications, architecture decisions)
• Produces for: All subsequent phases (implementation specifications)

Output Location

• Planning: GitHub issue body and comments
• Specifications: /notes/review/ for architectural decisions
• Issue tracking: GitHub issue comments

Error Handling

| Error | Fix | |-------|-----| | Missing sections | Add all 9 sections from template | | Broken links | Use relative paths (../ notation) | | Vague inputs/outputs | Make specific and measurable | | No success criteria | Add verifiable checkboxes | | Broken hierarchy | Verify parent/child links exist |

References

• CLAUDE.md - "GitHub Issue Structure" section
• .claude/shared/github-issue-workflow.md - GitHub issue workflow
• /notes/review/ - Example specifications in repository

---

Template location: templates/plan_template.md in skill directory (if available)