test-driven-development SKILL.md skillA

test-driven-development from brunob54/superpowers-orchestrator is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add brunob54/superpowers-orchestrator/test-driven-development@git:20261021.eed7347

Pins git:20261021.eed7347 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
brunob54/superpowers-orchestrator
Path
skills/test-driven-development/SKILL.md
Versions recorded
6
Latest version
git:20261021.eed7347, committed Oct 21, 2026
First version recorded
Mar 8, 2026
Size
5,941 bytes
Repository stars
3
License
MIT

MUST USE for any behavior change: write failing tests before production code. No exceptions. Triggers on: "TDD", "write tests first", any implementation task, bug fix needing regression tests, behavior changes during execution. Routed by using-superpowers, or invoke directly via /test-driven-development.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Test-Driven Development

Write failing tests first. Then write minimal code to pass.

## Iron Law

**No production code before a failing test proves the behavior is missing.**

If code was written first, **delete it** and restart from a test. No exceptions.

This is the hardest rule to follow and the most important. Every rationalization to skip it leads to untested behavior that breaks later.

## Cycle

1. **RED**: Write one small failing test for one behavior.
2. **VERIFY RED**: Run the test. Confirm it fails **for the expected reason** (not a syntax error or import issue).
3. **GREEN**: Write the **minimum** production code to make the test pass. Nothing more.
4. **VERIFY GREEN**: Run the target test and relevant broader tests. Confirm pass.
5. **REFACTOR**: Improve structure without changing behavior. Tests must stay green.

Repeat per behavior. Never skip VERIFY steps.

## Test Infrastructure Check

Before writing the first test, verify the project has a test runner:

1. Check for test config: `jest.config.*`, `vitest.config.*`, `pytest.ini`, `pyproject.toml [tool.pytest]`, `go.mod`, `Cargo.toml`, `.rspec`, `phpunit.xml`
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add brunob54/superpowers-orchestrator/test-driven-development@sha256:f94f5e64352672ab

