Implementation Phase

Implementation Phase: Quick Reference

Purpose: Execute tasks from tasks.md using Test-Driven Development, preventing code duplication, and maintaining high quality.

Phase Overview

Inputs:

• specs/NNN-slug/tasks.md - Task breakdown (20-30 tasks)
• specs/NNN-slug/plan.md - Implementation plan with reuse strategy

Outputs:

• Implemented code (models, services, APIs, UI components)
• Test suites (unit, integration, E2E)
• Updated tasks.md and workflow-state.yaml

Expected duration: 2-10 days (varies by complexity)

Quick Start Checklist

Before you begin:

• Tasks phase completed (tasks.md exists with 20-30 tasks)
• Plan phase completed (plan.md exists)
• Development environment set up
• Test framework configured
• Git working tree clean

Core workflow:

1. ✅ Load Tech Stack Constraints - Prevent hallucinated tech choices
2. ✅ Review Task Dependencies - Identify parallel work opportunities
3. ✅ Execute Tasks Using TDD - RED → GREEN → REFACTOR
4. ✅ Update Task Status - Keep NOTES.md current
5. ✅ Run Anti-Duplication Checks - Search before writing
6. ✅ Continuous Testing - Test after each task triplet
7. ✅ Commit Implementation - Small, frequent commits

Detailed Resources

🎯 Core Workflow

• TDD Workflow - RED → GREEN → REFACTOR cycle, test-first discipline
• Task Batching - Parallel execution strategy, dependency analysis
• Task Tracking - NOTES.md updates, velocity tracking

🛡️ Quality Gates

• Tech Stack Validation - Load constraints from tech-stack.md
• Anti-Duplication Checks - Search patterns, DRY enforcement
• Continuous Testing - Test cadence, coverage requirements

🚧 Advanced Topics

• Handling Blocked Tasks - Escalation strategies, workarounds
• Integration Testing - Multi-component tests
• UI Component Testing - React Testing Library, accessibility
• E2E Testing - Playwright/Cypress patterns

📋 Reference

• Common Mistakes - Anti-patterns to avoid
• Best Practices - Proven patterns from production
• Code Review Checklist - Pre-commit validation
• Troubleshooting Guide - Common blockers and fixes

Completion Criteria

Required:

• All tasks completed (or blocked tasks documented)
• Test coverage ≥80% (unit + integration)
• All tests passing (CI green)
• No code duplication (DRY violations <3)
• Code review checklist passed
• Git commits made with descriptive messages

Optional (if applicable):

• UI components have accessibility tests (WCAG 2.1 AA)
• E2E tests cover critical user flows
• Performance benchmarks met (API <200ms, page load <2s)

Next Phase

After implementation complete: → /optimize - Code review, performance validation, production readiness

See also:

• reference.md - Comprehensive implementation guide (full text)
• examples.md - Good vs bad implementation examples
• scripts/batch-validator.sh - Batch task validation