gauntlet-loop
Skill1 starsChanged 3 months agoMITView on GitHub
Run a bounded adversarial quality loop with independent critics, frozen benchmarks, repair, and retest over a real artifact. Use only when hidden-defect risk makes one direct check insufficient.
20 other projects use a version of this.
Adopted by
Most recently taken up by
- celestialdust/achilles-skillstheir own version, first seen Nov 1, 2026
- rubenmarcus/agent-skillstheir own version, first seen Nov 1, 2026
- mblanc/mb-skillstheir own version, first seen Oct 20, 2026
- harshsinghmp/muse-skillstheir own version, first seen Oct 15, 2026
- sreejithraman/SreeStacktheir own version, first seen Oct 15, 2026
- AVANT-ICONIC/skillstheir own version, first seen Oct 13, 2026
Used with
Projects with it also use codebase-design and code-review.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
GoogleSkillcodebase-design
Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable or AI-navigable, or when another skill needs the deep-module vocabulary.
Also in 3 projects that use this
GoogleSkillcode-review
Adversarial systems, concurrency, memory-model, and architecture code review protocol. Use this skill whenever asked to review code, PRs, diffs, or branches in Filament.
Also in 4 projects that use this
Other versions20 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 20
- duolahypercho/gauntlet-loop★ 157same name
- emaraschio/cursor-commands★ 9same name
- sidneyswift/skills★ 9same name
- NicholasSpisak/gauntlet-loop★ 4same name
- protonspy/spec-claude-code★ 4same name
- trilwu/gauntlet-loop-skills★ 3same name
- Kohulan/orthonym-skills★ 2same name
- rubenmarcus/agent-skills★ 2same name
- alexanderpino/skills★ 1same name
- celestialdust/achilles-skills★ 1same name
10 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository24 other files it gives its agents.
- AGENTS.mdAGENTS.md
- architectureSkill
- browser-automationSkill
- cli-designSkill
- debugSkill
- experimentSkill
- get-it-doneSkill
- grillingSkill
- handoffSkill
- implementSkill
- merge-conflictsSkill
- office-filesSkill
- planSkill
- project-contextSkill
- quick-modeSkill
- releaseSkill
- researchSkill
- reviewSkill
- skill-designSkill
- teachSkill
- testSkill
- triageSkill
- wait-whatSkill
- writingSkill
The file
We split this skill into the rules it gives an agent
11 rules. 0 are common, 7 are distinctive, and 4 are very specific to this project.
0
Common
Most of the 20 edited versions we read keep these.
7
Distinctive
This author's own choices. Worth a look.
4
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 6
Use applicable ISO/IEC 25010 quality attributes, ISO/IEC/IEEE 29119-inspired traceability and ISO/IEC/IEEE 15026-2-inspired assurance cases.
- Distinctive: line 16
Lead: when primary, freeze task scope, benchmarks, standing completion bar, coverage, budget, ownership and stop decision.
- Distinctive: line 19
Prefer fresh contexts. Otherwise, mark independence reduced.
- Distinctive: line 21
Use this evidence authority order: user requirements, authoritative specifications, supplied references, required current behaviour, …
- Distinctive: line 28
Run deterministic checks. Verify that each gate observes its named outcome, can fail, and independently calculates figures.
- Very specific: line 29
Use distinct read-only lanes from CRITIC-LANES.md.
- Very specific: line 36
Use CONDITIONAL PASS only when every hard gate passed and all residuals are explicitly accepted, owned, and nonblocking.
- Very specific: line 38
Use .gauntlet/state.md, benchmarks.yaml, defects.md, and evidence/ per STATE-FORMAT.md.
- Distinctive: line 45
Use BCP 14 only for normative force.
- Distinctive: line 46
Before risky work, warn, add any needed hold point and verify the safe state.
- Distinctive: line 48
Avoid surprise scope; leave results usable or resumable.
“Common” is measured: kept by at least 6 in 10 of the 20 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Gauntlet Loop
Use applicable ISO/IEC 25010 quality attributes, ISO/IEC/IEEE 29119-inspired traceability and ISO/IEC/IEEE 15026-2-inspired assurance cases. Apply OWASP ASVS, WCAG 2.2 or AI-ASSURANCE.md only to relevant risks. The builder MUST NOT finally approve its own work.
Communication kernel
Number ordered actions; group long lists without hiding required items. After interruption or task change, restore relevant completed/current/pending state, not repetitive status each turn. Preserve language, exact tokens, formats, permissions and evidence. Never invent estimates or diagnose readers. Show verified outcomes and factual errors; give a concrete next action only if work remains. Use ASD-STE100-inspired short, active technical sentences. Use ISO 704-inspired stable concepts and terminology. Use Diátaxis to separate how-to, reference, and explanation when helpful. If trusted root AGENTS.md is loaded, its policy governs. Otherwise apply this standalone kernel. Do not claim root activation without evidence. These are prose inspirations, not claims of formal standards conformance. Domain standards apply only under their task conditions.
Composition
For a composed task, use one primary lifecycle owner: the explicit user-designated owner; otherwise selected get-it-done; otherwise the unique substantive task skill after assigning support roles. If ownership is still ambiguous, stop affected actions and report the competing claims. The named owner MUST be available, selected and loaded before composed execution; otherwise stop its dependent actions and report the missing prerequisite. Safe independent inspection may continue. Availability alone proves neither selection nor loading. Alone, this skill retains its normal ownership and status rules.
When supporting, the Lead owns the assurance benchmark, coverage and assurance stop decision within the primary owner's authorized scope, not another task lifecycle. Quick Mode can constrain optional scrutiny but MUST NOT weaken explicit criteria or suppress a blocking finding. Keep an independent FAIL or NOT JUDGED even if the owner requests success. Return the assurance verdict and evidence to the owner; the final-report instructions below apply directly only when this skill is primary.
Mandatory safety, trusted repository policy, authorization and explicit acceptance criteria take precedence over role defaults. A supporter MUST NOT claim task completion or change permissions. Preserve failed verdicts and missing required evidence in the owner's single final report; neither permits accepted completion. Presentation changes no facts, scope or verdicts.
Trigger and ownership
Run when the user requests a gauntlet/red-team or when hidden-defect risk makes a normal focused review plus one direct check insufficient. Require an artifact, evidence-judged acceptance, and at least two distinct material risks (integration, persistence, security, recovery, visual quality or costly failure). Do not use for factual questions, tiny rewrites or formatting. Each lane must address a separate gap.
- Lead: when primary, freeze task scope, benchmarks, standing completion bar, coverage, budget, ownership and stop decision. When supporting, freeze these for assurance only under the primary owner's scope.
- Builder: make bounded repairs and supply reproducible evidence. Never weaken a test or acceptance criterion.
- Critic: work read-only. Receive the goal, real artifact, benchmark, distinct charter and anti-charter—not the builder's conclusion. Judge: inspect the integrated result independently of the primary builder.
- Prefer fresh contexts. Otherwise, mark independence reduced. Record requested/actual reviewer identity, serving family if verified, context boundary and artifact inspected. Names alone do not prove independence. Claim delegation only with live evidence.
Freeze the benchmark
Use this evidence authority order: user requirements, authoritative specifications, supplied references, required current behaviour, deterministic tests, measured targets, structured rubrics, subjective judgement. For each gate, record ID, provenance, observable requirement, verifier or oracle, expected result, environment/entrypoint, threshold, status, evidence path, freshness and public/holdout class. Keep the standing Definition of Done separate. Calibrate consequential oracles with a representative broken state and a positive control. Status records do not prove execution. Record each benchmark change's reason, diff, authority and effect on prior evidence. Never weaken the benchmark to pass. Judge hard gates before soft scores. Where applicable, require both history/holdout model and integrated reality gates. Check intermediate procedural invariants. Conformance claims require verified scope. For consequential claims, record claim, evidence, assumptions/defeaters and status.
Bounded loop
- Preflight scope, permission, false-pass risks, rollback and budget. Warn before hazardous action, verify the safe starting state, and pause at the authorization boundary. Create a checkpoint and acceptance ledger. Establish baselines for the real artifact, required journeys, tests and measurements.
- Map every required slice once. Count gaps/overlap and give coupled areas one owner before fan-out. Repair the smallest useful defect. Save the changed artifact and evidence.
- Run deterministic checks. Verify that each gate observes its named outcome, can fail, and independently calculates figures. Use a known positive fixture to calibrate absence checks. Reject weak oracles before judging quality.
- Use distinct read-only lanes from
CRITIC-LANES.md. For AI/agent systems, inspectAI-ASSURANCE.mdand any current AI asset card. Distinguish outcome, full trajectory and tool-choice evidence. Separate findings from verification. Separate raw observations from inference (VERIFIED,ASSUMED,REFUTED,UNKNOWN). Give each causal hypothesis a falsifier. - Triage safety, data loss, hard gates, user blockers, correctness, regression, performance, maintainability, then polish. Repair a tight cluster. Rerun its failed gate and adjacent regression checks. Treat evidence as stale after artifact, verifier, input, environment, entrypoint, auth or dependency changes. Stop dependent steps at the first material mismatch. Revert a regression.
- Wait at real join barriers. Verify every manifest row and critic claim. Then judge the integrated artifact. Once all hard gates pass, run one focused counterexample/integration pass. Stop unless a named material gap justifies another round. Extend only with verified progress and budget. Repair a shared cause before repeating a failed wave. Disclose capped or unprocessed items.
- A fresh final judge re-executes the current critical oracles. The judge checks both claim-to-evidence and requirement-to-decision coverage. The judge inspects integration, real journeys, rollback, stray files, debug settings and secrets. Both model and reality gates pass when applicable.
Status, limits and state
Track run state ACTIVE|COMPLETE|BLOCKED|BUDGET EXHAUSTED|CANCELLED; verdict PASS|CONDITIONAL PASS|FAIL|NOT JUDGED; severity P0..P3; and disposition blocking|nonblocking plus repair state.
Mark a hard-gate failure or verified blocking defect FAIL. Mark missing required evidence NOT JUDGED unless the benchmark defines it as failure. Pair either verdict with BLOCKED or BUDGET EXHAUSTED when execution stops.
Use CONDITIONAL PASS only when every hard gate passed and all residuals are explicitly accepted, owned, and nonblocking. Treat ABANDONED, DEFERRED, or OWNER_DECISION on a required gate as non-passing. Severity alone does not decide disposition.
Unless the user sets limits, use these limits: one baseline, four major repair rounds, two consecutive no-improvement rounds, at most two builders, three critics, one tie-breaker, five critical journeys, three required visual viewports per state, and one final integration gauntlet. Reserve ~40% of delegated budget for verification/integration. Ceilings are not targets.
Use .gauntlet/state.md, benchmarks.yaml, defects.md, and evidence/ per STATE-FORMAT.md. Checkpoint after each repair round, material result, or approval gate.
For measurable work, show named 20-cell ASCII progress from durable processed items. Round down and keep progress separate from verdict. Count a failed, blocked, skipped, or untested item only when terminally classified with evidence. Never count it as passed. Without a defensible denominator, report phase and evidence without a bar.
Start the final report with verdict, run state, named coverage, hard-gate tally, and blocking findings. Then give before/after score, fresh evidence, limits, risks, rollback, and next action. Re-measure numeric claims. Label unsupported claims NOT MEASURED or UNVERIFIED. Separate observed failure from unknown cause. Own actual agent errors.
User-facing:
- Lead with the supported result, action or blocker. Report fresh verification, material uncertainty, limits and remaining user action. Omit routine tool narration and praise.
- State verified failure and evidenced responsibility directly. Correct actual agent errors or give the next safe action.
- Preserve facts, negation, uncertainty, evidence limits, permissions, quotations, requested voice and exact artefact formats. Style proves neither formal conformance nor legal authority.
- Use BCP 14 only for normative force. Important requirements name one actor, action and observable check; do not invent mandates.
- Before risky work, warn, add any needed hold point and verify the safe state. State the expected result, failure sign and recovery. Explain or contrast only when useful.
- Apply OWASP ASVS, accessibility and Easy-to-Read guidance only to relevant tasks. Easy-to-Read verification requires intended-user review.
- Avoid surprise scope; leave results usable or resumable. Keep simple replies short without truncating needed detail. Omit routine Summary headings and closing recaps. Use TL;DR only when helpful for a complex response, and place it first.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

