Home / llopresto87 / cypress · skills/test-first/SKILL.md · GitHub

test-first skillA

test-first is agent-read markdown (skill) from llopresto87/cypress: The test-SHAPING technique applied inside the test-first protocol — pick the lowest test level that exercises the behavior (unit, integration, contract, e2e, golden, property-based, evaluation), name the test after the spec contract, and assert one outcome per test. The workflow itself (entry conditions, RED-GREEN-REFACTOR-COMMIT gates, variants, exceptions) is the test-first protocol..

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-first (the test-shaping technique)

The cycle — RED → GREEN → REFACTOR → COMMIT, its per-phase gates, the
characterize-first rule, the bug-fix and refactor variants, the
migration safety gate, and the recorded exceptions — lives in
`docs/graph/protocols/test-first.md`, the one home for the workflow. This skill
owns the craft of shaping each test the cycle asks for.

## Test level selection

Pick the lowest level that exercises the behavior.

| Level             | Use when                                                |
|-------------------|---------------------------------------------------------|
| Unit              | Pure logic, transformations, parsers, validators.       |
| Integration       | Crossing an adapter (DB, file, network, SDK, model).    |
| Contract          | API endpoints, structured outputs, message schemas.     |
| End-to-end        | Critical flows — one or two per flow, no more.          |
| Golden / snapshot | Deterministic transforms, prompts, renderers.           |
| Property-based    | Algorithms where the property is clearer than examples. |
| Evaluation        | LLM/VLM behavior, with rubrics and pass thresholds.     |

## Test shape
…

Read the whole file at its exact version.

How to install

Latest version
mdr add llopresto87/cypress/test-first@git:20260915.df30567
Exact content
mdr add llopresto87/cypress/test-first@sha256:cee39a13a3bad2e5

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_ryuk3yqp5yk2lndj.svg)](https://markdownregistry.com/a/art_ryuk3yqp5yk2lndj)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260915.df30567 latest2026-09-15 df30567 3,108 BA view · diff
git:20260831.6dde4342026-08-31 6dde434 2,926 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 (3108 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

llopresto87/cypress · 43 stars · license MIT · pushed 2026-09-24 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_ryuk3yqp5yk2lndj
GET https://markdownregistry.com/api/v1/resolve?ref=llopresto87/cypress/test-first
GET https://markdownregistry.com/api/v1/blob/cee39a13a3bad2e5cc9cfa3abc4bf72cc51d3531841c3177da31d957e72e9fa1

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 llopresto87/cypress

CLAUDE.md claude
llopresto87/cypress · CLAUDE.md
git:20260924.fae0414 · audit A · 43 stars
AGENTS.md@core agents
llopresto87/cypress · core/AGENTS.md
git:20260915.df30567 · audit A · 43 stars
adopt-existing skill
llopresto87/cypress · skills/adopt-existing/SKILL.md · Source-first growth of an existing single- or multi-repository project into CYPRESS's unified docs/graph knowledge…
git:20260915.df30567 · audit A · 43 stars
adr-writer skill
llopresto87/cypress · skills/adr-writer/SKILL.md · Author an Architecture Decision Record that captures a non-obvious technical choice — its context, the decision, the…
git:20260915.df30567 · audit A · 43 stars
brainstorm-internal skill
llopresto87/cypress · skills/brainstorm-internal/SKILL.md · The divergence technique CYPRESS applies to itself, with no user in the loop — generating genuinely distinct options…
git:20260921.0e86c1a · audit A · 43 stars
brainstorm-socratic skill
llopresto87/cypress · skills/brainstorm-socratic/SKILL.md · The Socratic questioning technique that converges a vague goal — question selection, one-to-three-per-turn pacing, the…
git:20260921.0e86c1a · audit A · 43 stars
context-router skill
llopresto87/cypress · skills/context-router/SKILL.md · Resolve the minimum set of knowledge-graph nodes needed for a task before reading any source file. Use at the START of…
git:20260923.837b1a5 · audit A · 43 stars
grill-planner skill
llopresto87/cypress · skills/grill-planner/SKILL.md · The authoring discipline for the project's plan-of-record at docs/graph/plans/grill.md — what a worker filling any…
git:20260922.d73629d · audit A · 43 stars
holistic-editing skill
llopresto87/cypress · skills/holistic-editing/SKILL.md · The discipline for any change, fix, refactor, or review whose unit of work is larger than a trivial one-liner. Use…
git:20260915.df30567 · audit A · 43 stars
humanizer skill
llopresto87/cypress · skills/humanizer/SKILL.md · Draft or revise prose a person will read (documentation, README text, ADR and spec bodies, runbooks, pull-request…
git:20260915.df30567 · audit A · 43 stars
knowledge-graph skill
llopresto87/cypress · skills/knowledge-graph/SKILL.md · Build and maintain the project's knowledge graph — a tiered set of nodes under docs/graph/ that lets an agent load only…
git:20260917.c81f94c · audit A · 43 stars
library-wiki skill
llopresto87/cypress · skills/library-wiki/SKILL.md · Maintain a project-local, version-pinned wiki of every external dependency. Use whenever a new library is being added…
git:20260922.d73629d · audit A · 43 stars

Every file in llopresto87/cypress

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