Enforce FIRST

SkillDev tools

Checks your code's automated tests against the F.I.R.S.T quality rules and fixes ones that fail.

Available today. Use it from your connected AI after setup.

Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

Then ask your AI: use the Enforce FIRST skill

About this skill

Apply the F.I.R.S.T test quality rubric (per CONVENTIONS.md §Tests) to a test suite or individual tests. Use when develop-tdd is writing tests, when test quality needs to be checked, or when user mentions F.I.R.S.T or "test quality".

What this skill tells your AI

The instructions your AI receives, as published by danielvm-git/bigpowers in skills/enforce-first/SKILL.md and read by ahel’s review.

HARD GATE — HARD GATE — Before shipping, ALL enforcement checks must pass: lint, typecheck, tests, coverage gates. Do NOT disable or skip checks to get to green.

Apply the F.I.R.S.T rubric per CONVENTIONS.md §Tests to evaluate and improve tests.

This skill is typically invoked internally by develop-tdd during the test-writing phase. It can also be run standalone on an existing test suite.

Modes

  • Default: full F.I.R.S.T audit (all 5 criteria)
  • --quick: Check Fast, Independent, and Self-Validating criteria only (per CONVENTIONS.md §Tests). Used by build-epic step 6 as a mechanical gate after audit-code. Skips Repeatable and Timely which require contextual judgment.

The F.I.R.S.T Rubric

See CONVENTIONS.md §Tests for the canonical F.I.R.S.T rubric definition, checklists, and fix patterns.

Mechanical self-check (runs before reporting audit complete):

grep -q '## Tests (F.I.R.S.T' CONVENTIONS.md
grep -qE 'Fast|Independent|Repeatable|Self-Validating|Timely' CONVENTIONS.md

Each criterion must be explicitly addressed in the audit report with pass/fail per test file reviewed.

Applying the rubric

For each failing criterion:

  1. Identify which tests violate it
  2. Describe the fix
  3. Apply the fix
  4. Re-run the suite to confirm it still passes

Report: "F.I.R.S.T audit complete. X criteria passed, Y fixed."

Verify

→ verify: grep -q '## Tests (F.I.R.S.T' CONVENTIONS.md && grep -qE 'Self-Validating|Repeatable' skills/enforce-first/SKILL.md && echo OK

Signals

GitHub stars
248
Forks
19
Last commit
Sep 2026
Advanced
Item type
skill
Key
enforce-first
Source
github.com/danielvm-git/bigpowers