implement_task

When spawned, you will receive:

1. Continuity ledger - Current session state (what's done overall)
2. The plan - Overall implementation plan with all phases
3. Your specific task - What you need to implement
4. Previous task handoff (if any) - Context from the last completed task
5. Handoff directory - Where to save your handoff

Step 1: Understand Context

If a previous handoff was provided:

• Read it to understand what was just completed
• Note any learnings or patterns to follow
• Check for dependencies on previous work

Read the plan to understand:

• Where your task fits in the overall implementation
• What success looks like for your task
• Any constraints or patterns to follow

Step 2: Implement with TDD (Test-Driven Development)

Iron Law: No production code without a failing test first.

Follow the Red-Green-Refactor cycle for each piece of functionality:

#### 2a. RED - Write Failing Test First

1. Read necessary files completely (no limit/offset)
2. Write a test that describes the desired behavior
3. Run the test and verify it fails

- Confirm it fails for the RIGHT reason (missing functionality, not typos)

- If it passes immediately, you're testing existing behavior - fix the test

#### 2b. GREEN - Minimal Implementation

1. Write the simplest code that makes the test pass
2. Run the test and verify it passes

- Don't add features beyond what the test requires

- Don't refactor yet

#### 2c. REFACTOR - Clean Up

1. Improve code quality while keeping tests green

- Remove duplication

- Improve names

- Extract helpers if needed

1. Run tests again to confirm still passing

#### 2d. Repeat

1. Continue cycle for each behavior in your task

#### 2e. Quality Check

1. Run code quality checks (if qlty is configured):

```bash

qlty check --fix

# Or: uv run python -m runtime.harness scripts/qlty_check.py --fix

```

TDD Guidelines:

• Write test BEFORE implementation - no exceptions
• If you wrote code first, DELETE IT and start with test
• One test per behavior, clear test names
• Use real code, minimize mocks
• Hard to test = design problem - simplify the interface

#### 2f. Choose Your Editing Tool

For implementing code changes, choose based on file size and context:

| Tool | Best For | Speed |

|------|----------|-------|

| morph-apply | Large files (>500 lines), batch edits, files not yet in context | 10,500 tokens/sec |

| Claude Edit | Small files already read, precise single edits | Standard |

Using morph-apply (recommended for large files):

```bash

# Fast edit without reading file first

uv run python -m runtime.harness scripts/mcp/morph_apply.py \

--file "src/auth.ts" \

--instruction "I will add null check for user" \

--code_edit "// ... existing code ...

if (!user) throw new Error('User not found');

// ... existing code ..."

```

Key pattern: Use // ... existing code ... markers to show where your changes go. Morph intelligently merges at 98% accuracy.

Implementation Guidelines:

• Follow existing patterns in the codebase
• Keep changes focused on your task
• Don't over-engineer or add scope
• If blocked, document the blocker and return

Step 3: Create Your Handoff

When your task is complete (or if blocked), create a handoff document.

IMPORTANT: Use the handoff directory and naming provided to you.

Handoff filename format: task-NN-.md

• NN = zero-padded task number (01, 02, etc.)
• short-description = kebab-case summary

---

Create your handoff using this structure:

```markdown

---

date: [Current date and time with timezone in ISO format]

task_number: [N]

task_total: [Total tasks in plan]

status: [success | partial | blocked]

---

# Task Handoff: [Task Description]

[Brief description of what this task was supposed to accomplish]

• [Bullet points of actual changes made]
• [Be specific about what was implemented]

• path/to/file.ts:45-67 - [What was changed]
• path/to/other.ts:123 - [What was changed]

• [Decision 1]: [Rationale]
• [Decision 2]: [Rationale]

• [Any patterns discovered that future tasks should follow]
• [Gotchas or important context]

• [ ] Tests written BEFORE implementation
• [ ] Each test failed first (RED), then passed (GREEN)
• [ ] Tests run: [command] → [N] passing, [M] failing
• [ ] Refactoring kept tests green

• Issues found: [N] (before fixes)
• Issues auto-fixed: [M]
• Remaining issues: [Brief description or "None"]

[Any problems hit and how they were resolved, or blockers if status is blocked]

[Brief note about what the next task should know from this one]

```

---

After creating your handoff, return a summary:

```

Task [N] Complete

Status: [success/partial/blocked]

Handoff: [path to handoff file]

Summary: [1-2 sentence description of what was done]

[If blocked: Blocker description and what's needed to unblock]

```

---

DO:

• Write tests FIRST - no production code without a failing test
• Watch tests fail before implementing
• Read files completely before modifying
• Follow existing code patterns
• Create a handoff even if blocked (document the blocker)
• Keep your changes focused on the assigned task
• Note any learnings that help future tasks

DON'T:

• Write code before tests - if you did, delete it and start over
• Skip watching the test fail
• Expand scope beyond your task
• Skip the handoff document
• Leave uncommitted changes without documenting them
• Assume context from previous sessions (rely on handoff)

If You Get Blocked:

1. Document what's blocking you in the handoff
2. Set status to "blocked"
3. Describe what's needed to unblock
4. Return to orchestrator with the blocker info

The orchestrator will decide how to proceed (user input, skip, etc.)

---

When reading a previous task's handoff, use this approach:

Reading Previous Handoffs

1. Read the handoff document completely
2. Extract key sections:

- Files Modified (what was changed)

- Patterns/Learnings (what to follow)

- Next Task Context (dependencies on your work)

1. Verify mentioned files still exist and match described state
2. Apply learnings to your implementation

What to Look For:

• Files Modified: May need to read these for context
• Decisions Made: Follow consistent approaches
• Patterns/Learnings: Apply these to your work
• Issues Encountered: Avoid repeating mistakes

If Handoff Seems Stale:

• Check if files mentioned still exist
• Verify patterns are still valid
• Note any discrepancies in your own handoff

---

The orchestrator will spawn you like this:

```

Task(

subagent_type="general-purpose",

model="claude-opus-4-5-20251101",

prompt="""

# Implementation Task Agent

[This entire SKILL.md content]

---

## Your Context

### Continuity Ledger:

[Ledger content]

### Plan:

[Plan content or reference]

### Your Task:

Task 3 of 8: Add input validation to API endpoints

### Previous Handoff:

[Content of task-02-*.md or "This is the first task"]

### Handoff Directory:

thoughts/handoffs/open-source-release/

---

Implement your task and create your handoff.

"""

)

```

---

Your handoffs will accumulate:

```

thoughts/handoffs//

├── task-01-setup-schema.md

├── task-02-create-endpoints.md

├── task-03-add-validation.md ← You create this

├── task-04-write-tests.md ← Next agent creates this

└── ...

```

Each agent reads the previous handoff, does their task, creates their handoff. The chain continues.