rite-quick

Express lane for a small reversible change: typo/copy/config, rate-limit constant, error message, local variable rename, feature flag, README link, one-file/function fix.

SKILL.md

GitHub
<!-- loads: {"always":["devrites-lib/reference/standards/core.md","devrites-lib/reference/standards/definition-of-done.md","devrites-lib/reference/orchestration-profiles.md"],"triggers":{"coding":["devrites-lib/reference/standards/coding-style.md"],"testing":["devrites-lib/reference/standards/testing.md"],"errors":["devrites-lib/reference/standards/error-handling.md"],"security":["devrites-lib/reference/standards/security.md"],"principles":["devrites-lib/reference/standards/principles.md"],"afk":["devrites-lib/reference/standards/afk-hitl.md"]},"workspace":["state.md"],"rootOnly":["devrites-lib/reference/orchestration-profiles.md","devrites-lib/reference/standards/afk-hitl.md"]} -->

Read-set manifest: devrites-engine context <slug> --phase quick bundles every file named below into one deduplicated read. Trigger names map to the conditional rules in the sections that follow.

/rite-quick: express lane for small changes

The full DevRites lifecycle is right for real features; it is ceremony for a typo, a copy tweak, a one-function fix, or a small config change. /rite-quick keeps the discipline that matters (idiom, TDD, evidence, escape-to-full-lifecycle) and drops the artifacts that don't, in a single pass. Senior-engineer "right step, right time" made executable, not advisory. This lane uses the Quick depth profile from devrites-lib/reference/orchestration-profiles.md.

The significance gate (the whole safety story)

Run this first. If ANY of these holds, STOP and route to /rite-spec. Do NOT use the express lane:

  • Touches auth / authz, a data migration, a public API contract, or any destructive / data-loss path in the irreversible-risk list. See ../devrites-lib/reference/standards/afk-hitl.md.
  • Spans more than one vertical slice, or more than a couple of files of real logic.
  • Ambiguous scope: you'd have to guess what "done" means, or the ask hides a design decision (data model, new dependency, second design system).
  • Security-sensitive input handling, or a measurable performance-critical path.
  • Would break a declared project principle (.devrites/principles.md) with no recorded, human-approved exception: the express lane never relaxes a project gate; a needed exception is a deliberate human decision, so route it to /rite-spec.

If none hold, the change is small + reversible + unambiguous → proceed. When in doubt, escalate: the cost of the full lifecycle on a small change is minutes; the cost of the express lane on a risky one is the failure mode the lifecycle exists to prevent.

Rules consulted (read on demand from .claude/skills/devrites-lib/reference/standards/)

Load this lane's conditional standards when needed:

  • coding-style.md: naming, guard clauses, reuse-first.
  • testing.md: TDD, completeness (every touched behavior/element asserted) + assertion strength (no tautological tests; see it fail first), scaled to the change.
  • error-handling.md / security.md: only if the change touches input/errors.
  • principles.md: when .devrites/principles.md exists; a change that breaks an invariant is a gate, not a quick fix.
  • definition-of-done.md: standing Done bar: acceptance mapped, fresh proof, no open hard gates, scoped edits, rollback/docs where needed.

Workflow

  1. Orient. Read core.md. If a .devrites/ workspace is active, read its state.md directly; /rite-quick does not require a workspace and does not create the full tree.
  2. Significance gate (above). Fail → STOP, tell the user to run /rite-spec <feature>. If the only failing item is size (more than one slice) and no risk item holds, name /rite-fast <task> as the lighter option.
  3. One-line contract. Restate in 1-3 lines: the change, its acceptance (how you'll know it works), and the scope boundary (what you will NOT touch). This is the entire "spec + plan" for a quick change: keep it in the chat; optionally drop a brief.md + evidence.md under an unused .devrites/work/<slug>/ (no state.md; not a workspace cursor) if the user wants a record. This is the /rite-frame FRAME move: if the acceptance won't reduce to a check that could be false, the ask is ambiguous → escalate per the significance gate. Its AUDIT pass is the diff self-review in step 5.
  4. Build with TDD. Failing test first when behavior changes (see it fail for the right reason) → smallest complete change in the project's idiom (reuse before you write, anti-AI-slop) → cover every touched behavior / interactive element with a real assertion. UI → check the states + a browser glance. The root never edits source/tests: dispatch exact devrites-slice-wright with an exact-path contract per wright-dispatch.md § Standalone correction and the source-writing boundary; reject any returned path outside it.
  5. Prove (scoped). Run the targeted tests + typecheck / lint for what changed (not the whole suite) → green. Record the command + output — resolve the project's real typecheck/lint commands with devrites-engine detect commands rather than guessing. Engine missing or erroring, or zero detected commands for the changed surface: stop with unproven: <what could not run>, never green and never a guessed command. A tautological test that can't fail is not proof.
  6. Review-lite + ship. Self-review the diff for correctness, scope, and idiom. If .devrites/principles.md exists, confirm that no declared invariant is broken. This is /rite-frame's AUDIT pass: one pass, no subagent fan-out. Show the diff. A change that belongs to the active feature's candidate is not committed here: append its exact paths to touched-files.md, then route to /rite-prove → /rite-review → /rite-seal (/rite-ship needs Seal GO). Otherwise, on the user's confirm, commit it standalone (Conventional Commits, atomic). Never push without the user asking.

Escalation (mid-flight): the Spec Drift Guard still applies

If the "small" change turns out to be not small: a second slice appears, a real design decision surfaces, scope grows past the boundary, or you hit an irreversible-risk item: STOP, say so, and route to /rite-spec / /rite-define. Don't quietly grow a quick fix into an unreviewed feature; that's the exact drift the lifecycle guards against.

If the quick boundary does not hold or an escalation remains, use Stopped / blocked and route to the full lifecycle; do not render Done.

DO NOT use this lane to dodge the gate: the express lane is for changes that are genuinely small, not for shipping risky work faster.