Post Plan Command

Create a structural outline from a post specification. The outline defines sections, word estimates, code example locations, and transitions.

Tools

• Read - Load spec and template
• Write - Create outline

Behavior

1. Validate input:

   • Check spec exists at {{path}}
   • Check spec status (can be draft or approved)
   • Check outline doesn't exist (unless --force)

2. Load outline template:

   • If --template flag provided, use that
   • Otherwise, from template field in spec frontmatter
   • Or default based on content_type from phase
   • Path: .templates/outlines/<template>.md

3. Template preview (optional):

   • Show template structure: "Using template: tutorial.outline.md"
   • Display section count and typical word distribution

4. Generate outline following template structure:

   • Create sections with word estimates
   • Mark code example locations
   • Note diagram/visual placements
   • Plan transitions between sections

5. Verify word estimates sum to target length (+/-10%)

6. Write outline: post/<phase-slug>/outline.md

7. Create bidirectional links:

   • Set parent in outline to ./spec.md
   • Add outline to children in spec

8. Update Post Artifacts table in index.md

9. Self-review (structure check):

   • Does structure follow template?
   • Are word estimates balanced?
   • Are all takeaways covered?

Content Type to Template Mapping

Output

Created post outline: content/_projects/<slug>/post/<phase-slug>/outline.md

Template: {{template}}.outline.md
Sections: {{count}}
Total words: ~{{total}} (target: {{target}})

Section breakdown:
- Introduction: {{words}} words
- {{Section 1}}: {{words}} words
- {{Section 2}}: {{words}} words
- Conclusion: {{words}} words

Code examples: {{count}} locations marked
Diagrams: {{count}} locations marked

Self-review: {{passed|warnings}}

Next: Run `/blog/post/draft content/_projects/<slug>/post/<phase-slug>/outline.md`

Error Handling

Example Usage

# Normal outline creation
/blog/post/plan content/_projects/kubernetes-migration/post/tutorial-basics/spec.md

# Override template
/blog/post/plan content/_projects/kubernetes-migration/post/tutorial-basics/spec.md --template how-i-built

# Overwrite existing outline
/blog/post/plan content/_projects/kubernetes-migration/post/tutorial-basics/spec.md --force