Home / kunanonj / ai-skills-hub · .agents/skills/test-driven-development/SKILL.md · GitHub

test-driven-development skillA

This file is byte-identical to the first copy the registry indexed, one of 4 copies on public GitHub. Same content hash, same audit grade.

test-driven-development is agent-read markdown (skill) from kunanonj/ai-skills-hub: Use when implementing any feature or bugfix, before writing implementation code.

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# Test-Driven Development (TDD)

## Overview

Write the test first. Watch it fail. Write minimal code to pass.

**Core principle:** If you didn't watch the test fail, you don't know if it tests the right thing.

**Violating the letter of the rules is violating the spirit of the rules.**

## When to Use

**Always:**
- New features
- Bug fixes
- Refactoring
- Behavior changes

**Exceptions (ask your human partner):**
- Throwaway prototypes
- Generated code
- Configuration files

Thinking "skip TDD just this once"? Stop. That's rationalization.

## The Iron Law

```
NO PRODUCTION CODE WITHOUT A FAILING TEST FIRST
```

Write code before the test? Delete it. Start over.

**No exceptions:**
- Don't keep it as "reference"
- Don't "adapt" it while writing tests
- Don't look at it
- Delete means delete

Implement fresh from tests. Period.

## Red-Green-Refactor

```dot
digraph tdd_cycle {
    rankdir=LR;
    red [label="RED\nWrite failing test", shape=box, style=filled, fillcolor="#ffcccc"];
    verify_red [label="Verify fails\ncorrectly", shape=diamond];
    green [label="GREEN\nMinimal code", shape=box, style=filled, fillcolor="#ccffcc"];
…

Read the whole file at its exact version.

How to install

Latest version
mdr add kunanonj/ai-skills-hub/test-driven-development@git:20260628.caecf60
Exact content
mdr add kunanonj/ai-skills-hub/test-driven-development@sha256:7dee67b4af6bdccc

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

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

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260628.caecf60 latest2026-06-28 caecf60 9,867 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, 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 (9867 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

kunanonj/ai-skills-hub · 5 stars · license MIT · pushed 2026-09-14 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_fmtekqj35fxerywm
GET https://markdownregistry.com/api/v1/resolve?ref=kunanonj/ai-skills-hub/test-driven-development
GET https://markdownregistry.com/api/v1/blob/7dee67b4af6bdccc7a914ca34533184d64592d0f5b23aeae631538168db14994

Your agent 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.

More from kunanonj/ai-skills-hub

analyze-codebase-for-mcp skill
kunanonj/ai-skills-hub · .agents/skills/analyze-codebase-for-mcp/SKILL.md · Analyze an arbitrary codebase to identify functions, APIs, and data sources suitable for exposure as MCP tools…
v1.0 · audit A · 5 stars
api-analyzer skill
kunanonj/ai-skills-hub · .agents/skills/api-analyzer/SKILL.md · Validates whether an API request is correct based on provided inputs (method, URL, headers, body, auth, query params)…
v1.0 · audit A · 5 stars
api-design-principles skill
kunanonj/ai-skills-hub · .agents/skills/api-design-principles/SKILL.md · Master REST and GraphQL API design principles to build intuitive, scalable, and maintainable APIs that delight…
git:20260628.caecf60 · audit A · 5 stars
api-documentation-generator skill
kunanonj/ai-skills-hub · .agents/skills/api-documentation-generator/SKILL.md · Generate comprehensive, developer-friendly API documentation from code, including endpoints, parameters, examples, and…
git:20260628.caecf60 · audit A · 5 stars
api-security-best-practices skill
kunanonj/ai-skills-hub · .agents/skills/api-security-best-practices/SKILL.md · Implement secure API design patterns including authentication, authorization, input validation, rate limiting, and…
git:20260628.caecf60 · audit A · 5 stars
architecture-decision-records skill
kunanonj/ai-skills-hub · .agents/skills/architecture-decision-records/SKILL.md · Comprehensive patterns for creating, maintaining, and managing Architecture Decision Records (ADRs) that capture the…
git:20260628.caecf60 · audit A · 5 stars
architecture-patterns skill
kunanonj/ai-skills-hub · .agents/skills/architecture-patterns/SKILL.md · Master proven backend architecture patterns including Clean Architecture, Hexagonal Architecture, and Domain-Driven…
git:20260628.caecf60 · audit A · 5 stars
backend-api-design skill
kunanonj/ai-skills-hub · .agents/skills/backend-api-design/SKILL.md · Design RPC-style APIs with layered architecture (Controller → Manager → Repository). Use when creating new API…
git:20260628.caecf60 · audit A · 5 stars
backend-dev-guidelines skill
kunanonj/ai-skills-hub · .agents/skills/backend-dev-guidelines/SKILL.md · You are a senior backend engineer operating production-grade services under strict architectural and reliability…
git:20260628.caecf60 · audit A · 5 stars
backend-security-coder skill
kunanonj/ai-skills-hub · .agents/skills/backend-security-coder/SKILL.md · Expert in secure backend coding practices specializing in input validation, authentication, and API security. Use…
git:20260628.caecf60 · audit A · 5 stars
browser-screenshot-diff skill
kunanonj/ai-skills-hub · .agents/skills/browser-screenshot-diff/SKILL.md · Visual + DOM diff between two recorded sessions at matching trajectory step ids; used for visual regression and replay…
git:20260628.caecf60 · audit A · 5 stars
browser-testing-with-devtools skill
kunanonj/ai-skills-hub · .agents/skills/browser-testing-with-devtools/SKILL.md · Tests in real browsers via Chrome DevTools MCP. Use when building or debugging anything that runs in a browser. Use…
git:20260628.caecf60 · audit B · 5 stars

Every file in kunanonj/ai-skills-hub

Other files named test-driven-development

test-driven-development 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 · 291,204 stars
test-driven-development 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:20260907.cda4542 · audit A · 98,554 stars
test-driven-development skill
jnmetacode/superpowers-zh · skills/test-driven-development/SKILL.md · 在实现任何功能或修复 bug 时使用,在编写实现代码之前
v1.0.0 · audit A · 8,203 stars
test-driven-development 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,809 stars
test-driven-development 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,809 stars
test-driven-development skill
a5c-ai/babysitter · library/methodologies/cc10x/skills/test-driven-development/SKILL.md · Strict RED-GREEN-REFACTOR cycle enforcement. Tests are never skipped or deferred. Run mode only, never watch mode. Exit…
git:20260601.da7723a · audit A · 1,809 stars
test-driven-development skill
ganyuanran/aegis · skills/test-driven-development/SKILL.md · Use when the user explicitly requests strict or test-first TDD, or when the current conversation already contains an…
git:20260723.88b8ec9 · audit A · 1,280 stars
test-driven-development skill
mateaix/mateclaw · mateclaw-server/src/main/resources/skills/test-driven-development/SKILL.md · TDD: enforce RED-GREEN-REFACTOR, tests before code.
v1.1.0 · audit A · 1,127 stars

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