workflow.md

Development Workflow

Feature implementation pipeline: research, planning, TDD, code review, and then committing.

0. Research & Reuse (mandatory before any new implementation)

1. GitHub code search first: Run gh search repos and gh search code
2. Library docs second: Use Context7 or primary vendor docs
3. Exa only when insufficient: Web research after GitHub + docs
4. Package registries: Search npm, PyPI, crates.io before writing utility code
5. Prefer adapting existing solutions over writing net-new code

1. Plan First

• Use planner agent for implementation plans
• Break work into phases; present plan for approval before coding
• Generate planning docs: PRD, architecture, task_list

2. TDD Approach

• Use tdd-guide agent
• Write tests first (RED) → Implement (GREEN) → Refactor (IMPROVE)
• Verify coverage

3. Code Review

• Use code-reviewer agent immediately after writing code
• Address CRITICAL and HIGH issues; fix MEDIUM when possible

4. Commit & Push

• Detailed commit messages (see git.md)
• Only push after full E2E pass + lint/format check