decision-criticality-gate
Skill0 starsChanged 3 months agoApache-2.0View on GitHub
Classifies architecture, product, data, security, and agent-action decisions by reversibility, blast radius, trust impact, likelihood, severity, and detectability. Use before implementation, before autonomous tool execution, and whenever a decision could affect users, money, privacy, permissions, production systems, or shared foundations.
In this repository46 other files it gives its agents.
- AGENTS.mdAGENTS.md
- academixSkill
- agent-browserSkill
- ai-engineering-platformSkill
- apocalypseSkill
- aria-apg-reviewSkill
- context-budgetSkill
- crawler-readiness-auditSkill
- data-protection-gateSkill
- fact-checkerSkill
- find-skillsSkill
- focus-friendly-outputSkill
- frontend-designSkill
- grill-meSkill
- grill-with-docsSkill
- humanizerSkill
- improve-codebase-architectureSkill
- microsoft-foundrySkill
- output-templatesSkill
- pre-launch-security-gateSkill
- prompt-preflightSkill
- quick-recapSkill
- rag-retrieval-qualitySkill
- rest-api-best-practicesSkill
- rigorous-responseSkill
- security-checklistSkill
- shepherdSkill
- skill-optimizerSkill
- sql-query-correctnessSkill
- system-design-scaleSkill
- tddSkill
- ui-ux-color-contrastSkill
- ui-ux-component-qualitySkill
- ui-ux-design-systemsSkill
- ui-ux-dropdownsSkill
- ui-ux-form-validationSkill
- ui-ux-generationSkill
- ui-ux-loading-statesSkill
- ui-ux-mobile-cssSkill
- ui-ux-typographySkill
- ux-logic-loopSkill
- ux-pattern-reviewSkill
- vercel-react-best-practicesSkill
- visual-flow-storyboardSkill
- visual-pr-reviewSkill
- web-design-guidelinesSkill
The file
We split this skill into the rules it gives an agent
7 rules. About 0 are common, 7 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈7
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 58
Use this skill for architecture choices, product decisions, data changes, security-adjacent changes, and any agent action that could affect …
- Distinctive: line 154
ask before externally visible destructive execution.
- Distinctive: line 173
must not execute destructive, externally visible, or permission-changing actions without approval.
- Distinctive: line 219
When this skill triggers, produce:
- Distinctive: line 228
If evidence is missing, say so plainly and label the assumption.
- Distinctive: line 232
Do not spend equal effort on every decision.
- Distinctive: line 241
Keep the level, score rationale, hard escalation, required process, and next gate explicit.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Decision Criticality Gate
Purpose
Classify how careful a decision must be before the agent acts.
Use this skill for architecture choices, product decisions, data changes, security-adjacent changes, and any agent action that could affect users, money, privacy, permissions, production systems, or shared foundations.
This skill does not decide whether an idea is good. It decides:
- how hard the decision is to reverse,
- how wide the impact is,
- how much trust it affects,
- how likely failure is,
- how severe the failure would be,
- how easy failure would be to detect,
- whether the agent may act autonomously.
Core Rule
The harder a decision is to reverse, the wider its blast radius, and the more trust it can damage, the stronger the required review and safeguards.
Score Every Dimension
Score each dimension from 0 to 2.
1. Reversibility
0easy to reverse1costly to reverse2difficult or effectively irreversible
2. Blast Radius
0isolated1multi-component2system-wide
3. Trust Impact
0low trust sensitivity1moderate trust sensitivity2high trust sensitivity
4. Likelihood
0hypothetical1plausible2likely or observed
5. Severity
0minor1significant2critical
6. Detectability
0immediately visible1delayed or indirect2silent or difficult to detect
Score
criticality_score = reversibility + blast_radius + trust_impact + likelihood + severity + detectabilityMaximum score: 12.
Risk Levels
Level 1
Score 0-3.
Default controls:
- proceed normally,
- standard tests,
- normal code review,
- basic observability.
Autonomy:
- allowed inside existing permissions.
Level 2
Score 4-6.
Default controls:
- short implementation plan,
- acceptance criteria,
- rollback path if practical,
- relevant automated tests,
- post-change verification.
Autonomy:
- may implement reversible internal actions,
- ask before externally visible destructive execution.
Level 3
Score 7-9.
Default controls:
- ADR or equivalent decision note,
- specification covering scope, out-of-scope, and interfaces or contracts,
- acceptance criteria the implementation must satisfy,
- alternatives analysis,
- rollout and rollback plan,
- testing evidence,
- named human reviewer.
Autonomy:
- may analyze, design, and prepare changes,
- must not execute destructive, externally visible, or permission-changing actions without approval.
Level 4
Score 10-12.
Default controls:
- architecture review,
- security review where relevant,
- human approval,
- least-privilege enforcement,
- no autonomous execution,
- explicit approval for the exact action, scope, target, and expected effect.
Hard Escalation Rules
Force at least Level 3 if the decision:
- modifies authentication,
- modifies authorization,
- changes tenant isolation,
- handles secrets or credentials,
- changes production data ownership,
- introduces a new externally accessible endpoint,
- sends customer-facing communication automatically,
- changes public API contracts,
- performs bulk data migration,
- introduces new AI agent tool write access.
Force Level 4 if the decision:
- enables cross-tenant data access,
- moves money,
- accepts a binding contract,
- deletes data irreversibly without verified recovery,
- escalates permissions autonomously,
- deploys to production across the full system autonomously,
- discloses sensitive or regulated information,
- changes core auditability,
- disables security controls,
- executes untrusted input,
- could materially harm a person or organization.
Agent Output
When this skill triggers, produce:
- the score for each dimension,
- the total criticality score,
- the resulting level,
- the required controls,
- any hard escalation rule that applies,
- the minimum safe next step.
If evidence is missing, say so plainly and label the assumption.
Operating Rule
Do not spend equal effort on every decision.
Move quickly on low-risk, reversible choices.
Slow down when the decision is irreversible, system-wide, trust-sensitive, severe, likely, or hard to detect.
Shared output profile
Compose the decision profile from output-templates.
Keep the level, score rationale, hard escalation, required process, and next gate explicit.
Preserve stricter domain rules above, omit empty components, and never fill a component with invented evidence.
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.

