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
- oopsla5xx/oops-skillstheir own version, first seen Aug 2, 2026
- ZAidBinAsif/flutter-ai-startertheir own version, first seen Jun 20, 2026
Other versions2 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 2
- oopsla5xx/oops-skills★ 4same name
- 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.
- CLAUDE.mdCLAUDE.md
- askSkill
- business-specSkill
- kit-initSkill
- knowledge-mergeSkill
- knowledge-syncSkill
- learnSkill
- plan-implementationSkill
- quality-reportSkill
- verify-ddd-tddSkill
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
- Very specific: line 16
No plan → no code: route to /plan-implementation.
- Very specific: line 23
No path → ls todo/*/*-PLAN.md.
- Very specific: line 28
Before launching run-lot or run-plan: cctoolkit plan-next-batch <plan> --outside FX exit 0, cctoolkit doctor without FAIL, test containers …
≈ “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.
Files
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 sheettodo/<code>/<CODE>-PLAN-FX.mdpresent → this skill. - No plan → no code: route to
/plan-implementation. /effort mediumbefore launching (hooks/implement-tdd-guard.shrefuseshigh).
Launch
batch FX <global plan path>→ sheet =<plan without .md>-FX.md; Skillcctoolkit:run-lot, argument = that sheet path as text (never an@mention).<global plan path>alone, or "the whole plan" → Skillcctoolkit:run-plan, argument = the plan path, optionally--until FX/--only FX.- No path →
ls todo/*/*-PLAN.md; several → ask. batch FX — correction: manual finding→ oneEditof the sheet: a new cycle in its## Cyclesblock (behaviour=Correction Cn — [finding], wave after the last, contract fields perreferences/design.md), thencctoolkit sheet-cycles <sheet> --indexexit 0. Sheet without the block → sub-stepCorrection 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-specor/plan-implementation. Then launchrun-loton the sheet.replay batch FX <global plan path>, orreplay <global plan path>for every batch ✅ DONE → Skillcctoolkit: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 itsKit-Batchtrailer). 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.
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
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.

