Plan Documentation

Generate structured plan files when starting large features, refactoring efforts, or multi-phase work. Plans create a paper trail that survives context resets and helps collaborators understand what was planned, what changed, and why.

When to Generate Plan Files

Create a plan document when:

• The task spans more than 2 files or requires multiple coordinated changes
• Work will take more than one session or phase
• Multiple approaches exist and the chosen path should be documented
• Other people (or future you) need to understand the sequence of work

Do NOT create plan files for:

• Single-file fixes or tweaks
• Routine maintenance (dependency updates, formatting)
• Tasks that can be completed in under 15 minutes

Plan Document Template