test-driven-development SKILL.md skillA

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

Install it, pinned
mdr add ganyuanran/aegis/test-driven-development@git:20261010.8d5b88e

Pins git:20261010.8d5b88e in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
ganyuanran/aegis
Path
skills/test-driven-development/SKILL.md
Versions recorded
6
Latest version
git:20261010.8d5b88e, committed Oct 10, 2026
First version recorded
Jul 2, 2026
Size
18,169 bytes
Repository stars
1,424
License
MIT

Use when the user explicitly requests strict or test-first TDD, or when the current conversation already contains an explicit `TDD Route: strict` decision from another Aegis workflow.

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

# Execute

→ False-positive entry on a native-direct-skill host? → **Exit immediately unless the user explicitly asked for TDD or the conversation already contains `TDD Route: strict`.**
  In `off` mode, do not start RED / GREEN / REFACTOR from generic bugfix, contract, shared-module, or risky-code wording alone.
  Hand control back to `using-aegis`, `systematic-debugging`, `writing-plans`, or the fast path with verification.
→ Implementing a feature or bugfix under TDD Route `strict`? → **No production code without a failing test first.**
  Gate: medium/high complexity? → route to brainstorming or writing-plans first.
  Mode: default `off` disables automatic TDD, not completion verification; `auto` chooses strict/light/skipped by risk.
  Change Necessity: before strict RED/GREEN enters production edits, confirm the slice really needs a code change.
  Cycle: RED (write test → watch it fail) → GREEN (minimal code → watch it pass) → REFACTOR (clean up → keep green)
  Regression: shared module → related tests. contract change → producer + consumer. core logic → old + new tests.
  Ripple signal hit → cover producer+consumer or real user path before claiming green.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add ganyuanran/aegis/test-driven-development@sha256:de850e1b4e3911ea

The line at the top of this page pins the label git:20261010.8d5b88e, 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_hkkor37jmtl7ov26.svg)](https://markdownregistry.com/a/art_hkkor37jmtl7ov26)

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

Versions

The registry has recorded 6 versions of this file, between Jul 2, 2026 and Oct 10, 2026, about one every 20 days.

versioncommittedcommitsizeaudit
git:20261010.8d5b88e latest2026-10-10 8d5b88e 18,169 BA view · diff
git:20260723.88b8ec92026-07-23 88b8ec9 17,258 BA view · diff
git:20260713.f1047622026-07-13 f104762 17,256 BA view · diff
git:20260712.f9102602026-07-12 f910260 16,245 BA view · diff
git:20260704.e5dcfb92026-07-04 e5dcfb9 16,214 BA view · diff
git:20260702.b478ab92026-07-02 b478ab9 15,424 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 (18169 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

ganyuanran/aegis · 1,424 stars · license MIT · pushed 2026-11-04 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_hkkor37jmtl7ov26
GET https://markdownregistry.com/api/v1/resolve?ref=ganyuanran/aegis/test-driven-development
GET https://markdownregistry.com/api/v1/blob/de850e1b4e3911ea113f228dca9ca86850dfdac99731389d3f6d2626118b4fd7

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 ganyuanran/aegis

AGENTS.md AGENTS.md file
ganyuanran/aegis · AGENTS.md
git:20261011.c8e05b4 · audit A · 1,424 stars
CLAUDE.md CLAUDE.md file
ganyuanran/aegis · CLAUDE.md
git:20260813.0c73270 · audit A · 1,424 stars
anti-entropy-governance SKILL.md skill
ganyuanran/aegis · skills/anti-entropy-governance/SKILL.md · Use when touching retiring old logic, collapsing duplicate owners, removing fallbacks, or…
git:20260927.6d97ed0 · audit A · 1,424 stars
brainstorming SKILL.md skill
ganyuanran/aegis · skills/brainstorming/SKILL.md · Use when defining ambiguous or high-complexity new features, product behavior, UI/component design, architecture…
git:20261104.8dcabf5 · audit A · 1,424 stars
communicating-concisely SKILL.md skill
ganyuanran/aegis · skills/communicating-concisely/SKILL.md · Use when the user asks for caveman mode, fewer tokens, brief responses, compressed communication, or otherwise…
git:20260723.88b8ec9 · audit A · 1,424 stars
dispatching-parallel-agents SKILL.md skill
ganyuanran/aegis · skills/dispatching-parallel-agents/SKILL.md · Use when facing 2+ independent tasks without a written plan, with no conflicting shared mutable state or sequential…
git:20260920.8265b5c · audit A · 1,424 stars
establishing-project-context SKILL.md skill
ganyuanran/aegis · skills/establishing-project-context/SKILL.md · Use when the user asks to establish shared project language, or project work exposes a conflicting, renamed, or…
git:20260809.f62395b · audit A · 1,424 stars
executing-plans SKILL.md skill
ganyuanran/aegis · skills/executing-plans/SKILL.md · Use when executing a written implementation plan across sessions or with review checkpoints. Small or single-slice…
git:20261001.ed3a0a7 · audit A · 1,424 stars
finishing-a-development-branch SKILL.md skill
ganyuanran/aegis · skills/finishing-a-development-branch/SKILL.md · Use when verified work needs integration or cleanup of an existing task-created branch/worktree, or the user explicitly…
git:20261010.8d5b88e · audit A · 1,424 stars
first-principles-review SKILL.md skill
ganyuanran/aegis · skills/first-principles-review/SKILL.md · Use when asked for first-principles or Occam's-razor review, or when high-risk decisions involve competing constraints…
git:20261025.21787f7 · audit A · 1,424 stars
goal-framing SKILL.md skill
ganyuanran/aegis · skills/goal-framing/SKILL.md · Use when the user explicitly sets an Aegis goal with /aegis-goal, Aegis goal:, or asks to define goal, success…
git:20260723.88b8ec9 · audit A · 1,424 stars
long-task-continuation SKILL.md skill
ganyuanran/aegis · skills/long-task-continuation/SKILL.md · Use when a task is multi-step, may span context resets or sessions, uses subagents, or risks losing state before…
git:20261025.21787f7 · audit A · 1,424 stars

Every file in ganyuanran/aegis

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.