agentleFS
mojopolymojopoly/three-loops/skills/build-supervised/SKILL.md

build-supervised

Skill0 starsChanged 3 months agoMITView on GitHub

Implement tickets one sub-task at a time, demonstrating behavior at each checkpoint and waiting for approval before continuing. Use when the operator wants control over the build without reading code — the product-manager mode of the generation step.

The file

We split this skill into the rules it gives an agent

3 rules. About 0 are common, 2 are distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈2

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Keep a visible task list with checkboxes in the working doc or PR body.

    line 18
  2. Distinctive:

    Commit at each approved checkpoint, so approval points are recoverable points in history.

    line 47
  3. Very specific:

    All tasks checked, criteria demonstrated, /verify-live proof captured, PR opened — the Adversary loop takes it from there.

    line 59

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Build Supervised

The default generation step assumes the operator reviews diffs. This mode replaces diff-reading with behavior checkpoints: the agent builds one sub-task, demonstrates the result against its acceptance criteria, explains what it decided in plain language, and stops. Nothing proceeds without an explicit go.

Setup

  1. Take the ticket list from /decompose (or derive sub-tasks from the PRD's acceptance criteria — each criterion maps to at least one task).
  2. Keep a visible task list with checkboxes in the working doc or PR body; update it at every checkpoint. Progress must be legible at a glance.

The loop

For each sub-task, in order:

  1. Announce — one sentence: what this task will make true, and which acceptance criteria it serves.
  2. Build — small commits as always. TDD where the logic warrants it.
  3. Demonstrate, don't describe — run the product and show the behavior: a screenshot, a driven flow, a before/after. The demonstration must map to the criteria ("WHEN the time passes, the post publishes — here's the log line and the published state"). Show code only if asked.
  4. Report decisions — anything chosen along the way that the ticket didn't specify, as plain-language bullets with the reason. If a real fork was hit, STOP and present it as numbered options with a recommendation instead of deciding silently.
  5. Wait. An explicit "go" continues; feedback loops back into the same task; silence means stopped. Never start the next task on momentum.

Rules

  • One task at a time. Batching checkpoints ("done with 1.1–1.4!") is the failure mode this skill exists to prevent — each unreviewed task compounds drift in the next.
  • Checkpoint currency is behavior, not code. "The cancel button now asks for confirmation and names both outcomes" is a checkpoint; "refactored the mutation hook" is not one.
  • Commit at each approved checkpoint, so approval points are recoverable points in history.
  • Decisions with blast radius beyond the ticket (schema, money, deletion, anything in PRINCIPLES.md § Ask-first) always stop the loop — no recommendation-and-proceed.
  • The ordinary quality gates still run underneath: lint, typecheck, unit tests, and /verify-live on the assembled feature before the PR is called done. Supervision replaces diff review by the operator; it does not replace the Reality loop.

Exit

All tasks checked, criteria demonstrated, /verify-live proof captured, PR opened — the Adversary loop takes it from there.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

Reviews can't be read right now.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.