decision-guard
Skill4 starsChanged 31 days agoMITView on GitHub
Use when an AI agent is deriving metrics or complex explanations while a direct answer may exist, choosing a software architecture or technology stack, or making consequential technical decisions with long-term operational costs and uncertain assumptions. Do not use for narrow, fully specified implementation or routine bug fixes.
In this repository47 other files it gives its agents.
- AGENTS.mdAGENTS.md
- anti-slop-engineeringSkill
- anti-slop-engineeringSkill
- api-ergonomics-and-contract-governorSkill
- apple-craft-and-frame-budgetSkill
- apple-craft-and-interaction-physicsSkill
- asset-provenance-guardSkill
- backprop-guardSkill
- chaos-and-degradation-choreographerSkill
- chromatic-drift-guardSkill
- cognitive-load-and-attention-governorSkill
- comment-budget-guardSkill
- context-window-and-token-economics-architectSkill
- cryptographic-agility-and-secret-lifecycle-gateSkill
- demock-guardSkill
- design-system-drift-guardSkill
- deterministic-simulation-and-property-testingSkill
- distributed-consensus-and-concurrency-gateSkill
- finops-and-unit-economics-governorSkill
- future-scale-gateSkill
- grumpy-senior-staff-engineerSkill
- honeypot-trap-guardSkill
- house-tell-guardSkill
- install-anti-slopSkill
- llm-eval-and-prompt-injection-fortressSkill
- mandela-guardSkill
- mechanical-sympathy-and-perf-gateSkill
- mechanical-sympathy-profilerSkill
- motion-runtime-guardSkill
- observability-and-slo-architectSkill
- observability-and-slo-gateSkill
- paranoid-principal-architectSkill
- pr-boundary-guardSkill
- privacy-and-data-lineage-gateSkill
- re0-handoff-guardSkill
- reduction-guardSkill
- repo-memory-and-invariant-stewardSkill
- root-fix-gateSkill
- safe-evolution-and-rollout-choreographerSkill
- scientific-fault-isolationSkill
- styleseed-guardSkill
- supply-chain-and-sbom-sentinelSkill
- tagore-guardSkill
- type-level-and-ast-slop-gateSkill
- ui-and-copy-disciplineSkill
- verification-oracle-architectSkill
- zero-downtime-migration-gateSkill
The file
We split this skill into the rules it gives an agent
6 rules. About 0 are common, 6 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈6
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 30
Do not use this Skill to override a signed constraint, silently change an authorized roadmap, or block routine work with speculative …
- Distinctive: line 35
Observed before derived: Search available authoritative sources and native capabilities for a directly observable answer before designing …
- Distinctive: line 39
Future is a scenario, not a fact: Test migration, failure, growth, maintainability, exit cost and recovery conditions without invented …
- Distinctive: line 40
Interrupt on material discovery: If a verified direct answer or decision-changing constraint appears, stop unnecessary work and show the …
- Distinctive: line 80
[Decision method](references/decision-method.md): Read in full before architecture comparisons or conflicting evidence classification.
- Distinctive: line 81
[Decision record](references/decision-record.md): Read in full before writing or validating a persistent decision.
≈ “Common” is an estimate: at least 1 in 5 of the 372,429 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 Guard
Find the direct answer, challenge the premise, then defend the smallest credible decision over its useful lifetime.
Why This Skill Is Needed & Target State
Agents can execute a flawed plan with impressive local correctness: derive a value already exposed directly, accept the user's solution as the problem, or default to a familiar framework-host-database bundle without examining operational consequences. Repeated agreement and earlier investment do not establish that the premise is sound.
The target is an interruption-capable decision process grounded in checked sources, independent alternatives, explicit reversibility, and conditional recommendations. It may conclude that no new implementation is needed. It must never imply that a completed checklist proves the choice is correct.
Activation and boundaries
| Situation | Behavior |
| Complex inference, simulation, or metric derivation | Run the direct-observation path before constructing a proxy |
| Framework, infrastructure, database, vendor, or data-boundary selection | Compare independent architectural axes and future stress conditions |
| Long-running project reveals evidence that undermines its original premise | Reopen the decision; do not defend sunk cost |
| Existing, approved implementation and no new material evidence | Continue normal execution; avoid recurring decision theater |
| Small bug, agreed specification, or reversible local refactor | Do not activate; use Anti-Slop Engineering BUILD/FIX gates |
Do not use this Skill to override a signed constraint, silently change an authorized roadmap, or block routine work with speculative hypotheticals. If a consequential recommendation conflicts with user authority, report the evidence and seek a decision rather than changing course unilaterally.
Invariant Rules
- Goal before method. Restate the wanted result separately from the user's proposed technique.
- Observed before derived. Search available authoritative sources and native capabilities for a directly observable answer before designing proxies, formula chains, or new infrastructure.
- Evidence types stay distinct. Label observed, derived, inferred, and unavailable claims. An inaccessible source is not a negative finding.
- No default-stack bundles. Evaluate rendering, runtime/jobs, hosting, persistence, and operations separately when they are material. No framework mandates its most-associated host.
- No reverse dogma. Neither popular managed platforms nor VPS/self-hosting win by default. Compare total ownership burden and credible future states.
- Future is a scenario, not a fact. Test migration, failure, growth, maintainability, exit cost and recovery conditions without invented forecasts.
- Interrupt on material discovery. If a verified direct answer or decision-changing constraint appears, stop unnecessary work and show the evidence, even after substantial prior investment.
- Protect authority. A recommendation is not an authorization to deploy, migrate data, buy services, or alter protected decisions.
- No mechanical truth claims.
decision_guard.pyverifies record completeness only; independent source review and domain tests remain mandatory.
Decision router
| Evidence state | Required action | Exit condition |
| Direct answer found and semantics verified | Recommend direct use; identify redundant work | User accepts the revised plan or retains the old one explicitly |
| Potential direct source not inspected | Inspect it using available read/search/query tools | Evidence found, disproved, or marked unavailable |
| Source unavailable or conflicting | Record unknown, competing hypotheses, next probe | Pause consequential commitment; do not manufacture certainty |
| Architecture options materially differ | Decompose axes and compare two serious choices | Trade-offs, constraints, reversal and future stress are visible |
| Strong contract or regulation excludes a candidate | Eliminate that candidate, explain the authority | Remaining candidates satisfy hard constraints |
| No meaningful choice or only routine reversible work | Hand back to parent BUILD/FIX | No unnecessary decision packet |
Execution Workflows
- Investigate for direct answers, metrics, hidden data, assumptions and path dependence.
- Architect for tech-stack, vendor, infrastructure and multi-year lifecycle decisions.
At the start of either workflow, inspect the repository or data inventory, the user goal and the decision authority. Use tools available in the host; do not assume browsers, credentials, or remote environments exist.
Mandatory reassessment triggers
Reopen only when new evidence changes a critical assumption, a credible simpler option appears, a target constraint changes, an option fails a critical proof, or a project's operating conditions cross the recorded revisit trigger. Do not ask for repeated reevaluation on every ordinary edit.
Output and verification
Present the decision in this order:
- Goal and current recommendation: one sentence each, including
proceed,pause, orstop. - Direct-path result: observed finding and source, or exact unknown and next probe.
- Options: viable alternatives and meaningful differences; separate architecture axes when relevant.
- Reasoning boundary: facts, assumptions, operational owner, downside, reversibility, stress/revisit trigger.
- Handoff: what can execute, what requires user authority, and what evidence remains unverified.
When the decision is consequential or likely to be revisited, save a JSON decision record following record contract. Audit it with npx anti-slop-engineering decision audit <record.json> --json (or python3 scripts/decision_guard.py audit <record.json> --json from the repository root). Exit 0 means structurally complete, exit 2 means incomplete; neither proves the underlying recommendation. Do not create a record for trivial tasks.
Domain References
- Decision method: Read in full before architecture comparisons or conflicting evidence classification.
- Decision record: Read in full before writing or validating a persistent decision.
Failure taxonomy
| Failure | Observable signal | Recovery |
| Premise capture | Plan accepted as the goal | Reframe objective, try direct observation |
| Source omission | Derived claim without source inventory | Check source/tool/schema/documentation |
| Context momentum | Sunk cost cited to preserve redundant work | Compare forward costs only |
| Default bundle bias | Framework, host and DB decided as one brand bundle | Split selection axes and trace constraints |
| Reverse bias | VPS/self-host or new framework assumed inherently superior | Compare ops owner, backups, support and reversibility |
| Forecast theater | Exact future pricing/load presented without evidence | Replace with scenario ranges and measurement plan |
| Ritualistic skepticism | Endless options and objections after evidence is sufficient | Decide, record invalidation triggers, resume delivery |
Delegated Skills
anti-slop-engineering: Resume BUILD/FIX/REVIEW and the Seven Gates after the choice is established.future-scale-gate: Formally model long-term operating envelopes and reversal costs for irreversible structural commitments.root-fix-gate: Trace architectural invariant ownership when deciding whether to refactor or preserve a boundary.
Completion and limits
Finish when the direct route has been checked or honestly marked unknown, consequential alternatives and constraints have been compared, the user can understand what would invalidate the recommendation, and the next permitted action is explicit. A decision can validly end in pause or stop. Behavioral evaluation scenarios live in evals/scenarios.json; they are test cases, not claims of live-model results.
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.

