rating-change-risk
Picks Quick, Standard, or a stronger human-reviewed mode based on consequence, how easy it is to undo, and how much is unknown. Use when you start a change to code, docs, dependencies, AI power, releases, or public claims and the right level of care is unclear. Do not use for a tiny easy-to-undo edit with obvious proof, which is Quick by default, or for a purely administrative reversible edit crossing no trust boundary, which needs no packet at all.
FlyFission · Static checks on file
Installation
Read the source and dependencies before running a command. Copying does not install or execute anything.
npx skills add FlyFission/nuclear-grade-context-engineering --skill rating-change-riskAbout this skill
name: rating-change-risk description: Picks Quick, Standard, or a stronger human-reviewed mode based on consequence, how easy it is to undo, and how much is unknown. Use when you start a change to code, docs, dependencies, AI power, releases, or public claims and the right level of care is unclear. Do not use for a tiny easy-to-undo edit with obvious proof, which is Quick by default, or for a purely administrative reversible edit crossing no trust boundary, which needs no packet at all.
Rating Change Risk
Overview
Sort the change before you build it. That way the care you take matches the stakes and the evidence the change needs. The result is a mode choice, tied to the decision question, what the change must prove, and the triggers to escalate. Choosing the mode is how Nuclear-grade tailors rigor to stakes — the same idea project-management practice calls tailoring; see docs/02-operating-system/risk-tiers-and-modes.md. Mode is about how much rigor; it is orthogonal to the work type (greenfield, brownfield, defect-fix, or refactor-migration), which is classified upstream in questioning-attitude and shapes which questions you ask. See docs/02-operating-system/work-type-lens.md. The archetype classified there sets a floor under the mode you pick (see docs/02-operating-system/archetype-lens.md); if the archetype shifts mid-change -- the prototype someone decides to ship -- re-grade, because the stakes moved even though the diff did not.
Decision contract
- Claim checked: the chosen mode matches the stakes -- Quick only for local, easy-to-undo, easy-to-prove work that adds no new trust boundary, and Standard or stronger once consequence, exposure, reversibility, detectability, unknowns, or agent power cross the line -- and the proof that mode owes is named.
- Artifact observed: the request/diff, the files/dependencies/credentials/APIs/users touched,
activation-thresholds.md, and any priorrisk.md-> the mode, decision question, evidence bar, required files, proof command or gap, and escalation triggers inrisk.md. - Decision affected: block -- the mode (Quick / Standard / stronger) and the evidence obligation that mode sets.
- Failure class: underrated-mode (a mode picked from effort, not stakes, weaker than the obvious consequence).
- Next action: raise the mode to fit the stakes; escalate when money, sensitive data, irreversible actions, autonomous tools, or release readiness are involved.
When to Use
- A change request is new, vague, or has grown.
- You know the decision question, but the evidence bar is unclear.
- A pull request has AI-generated code, tests, docs, prompts, or release files.
- Reviewers disagree on whether Quick evidence is enough.
- The work is routine, by-the-book, new, interrupted, resumed, handed off, or high stakes, and you need the right habit to control it.
When Not to Use
- A change record already has a fresh mode choice and the scope has not changed.
- The system is failing right now and needs incident handling first.
- The change is purely administrative, instantly reversible, and crosses no trust boundary -- that is the administrative floor (no packet; the commit message is the record), not a mode to rate.
- The mode is already chosen and you now need to author or update the packet files -- use
creating-change-recordsinstead.
Inputs
- The user request, issue, pull request, or diff.
- The files, dependencies, prompts, data, credentials, APIs, release files, and users the change affects.
docs/02-operating-system/activation-thresholds.md.- The change record's
risk.md, if one exists.
Process
Screen for the administrative floor first. If the change is purely administrative, instantly reversible, and crosses no trust boundary -- a typo, a comment, formatting, a dead-link fix, a doc-only bump -- it needs no packet; the commit message is the record. Any tripwire (auth, data, a dependency, a model or prompt, agent authority, CI or .github/, a release, a baseline, or claim-bearing public wording -- a non-claim typo or dead-link fix in public docs does not by itself count), or a reviewer needing more than the commit, makes it at least Quick. When in doubt it is Quick, not the floor.
- Restate the decision question and the evidence bar it needs. Grade the change itself, not the standing item it touches -- a routine file can receive a high-stakes change (auth, payments, an irreversible migration); take the higher of the two.
- Judge the dominant three first -- consequence, how easy it is to undo, and how much is unknown -- then pull in who is exposed, how easily a failure would be caught, dependency trust, and how much power the agent has only if one of the three is unclear or a trap surface fires. Weigh them together: an easy-to-undo, known-pattern change is not high-rigor even at high consequence. Raise the mode when the affected component carries a live deficiency, a recent incident, or recurring escaped defects -- past performance is part of the stakes. Derive the grade in two directions so it is defensible, not asserted from effort: top-down (the worst credible outcome this could cause) and bottom-up (if this specific edit fails, what breaks).
- Name the work mode: routine, known procedure, new or uncertain, interrupted or resumed, or a critical action.
- Apply the archetype floor before choosing. The posture named in
questioning-attitudesets a floor the mode cannot go under: Sweeper and Builder start at Standard, Maintainer at Nuclear on trust-bearing surfaces, and a Prototyper's low floor holds only while shipping is an explicit non-goal. Going under a floor needs a stated reason, not silence. If the archetype shifted mid-change -- the prototype someone decided to ship -- re-grade from the new posture, because the stakes moved even though the diff did not. Seedocs/02-operating-system/archetype-lens.md. - Choose Quick only for local, easy-to-undo, easy-to-p