harness-scaffold

name	harness-scaffold
description	Regenerate the structural skeleton of a harness — agent role stubs, KB layout, and per-stack rule files — for a repository's stack, in seconds. Use when a harness structure must be (re)created from artifacts on disk, after the roles and contract are already understood and never before. Produces structure only: every stub is intentionally empty, and the scaffold grants no authority.

Harness Scaffold

One run regenerates the harness structure the team already understands: agents/ role stubs, kb/<stack>/ knowledge-base placeholders, and rules/<stack>.md rule stubs, plus a manifest. It is the automation of the hand-written work from sessions/d2/03-agent-pair.md — faster, never smarter.

Day 2 of Semana Engenharia Agêntica delivers this skill. It follows Day 1's interview-the-system, which supplies the evidence and the owned questions the harness is built around, and it precedes Day 3's spec-before-build, which writes the units that execute inside the authority this structure holds.

Boundaries

• Writes ONLY under tmp/harness-scaffold/. Never touches AGENTS.md, CLAUDE.md, dbt/, src/, or storage/.
• Grants no authority. The harness contract does that; this skill only lays out where the pieces of a harness live.
• Every generated file is a stub, empty by design. What fills a stub — grounded KB content, tuned doctrine — is human work measured in hours, not a generator's output.
• Requires no chat memory: everything it needs is on disk.

Method

1. Read the stack from the request (default for this repo: dbt,duckdb,fastapi,mcp).

2. Run the generator:

   uv run python skills/harness-scaffold/scripts/scaffold_harness.py \
     --stack dbt,duckdb,fastapi,mcp --dest tmp/harness-scaffold
   

3. Validate the structure:

   uv run python skills/harness-scaffold/scripts/scaffold_harness.py \
     --stack dbt,duckdb,fastapi,mcp --dest tmp/harness-scaffold --check
   

4. Report: the generated tree, the manifest summary, and the reminder that every stub is empty. Open one stub if asked — show, do not narrate.

Human stop

The scaffold is structure, not content, and it is not authorization. Building anything inside it still requires the confirmed harness contract, and every semantic decision (Revenue included) stays with its named owner.