engineering-place-guardrails
Decide where a guardrail belongs so a mistake is prevented by the cheapest layer that can carry it: the codebase itself (API design, architecture, refactoring), then static analysis (types, compilers, lints, tests, CI), then verification (formal, property, runtime), then prose (rules, skills, AGENTS.md), and only last human review. Walks a proposed rule or a recurring mistake down that pyramid, stops at the first layer that can hold it, and reports what to build there plus what prose or review can be deleted once it lands. Use when someone wants to add a rule to AGENTS.md, CLAUDE.md, a skill, a style guide, or a review checklist; when the same review comment or agent mistake keeps coming back; when auditing an instructions file that keeps growing; when asking 'how do we stop agents from doing X', 'should this be a lint', or 'where should this convention live'. Do not use for choosing a specific lint tool's configuration, writing the test itself, or general code review.
Pinned to revision cee7253451a5, so it is the text this page describes rather than whatever the author pushed since.
Pre-approved tools experimental
Experimental field. Support varies between clients, so this list is what the author declared, not what your client will enforce.
- AskUserQuestion
- Read
- Write
- Bash
Files
- skills/engineering-place-guardrails/SKILL.md
- skills/engineering-place-guardrails/references/layers/codebase.md
- skills/engineering-place-guardrails/references/layers/human-review.md
- skills/engineering-place-guardrails/references/layers/prose.md
- skills/engineering-place-guardrails/references/layers/static-analysis.md
- skills/engineering-place-guardrails/references/layers/verification.md
- skills/engineering-place-guardrails/references/review/audit-instructions.md
- skills/engineering-place-guardrails/references/review/report-template.md
Every link opens the file at its source, pinned to the revision this page describes.