test-first SKILL.md skillA

test-first from bmtrnavsky/disciplined-vibe-coding is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add bmtrnavsky/disciplined-vibe-coding/test-first@git:20261027.93e47a5

Pins git:20261027.93e47a5 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
bmtrnavsky/disciplined-vibe-coding
Path
skills/test-first/SKILL.md
Versions recorded
2
Latest version
git:20261027.93e47a5, committed Oct 27, 2026
First version recorded
Sep 13, 2026
Size
1,188 bytes
Repository stars
14
License
a license file GitHub does not identify

Use during Build for testable logic. Failing test before implementation (light RGR). Declared exemptions over faked tests. (Lineage: superpowers/test-driven-development, godmode/test-first).

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-first — RED before GREEN

## Prime directive
The test exists and fails before the passing code exists.

## Steps
1. **RED:** one test, one behavior; watch it fail.
2. **GREEN:** smallest passing change.
3. **REFACTOR:** only inside green's protection; oversized refactors get flagged.
4. **Exemptions:** markup, styles, config, docs declare exemption; logic never does. Model tasks: the "test" is the pre-registered metric band from the plan.

## Cognitive traps
- "Tests after" — they test what you wrote, not what you promised.
- "One big test" — one behavior per test.

## Guardrails
- Never implement first to "check the plan."
- Never weaken a failing test to reach green.

## Rung scaling (economy ladder)

Full-spec and above: RED then GREEN, no exceptions. Micro-spec: one
failing check before the fix. One-liner: a smoke check after the change
suffices, declared in chat. Declared exemptions beat faked tests at every
rung.

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add bmtrnavsky/disciplined-vibe-coding/test-first@sha256:8d77583adb2c2836

The line at the top of this page pins the label git:20261027.93e47a5, 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_g3wz52n4rli4y5yh.svg)](https://markdownregistry.com/a/art_g3wz52n4rli4y5yh)

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

Versions

The registry has recorded 2 versions of this file, between Sep 13, 2026 and Oct 27, 2026, about one every 44 days.

versioncommittedcommitsizeaudit
git:20261027.93e47a5 latest2026-10-27 93e47a5 1,188 BA view · diff
git:20260913.7de97942026-09-13 7de9794 933 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 (1188 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

bmtrnavsky/disciplined-vibe-coding · 14 stars · license a license file GitHub does not identify · pushed 2026-11-03 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_g3wz52n4rli4y5yh
GET https://markdownregistry.com/api/v1/resolve?ref=bmtrnavsky/disciplined-vibe-coding/test-first
GET https://markdownregistry.com/api/v1/blob/8d77583adb2c283629e82eef8f11818d35c5ad96409d35735d4a6853b3a44251

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 bmtrnavsky/disciplined-vibe-coding

disciplined-vibe-coding SKILL.md skill
bmtrnavsky/disciplined-vibe-coding · plugins/disciplined-vibe-coding/SKILL.md · Run any coding task through Intake, Define, Economy gate, Plan, Teardown, Build, Verify, Commit — with Wayfinder…
v0.2.0 · audit A · 14 stars
brainstorm SKILL.md skill
bmtrnavsky/disciplined-vibe-coding · skills/brainstorm/SKILL.md · Use after intake when a confirmed direction has approach-level design choices. 2-3 options per fork, batch independent…
git:20261027.93e47a5 · audit A · 14 stars
debug SKILL.md skill
bmtrnavsky/disciplined-vibe-coding · skills/debug/SKILL.md · Use whenever behavior is wrong, tests fail, or the user reports a bug. Docs-first root-cause triage, observation mode…
git:20261027.93e47a5 · audit A · 14 stars
execute SKILL.md skill
bmtrnavsky/disciplined-vibe-coding · skills/execute/SKILL.md · Use in Build to run an approved plan. Direct work or up to 5 workers; orchestrator exclusively owns git, plan/roadmap…
git:20261027.93e47a5 · audit A · 14 stars
intake SKILL.md skill
bmtrnavsky/disciplined-vibe-coding · skills/intake/SKILL.md · Use at the very start of any coding task or project. Interviews, classifies scale AND stakes, resolves direction forks…
git:20261027.5b28691 · audit A · 14 stars
plan SKILL.md skill
bmtrnavsky/disciplined-vibe-coding · skills/plan/SKILL.md · Use to plan one milestone (or small task) into atomic steps: paths, outputs, pass/fail checks, rollback/dry-run for…
git:20261027.5b28691 · audit A · 14 stars
research SKILL.md skill
bmtrnavsky/disciplined-vibe-coding · skills/research/SKILL.md · Use before building anything novel, modifying unfamiliar code, ranking unfamiliar tech, or whenever a library/API is…
git:20261027.93e47a5 · audit A · 14 stars
verify SKILL.md skill
bmtrnavsky/disciplined-vibe-coding · skills/verify/SKILL.md · Use before done-claims, milestone completion, releases. Fresh evidence — terminal, user-attested, integrity, plus…
git:20261027.5b28691 · audit A · 14 stars
version SKILL.md skill
bmtrnavsky/disciplined-vibe-coding · skills/version/SKILL.md · Use for commits at Build checkpoints, and releases/bumps/changelogs in Verify. Narrative commits, semver…
git:20261028.1e22c39 · audit A · 14 stars
write-docs SKILL.md skill
bmtrnavsky/disciplined-vibe-coding · skills/write-docs/SKILL.md · Use whenever writing docs/notes/changelogs/plans/roadmaps/prose for the user. Pragmatic ASD-STE100. Governs question…
git:20261027.93e47a5 · audit A · 14 stars

Every file in bmtrnavsky/disciplined-vibe-coding

Other files named test-first

test-first SKILL.md skill
llopresto87/cypress · skills/test-first/SKILL.md · The test-shaping technique applied inside the test-first protocol — pick the lowest test level that exercises the…
git:20261014.eff8d56 · audit A · 119 stars
test-first SKILL.md skill
claude-world/director-mode-lite · skills/test-first/SKILL.md · Drive one feature through a strict TDD Red-Green-Refactor cycle with checklists for each phase. Use when implementing…
git:20260706.14c5553 · audit A · 80 stars
test-first SKILL.md skill
joahanmorales/upiixia-agentic-kit · kit/.uak/skills/test-first/SKILL.md · Use before writing code for any feature, bug fix or behavior change. Test names first, see the red on an assertion (uak…
git:20261102.5cbb8ca · audit A · 12 stars

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