agentleFS
pierrebelinpierrebelin/claude-code-toolkit/skills/implement-tdd/SKILL.md

implement-tdd

Skill7 starsChanged 22 days agoMITView on GitHub

Use to implement a .NET/DDD batch or a whole plan under strict TDD: launches the run-lot workflow (run-plan for a plan) and relays its report; replays a delivered batch or plan read-only (run-replay).

2 other projects use a version of this.

Adopted by

Most recently taken up by

  • Other versions2 projects use a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 2

    1. oopsla5xx/oops-skills★ 4same name
    2. ZAidBinAsif/flutter-ai-starter★ 0same name

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

  • In this repository10 other files it gives its agents.

The file

We split this skill into the rules it gives an agent

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

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈0

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 3

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    No plan → no code: route to /plan-implementation.

    line 16
  2. Very specific:

    No path → ls todo/*/*-PLAN.md.

    line 23
  3. Very specific:

    Before launching run-lot or run-plan: cctoolkit plan-next-batch <plan> --outside FX exit 0, cctoolkit doctor without FAIL, test containers …

    line 28

≈ “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

Strict TDD — launch the chain

The TDD chain is the run-lot workflow (workflows/run-lot.js, shipped by the plugin): cycles read from the sheet's ## Cycles block (design only when absent), one tdd-cycle agent per cycle — RED, a checkpoint the TDD scope hook checks on the tree, then GREEN + REFACTOR + COST + handler CLAUDE.md —, global green beside the pre-audit gate (a haiku agent runs what cctoolkit suites-plan resolves, a repair agent opens only on a red suite), audit (ddd-tdd-auditor). A batch whose files touch no authorisation, migration nor public contract closes light (cctoolkit closing-level): one review of the diff on Correctness and Scope instead of the audit; the next sheet is never reviewed by the run, its own design checks it; the report's Closing: line says which and why. The script holds the sequence; agent definitions, .claude/rules/*.md and references/ hold the method. Never run the chain by hand, never commit by hand: the workflow commits each DONE batch itself (cctoolkit batch-baseline commit).

$ARGUMENTS

When

  • Validated plan from /plan-implementation, batch sheet todo/<code>/<CODE>-PLAN-FX.md present → this skill.
  • No plan → no code: route to /plan-implementation.
  • /effort medium before launching (hooks/implement-tdd-guard.sh refuses high).

Launch

  • batch FX <global plan path> → sheet = <plan without .md>-FX.md; Skill cctoolkit:run-lot, argument = that sheet path as text (never an @ mention).
  • <global plan path> alone, or "the whole plan" → Skill cctoolkit:run-plan, argument = the plan path, optionally --until FX / --only FX.
  • No path → ls todo/*/*-PLAN.md; several → ask.
  • batch FX — correction: manual finding → one Edit of the sheet: a new cycle in its ## Cycles block (behaviour = Correction Cn — [finding], wave after the last, contract fields per references/design.md), then cctoolkit sheet-cycles <sheet> --index exit 0. Sheet without the block → sub-step Correction Cn — [finding] under the affected step, the run's design writes the block. Finding changing scope, an RM/CU or a design decision → stop, /business-spec or /plan-implementation. Then launch run-lot on the sheet.
  • replay batch FX <global plan path>, or replay <global plan path> for every batch ✅ DONE → Skill cctoolkit:run-replay, argument = the sheet (or the plan) path, then the options given: --red (each cycle's tests rerun in a worktree without the batch's production code: they must fail), --no-audit, --only FX (plan), --base <rev> (a batch committed without its Kit-Batch trailer). Read-only: nothing fixed, committed nor ticked; no plan-next-batch check, the batch is delivered.

Before launching run-lot or run-plan: cctoolkit plan-next-batch <plan> --outside FX exit 0, cctoolkit doctor without FAIL, test containers reachable when the batch touches Infrastructure.

During the run

The run never asks nor waits: an ambiguity is decided by the agent that meets it and listed under ## To validate; what no retry settles ends the batch at once, BLOCKED. Never resume it (resumeFromRunId): launch a new run, the saved cycles are not redone.

End

Relay the workflow result: status, reason, verdict, report path (run/batches/FX.md; for a plan, run/<stamp>.md, its ## To validate first: the decisions taken without the user, to read after the plan). A plan result carrying merge → say its state and lines, then Skill cctoolkit:knowledge-merge with the plan path: it shows the diff and writes the base on the user's confirmation only. BLOCKED → fix the cause, record Hn marked user decision in the sheet, launch a new run.

A replay result: its status (PASSED, FAILED, SKIPPED with the reason — no commit carries the batch's trailer), the cycles red, the suites red, the audit gaps and toCheck, the report path (run/batches/FX-replay.md; for a plan, one row per batch). FAILED → the report's ## Next holds one batch FX — correction: … per finding: propose them, apply one only on the user's word (the correction flow above, then run-lot).

Batch run DONE → end with → Batch FX complete — manual validation required. Run /clear before any other batch.

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.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

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.