Update Plan

Routing Matrix (Who does what)

• Writes: updates under plans/<name>/ including plan.md, todo.md, phases/**, and (when needed) implementation/**.
• Primary: preferred owner for updates (session decisions/intents live here).
• doc-explorer: optional helper for mechanical edits or codebase analysis to verify acceptance criteria.
• implementer: never used for plan maintenance.

Workflow

Step 1: Identify the Plan

Find the active plan:

• Check plans/ directory for existing plans
• If multiple plans exist, use the question tool to ask the user which plan
• Read the plan's plan.md to understand the current status
• Read todo.md to see current task state

Step 2: Determine What to Update

Option A: Todo updates (most common)

• Mark completed items: move from Pending/In Progress to Completed
• Add new items discovered during work
• Mark blocked items with reason
• Move next items to In Progress

Option B: Phase completion

• Verify all acceptance criteria from the phase document are met
• Update phase status in phases/phase-N.md frontmatter
• Update the phases table in plan.md
• Populate todo list with next phase's items (from implementation plan)
• Add changelog entry

Option C: Implementation plan revision

• If the technical approach changed during implementation
• Update the affected implementation/phase-N-impl.md
• Document the reason for the change
• Update any affected todo items

Option D: Plan-level updates

• Requirements changed → update plan.md
• New risks identified → add to risks table
• Scope adjustment → update scope section

Step 3: Apply Updates

Updating Todo List (todo.md)

### Completed
- [x] Implement user authentication endpoint (2025-02-14)

### In Progress
- [ ] Add input validation for login form

### Pending
- [ ] Write integration tests for auth flow

### Blocked
- [ ] Deploy to staging - waiting for CI pipeline fix

Always add a changelog entry:

### 2025-02-14
- Completed: Implement user authentication endpoint
- Started: Add input validation for login form
- Blocked: Deploy to staging (CI pipeline issue)

Updating Phase Status

In phases/phase-N.md frontmatter: