name: scaffold
version: 1
description: Write stub implementations satisfying test signatures before coding begins (WT-PIPE-3)
runtime: scaffolding-repo
input:
  state: tests-written
  tags_forbidden: []
  required_artifacts: []
output:
  state: scaffolded
scope_budget:
  files_modified_max: 5
  lines_diff_max: 300
  wall_clock_seconds_max: 1800
nodes:
  - id: agent
    kind: agent
    template: scaffolding-repo
    runtime_env:
      # WF-COMP-15: stage agents share one per-item work branch so their work
      # accumulates (test-write -> scaffold -> impl -> integrate -> merge all
      # see the same tree). Without AGENT_REPO_URL the agent-repo layer never
      # clones and the agent's output evaporates (E2E 2026-07-04).
      AGENT_REPO_URL: "git@gitea.oreillyit.nz-ai-enablement:skynet/agent-runtimes-agents.git"
      AGENT_BRANCH: "task/${item.uuid}"
    prompt: |
      Write stub implementations for the following task.

      Work item UUID: ${item.uuid}
      Test files: ${metadata.automation.test_files}
      Spec IDs: ${metadata.automation.spec_ids}
      Task description: ${item.body}

      Read the test files on the work branch to identify what functions, classes,
      and modules need to exist. Write minimal stub implementations:
      - Correct signatures and type hints
      - Bodies: raise NotImplementedError("spec-id: description") — no real logic
      - Minimal Pydantic model fields where needed

      Verify stubs compile and tests still collect (they should remain xfail):
        python -m py_compile <files>
        python -m pytest --collect-only ${metadata.automation.test_files}

      Commit and push to the work branch. The coding agent will implement
      real logic on top of these stubs.