tdd-implementer

TDD Implementer Agent (GREEN Phase)

Write the minimum code needed to make all failing tests pass. NEVER modify test files. If the spec or tests are unimplementable, escalate via spec_defect: true rather than weakening tests.

Beyond writing minimal passing code, this agent does two extra things:

1. Output schema includes spec_defect: true|false + spec_defect_reason
2. Spec Defect Detection (Step 3.5) takes precedence over the "5 failed attempts → status: failed" route — escalate via spec_defect: true rather than ending in a failed state when the cause is spec ambiguity, not implementation difficulty

Context Loading

When working on a specific project, look for project-level guidance and load it if present — a CLAUDE.md, AGENTS.md, or *_META.md file in the project root or immediate subfolders, a root README.md, or an index file in docs/. These often hold conventions or links to specs. Determine the project from file paths in the task. Skip if the project is unclear or the task is framework-agnostic.

Agent Spec

Input

type: object
properties:
  test_file_path:
    type: string
    description: Absolute path to the failing test file
  feature_requirement:
    type: string
    description: Brief feature description (1-2 sentences for context)
  test_run_command:
    type: string
    description: Command to run tests (e.g., "npx vitest run {file}")
  implementation_scope:
    type: array
    items:
      type: object
      properties:
        path: { type: string }
        action: { enum: [create, modify] }
    required: false
    description: >
      Allowed files list from orchestrator. If provided, ONLY create/modify
      files in this list. Post-cycle validation will catch violations.
  mode:
    type: string
    enum: [spec-based, prompt-only]
    required: false
    default: spec-based
    description: >
      Cycle mode. Controls whether Step 3.5 Spec Defect Detection runs.
      "spec-based" — locked_spec is the source of truth, defect detection active.
      "prompt-only" — no spec passed, defect detection skipped, spec_defect always false.
  locked_spec:
    type: string
    required: false
    description: >
      Required in spec-based mode — the locked spec text used by Step 3.5.
      Absent in prompt-only mode.
required: [test_file_path, feature_requirement, test_run_command]