test-driven-development
Skill3 starsChanged 13 days agoMITView on GitHub
Use when writing code that adds or changes behavior (building a feature, fixing a bug, changing a business rule) or when the user asks for TDD, test-first, red-green-refactor, or tests alongside a change.
190 other projects use a version of this.
Adopted by
Most recently taken up by
- matt-riley/agent-skillstheir own version, first seen Nov 15, 2026
- pantheon-org/tekhnetheir own version, first seen Nov 15, 2026
- dvy1987/agent-loomtheir own version, first seen Nov 15, 2026
- FimawLLC/fimaw-skillstheir own version, first seen Nov 15, 2026
- metaspartan/cybaratheir own version, first seen Nov 15, 2026
- crbnos/carbontheir own version, first seen Nov 15, 2026
Used with
Projects with it also use chinese-code-review, chinese-commit-conventions and 10 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
Leodorareluctant259Skillchinese-code-review
中文代码审查规范——在保持专业严谨的同时,用符合国内团队文化的方式给出有效反馈
Also in 8 projects that use this
Leodorareluctant259Skillchinese-commit-conventions
中文 Git 提交规范 — 适配国内团队的 commit message 规范和 changelog 自动化
Also in 8 projects that use this
obraSkilldiagnosing-superpowers
Use when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.
Also in 19 projects that use this
LLl0k0laDSkillusing-agent-skills
Use when starting a session or when you need to discover which skill applies to the current task. This is the meta-skill that governs how all other skills are discovered and invoked.
Also in 39 projects that use this
LLl0k0laDSkillgit-workflow-and-versioning
Use when making any code change. Use when committing, branching, resolving conflicts, or when you need to organize work across multiple parallel streams.
Also in 47 projects that use this
MrCipherSmithSkillconstraint-driven-development
Use when a project needs a persistent, measurable quality bar — starting a project without documented standards, 'set up constraints', or when coverage/perf/a11y thresholds get re-debated per-PR. Produces CONSTRAINTS.md with enforceable numbers, ratchets, and a guard against silent weakening. NOT for throwaway prototypes or a one-off CI setup.
Also in 15 projects that use this
- +3 more from Leodorareluctant259
- +3 more from LLl0k0laD
Other versions190 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 190
- obra/superpowers★ 314ksame name
- NousResearch/hermes-agent★ 264ksame name
- addyosmani/agent-skills★ 118ksame name
- cloudflare/computer★ 9.9ksame name
- jnMetaCode/superpowers-zh★ 8.5ksame name
- openai/plugins★ 7.8ksame name
- farm-fe/farm★ 5.6ksame name
- microsoft/FluidFramework★ 4.9ksame name
- mikeyobrien/ralph-orchestrator★ 3.2ksame name
- crbnos/carbon★ 2.8ksame name
180 more not listed
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 repository9 other files it gives its agents.
- comment-sweepSkill
- design-systemSkill
- domain-driven-designSkill
- feature-designSkill
- pr-babysitSkill
- pr-shipSkill
- resolve-merge-conflictsSkill
- ux-brainstormSkill
- ux-stress-testSkill
The file
We split this skill into the rules it gives an agent
5 rules. 0 are common, 5 are distinctive, and 0 are very specific to this project.
0
Common
Most of the 180 edited versions we read keep these.
5
Distinctive
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 14
Budget: every test costs CI time and upkeep for years.
- Distinctive: line 16
Read references/tests.md before the first test.
- Distinctive: line 32
Test at the cheapest level that gives confidence.
- Distinctive: line 60
Weak: no assertion, only mock-call checks, a large unread snapshot.
- Distinctive: line 68
Run the full suite, lint, and type check, and match or beat the baseline.
“Common” is measured: kept by at least 6 in 10 of the 180 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Test-driven development
Change behavior in small, verified steps: a test list, then one red → green → refactor cycle per item, until your fear about the behavior has turned into boredom.
- Red: one new test, seen failing for the right reason.
- Green: the smallest code change that passes the whole fast suite.
- Refactor: a better design on green, behavior unchanged. Two hats: you add behavior or change structure, one at a time.
- Budget: every test costs CI time and upkeep for years. One test per behavior a caller would notice breaking; the tests you touch end leaner than you found them.
Read references/tests.md before the first test.
1. Ground
- Find the fast and full test commands and run the suite once: the baseline. Record what already fails or flakes, so you never take it for your own red or fix it silently.
- Placement: the repo's convention for that kind of code (the tests beside the file, the runner config), else the language's (Go
_test.gobeside the file, Rust's inlinemod tests,src/test/under Maven and Gradle), else co-locate (pricing.test.tsbesidepricing.ts). Prefer the unit's existing test file. - A bug fix, untested code, a UI, a feature across layers, or a third-party library: read its part of references/situations.md.
Done when you hold the commands, the baseline, each new test's file, and the existing tests that cover the code you'll change.
2. Test list
List behaviors, not methods. Walk ZOMBIES: Zero, One, Many, Boundaries, Interface, Exceptions, Simple first. A bug fix starts with a test on the reported input and its expected result. Then spend the budget:
- Cut what a type, the framework, or an existing test already guarantees.
- Inputs of one behavior become rows of one table (
it.each,parametrize, or a table the file already has). - Test at the cheapest level that gives confidence.
- Mark the existing tests the change makes wrong or redundant.
An expected outcome the task, code, and docs leave open (exactly at a limit, rounding, empty input) is the user's call: ask in one round, your recommendation first, and carry on with the rest. With no one to answer, take your recommendation and list it as an open question.
Done when every item has a behavior, an expected outcome from the spec, and a file.
3. Cycle
One item at a time; tests written ahead mean rework and no feedback.
Red. Name the test as a sentence in domain words. Write it backwards: assertion, call, then only the setup it needs, against the API you wish existed. Write expected values by hand from the spec; a value copied from the code's output checks the code against itself. Run it and watch it fail on an assertion about the behavior, after stubbing away any compile or import error. A test that passes at once is covered: drop it, or, when it pins a decision such as a boundary, break the code to watch it go red, then restore.
Green. The smallest change: Fake It, Triangulate, or Obvious Implementation. Run the whole fast suite. A case you discover goes on the list. Stuck after a couple of tries: revert to the last green and take a smaller test.
Existing tests are the spec, so green comes from changing code. An existing assertion changes only when the task changes the behavior it pins; then change it first, as this cycle's red, and report it. Skipping, deleting, or loosening a failing test to get green removes the safety net the method stands on.
Refactor. On green only, running the suite after each step. Remove duplication, including between test and code (a faked constant). In the tests you added, fold triangulation examples into one table and drop the starter test it covers. Tests you didn't add keep their shape; offer a restyle in the report.
Done when every item's test was seen red for the right reason, the fast suite is green, and the list is empty.
4. Prune
Sweep the touched test files and the tests that cover the code you changed, nothing wider. Prune removes or fixes; the tests that stay keep their shape.
- Redundant: the same behavior is asserted elsewhere at the same or a cheaper level. Delete or merge.
- Obsolete: pins removed behavior, deleted code, or a private detail. Delete, or rewrite through the public behavior when nothing else covers it. Production code that only tests reach goes too.
- Flaky: real clock, sleeps, network, randomness, shared state, test order. Fix the cause: inject the clock or random source, fake timers, intercept the network, reset state. Unfixable: delete it if it adds nothing, otherwise keep and report it.
- Weak: no assertion, only mock-call checks, a large unread snapshot. Assert the outcome a caller sees, or delete.
A test that fails because of your change is a red, never a prune.
Done when each swept test is kept, merged, fixed, or deleted, and each removal names its reason and what still covers the behavior.
5. Verify and report
Run the full suite, lint, and type check, and match or beat the baseline. When the repo already runs mutation testing, run it on the changed files. Commit only when asked, with behavior changes apart from refactoring and pruning.
Report in this shape, dropping empty lines:
<what changed, one line>
Test list: ✓ <behavior> — <test>, <file> · ✗ cut <behavior> — <why>
Tests: +<added> −<removed> ~<changed> (suite <before> → <after>)
Changed assertions · Removed or merged · Fixed flaky · Kept flaky: <test> — <reason; what still covers it>
Open questions: <outcomes you assumed>
Verified: <commands and results against the baseline>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.