The line at the top of this page pins the label git:20261021.eed7347, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_x2weajdcj3wh5gfo.svg)](https://markdownregistry.com/a/art_x2weajdcj3wh5gfo)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 6 versions of this file, between Mar 8, 2026 and Oct 21, 2026, about one every 45 days.

versioncommittedcommitsizeaudit
git:20261021.eed7347 latest2026-10-21 eed7347 5,941 BA view · diff
git:20260415.0a78a702026-04-15 0a78a70 5,315 BA view · diff
git:20260313.623081f2026-03-13 623081f 4,521 BA view · diff
git:20260308.5884b952026-03-08 5884b95 3,652 BA view · diff
git:20260308.f9b94802026-03-08 f9b9480 3,556 BA view · diff
git:20260308.eb8b7c12026-03-08 eb8b7c1 1,926 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (5941 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

brunob54/superpowers-orchestrator · 3 stars · license MIT · pushed 2026-11-02 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_x2weajdcj3wh5gfo
GET https://markdownregistry.com/api/v1/resolve?ref=brunob54/superpowers-orchestrator/test-driven-development
GET https://markdownregistry.com/api/v1/blob/f94f5e64352672ab122740f386c2845751ea3a626aed3453ef6edc2aba12b215

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from brunob54/superpowers-orchestrator

brainstorming SKILL.md skill
brunob54/superpowers-orchestrator · skills/brainstorming/SKILL.md · MUST USE when the user wants new features, behavior changes, refactoring with new capabilities, or architecture…
git:20260921.cf1d92c · audit A · 3 stars
claude-md-creator SKILL.md skill
brunob54/superpowers-orchestrator · skills/claude-md-creator/SKILL.md · Creates minimal, high-signal CLAUDE.md and AGENTS.md context files based on empirical best practices. Invoke on /init…
git:20260328.a951826 · audit A · 3 stars
context-management SKILL.md skill
brunob54/superpowers-orchestrator · skills/context-management/SKILL.md · Use in long or noisy sessions to persist durable state across session boundaries via state.md. Also generates…
git:20261008.473e04a · audit A · 3 stars
dashboard SKILL.md skill
brunob54/superpowers-orchestrator · skills/dashboard/SKILL.md · Shows the status of this repository on a claude.ai Artifact page — unfinished orchestration runs, branches, work logs…
git:20261025.5ed9039 · audit A · 3 stars
deliberation SKILL.md skill
brunob54/superpowers-orchestrator · skills/deliberation/SKILL.md · Use BEFORE brainstorming when facing a complex architectural, technology, or design decision where the options are not…
git:20260415.0a78a70 · audit A · 3 stars
dependency-management SKILL.md skill
brunob54/superpowers-orchestrator · skills/dependency-management/SKILL.md · MUST USE when updating, migrating, or auditing project dependencies: upgrading packages, fixing security…
git:20260508.ae16bf3 · audit A · 3 stars
dispatching-parallel-agents SKILL.md skill
brunob54/superpowers-orchestrator · skills/dispatching-parallel-agents/SKILL.md · Use when 2+ tasks are independent and can run concurrently without file or state conflicts or sequential dependencies…
git:20260815.dcd9fd0 · audit A · 3 stars
error-recovery SKILL.md skill
brunob54/superpowers-orchestrator · skills/error-recovery/SKILL.md · Maintains a project-specific known-issues.md mapping recurring errors to their solutions. Consulted automatically by…
git:20260313.623081f · audit A · 3 stars
executing-plans SKILL.md skill
brunob54/superpowers-orchestrator · skills/executing-plans/SKILL.md · MUST USE when a plan.md exists and implementation needs to begin. Executes in controlled batches with verification…
git:20260817.e70e480 · audit A · 3 stars
finishing-a-development-branch SKILL.md skill
brunob54/superpowers-orchestrator · skills/finishing-a-development-branch/SKILL.md · MUST USE when implementation is verified and you need to choose the branch outcome: merge, PR, keep, or discard…
git:20261005.8280e38 · audit A · 3 stars
frontend-design SKILL.md skill
brunob54/superpowers-orchestrator · skills/frontend-design/SKILL.md · MUST USE for any frontend, UI, or web interface implementation. Enforces production-grade visual quality…
git:20260508.ae16bf3 · audit A · 3 stars
handoff SKILL.md skill
brunob54/superpowers-orchestrator · skills/handoff/SKILL.md · Write a continuation prompt for a fresh session into tmp/docs/<date>-handoff-<slug>.md, save state, and print the…
git:20260915.87c8587 · audit A · 3 stars

Every file in brunob54/superpowers-orchestrator

Other files named test-driven-development

test-driven-development SKILL.md skill
obra/superpowers · skills/test-driven-development/SKILL.md · Use when implementing any feature or bugfix, before writing implementation code
git:20260919.5bf4e78 · audit A · 314,583 stars
test-driven-development SKILL.md skill
addyosmani/agent-skills · skills/test-driven-development/SKILL.md · Drives development with tests using the red-green-refactor loop. Use when implementing any logic, fixing any bug, or…
git:20261029.2b14012 · audit A · 113,383 stars
test-driven-development SKILL.md skill
mvschwarz/openrig · skills/_canonical/process/test-driven-development/SKILL.md · Use when implementing any feature or bugfix, before writing implementation code
git:20261025.a37e271 · audit A · 8,636 stars
test-driven-development SKILL.md skill
mvschwarz/openrig · packages/daemon/specs/agents/shared/skills/process/test-driven-development/SKILL.md · Use when implementing any feature or bugfix, before writing implementation code
git:20261025.a37e271 · audit A · 8,636 stars
test-driven-development SKILL.md skill
jnmetacode/superpowers-zh · skills/test-driven-development/SKILL.md · 在实现任何功能或修复 bug 时使用,在编写实现代码之前
v1.0.0 · audit A · 8,494 stars
test-driven-development SKILL.md skill
cbrock84/headcount · plugins/technology/skills/test-driven-development/SKILL.md · Drives implementation by writing a failing test first, then the smallest code that passes it. Use this before writing…
git:20260901.aa45383 · audit A · 2,543 stars
test-driven-development SKILL.md skill
a5c-ai/babysitter · library/methodologies/superpowers/skills/test-driven-development/SKILL.md · Use when implementing any feature or bugfix, before writing implementation code. Enforces RED-GREEN-REFACTOR cycle.
git:20260601.da7723a · audit A · 1,896 stars
test-driven-development SKILL.md skill
a5c-ai/babysitter · library/methodologies/rpikit/skills/test-driven-development/SKILL.md · Test-first development practice where test specifications are written before production code, integrated into plan…
git:20260601.da7723a · audit A · 1,896 stars

Browse by kind, by grade A, or by owner.