|
| 1 | +--- |
| 2 | +name: implementer |
| 3 | +description: > |
| 4 | + Iterative implementation workflow for requirements. Use this skill when asked to |
| 5 | + implement a feature, user story, requirement, or change request. Guides through |
| 6 | + 5 phases: requirement review, implementation planning, sub-agent-driven implementation |
| 7 | + (code, tests, documentation), code review with rework loop, and final summary. |
| 8 | + Never commits code — the user always commits manually. |
| 9 | +allowed-tools: Read Grep Glob Edit Create Task |
| 10 | +--- |
| 11 | + |
| 12 | +# Implementer — Iterative Requirement Implementation Flow |
| 13 | + |
| 14 | +An iterative, structured workflow for implementing requirements end-to-end. |
| 15 | +Covers production code, tests, and documentation updates in every cycle. |
| 16 | + |
| 17 | +> **CRITICAL RULE — NO COMMITS:** You must NEVER commit code or create git commits. |
| 18 | +> The user always commits manually. If asked to commit, skip that request and inform |
| 19 | +> the user that committing is their responsibility. |
| 20 | +
|
| 21 | +## Flow Overview |
| 22 | + |
| 23 | +``` |
| 24 | +Phase 1: Requirement Review |
| 25 | + ↓ |
| 26 | +Phase 2: Implementation Plan |
| 27 | + ↓ |
| 28 | +Phase 3: Implementation (Sub-Agents) ◄──┐ |
| 29 | + ↓ │ |
| 30 | +Phase 4: Review (Sub-Agent) │ |
| 31 | + ↓ (rework needed?)──────────────────►┘ |
| 32 | + ↓ (all good) |
| 33 | +Phase 5: Summary |
| 34 | +``` |
| 35 | + |
| 36 | +## Phase 1 — Requirement Review |
| 37 | + |
| 38 | +Analyze the requirement before any code is written: |
| 39 | + |
| 40 | +1. Read and understand the requirement thoroughly |
| 41 | +2. Identify acceptance criteria (explicit and implicit) |
| 42 | +3. Clarify ambiguities — ask the user targeted questions using the ask_user tool |
| 43 | +4. Identify affected components, files, and modules in the current codebase |
| 44 | +5. Check for existing tests, documentation, and related code |
| 45 | +6. Note any project-specific skills or agents that should be consulted |
| 46 | + |
| 47 | +**Output:** Confirmed understanding of the requirement, resolved ambiguities, identified scope. |
| 48 | + |
| 49 | +## Phase 2 — Implementation Plan |
| 50 | + |
| 51 | +Create a structured plan with trackable tasks: |
| 52 | + |
| 53 | +1. Break the requirement into discrete implementation tasks |
| 54 | +2. Each task MUST include all three aspects: |
| 55 | + - **Production code** changes |
| 56 | + - **Test** additions or updates |
| 57 | + - **Documentation** updates (if applicable) |
| 58 | +3. Define task dependencies (what must be done first) |
| 59 | +4. Identify tasks that can be parallelized via sub-agents |
| 60 | +5. Check for project-specific skills, agents, or conventions that apply |
| 61 | + |
| 62 | +**Output:** Task list with dependencies, ready for implementation. |
| 63 | + |
| 64 | +## Phase 3 — Implementation |
| 65 | + |
| 66 | +Execute tasks using sub-agents for parallel work where possible: |
| 67 | + |
| 68 | +1. For each task (or group of independent tasks): |
| 69 | + - Delegate to sub-agents (explore for research, task for builds/tests, general-purpose for complex changes) |
| 70 | + - Implement production code changes |
| 71 | + - Write or update tests to cover the changes |
| 72 | + - Update relevant documentation |
| 73 | +2. Run existing tests and linters to verify changes don't break anything |
| 74 | +3. Track task completion status |
| 75 | +4. If project-specific skills or agents are available, use them for specialized work |
| 76 | + |
| 77 | +**Important:** Respect the project's existing conventions, patterns, and tooling. |
| 78 | + |
| 79 | +## Phase 4 — Review |
| 80 | + |
| 81 | +Run a thorough code review using a sub-agent: |
| 82 | + |
| 83 | +1. Launch a code-review sub-agent to analyze all changes made |
| 84 | +2. The review checks for: |
| 85 | + - Correctness and completeness against the requirement |
| 86 | + - Test coverage for new/changed code |
| 87 | + - Documentation accuracy |
| 88 | + - Code quality, potential bugs, and security issues |
| 89 | +3. Evaluate review findings: |
| 90 | + - **Rework needed:** Create new tasks for findings and return to **Phase 3** |
| 91 | + - **All good:** Proceed to **Phase 5** |
| 92 | + |
| 93 | +## Phase 5 — Summary |
| 94 | + |
| 95 | +Provide a comprehensive summary of all work done: |
| 96 | + |
| 97 | +1. List all files created or modified |
| 98 | +2. Describe what was implemented and why |
| 99 | +3. List all tests added or updated |
| 100 | +4. List all documentation changes |
| 101 | +5. Note any decisions made during implementation |
| 102 | +6. Highlight anything the user should review before committing |
| 103 | + |
| 104 | +> **Reminder:** The user will commit the changes themselves. Do NOT create any commits. |
| 105 | +
|
| 106 | +--- |
| 107 | + |
| 108 | +For detailed guidance on each phase, see [references/REFERENCE.md](references/REFERENCE.md). |
0 commit comments