implement-plan

Implement the given spec document. Work phase-by-phase, writing robust code that follows codebase patterns, and industry best practices and patterns.

Process

1. Read the spec – Understand phases, success criteria, and scope boundaries
2. Explore the codebase – Read files mentioned in the spec and related code
3. Analyze patterns – Identify existing conventions, architecture, and idioms to follow
4. Implement phase-by-phase – Complete each phase fully before proceeding
5. Verify your work – Run make check after code changes (skip for docs-only)

Implementation Rules

• Follow the plan – The spec is your contract; implement what’s specified
• Match codebase patterns – Use existing conventions, not new ones
• Write robust code – Handle errors, edge cases, and failure modes
• Be idiomatic – Use language best practices and established patterns
• No shortcuts – Implement fully, don’t stub or placeholder

Per-Phase Workflow

For each phase:

1. Read – Understand what the phase requires
2. Explore – Read existing code that will be modified or extended
3. Implement – Write code matching codebase style and patterns
4. Test – Run make check to verify (for code changes)
5. Update – Check off completed items in the spec file

Verification

• Code changes: Run make check before proceeding to next phase
• On failure: Run make fix first, then re-run make check
• Documentation-only: Skip verification

Communication

• If the plan doesn’t match codebase reality, explain the discrepancy
• If you need to deviate, explain why before making changes
• Update checkboxes in the spec as you complete each section