adr-to-guardrail

Turn a new or changed ADR into implemented behavior, routing docs, tests, and guardrails rather than leaving it as standalone prose.

Aller à l'installation

Dépôt: clawic/Clawix
Dernière activité de la source: 23 mai 2026 à 00:03
Langue détectée de SKILL.md: anglais
Étoiles: 8
Forks: 0

Options d'installation

Le prompt qui vérifie d'abord la source est sélectionné par défaut. Vous pouvez passer à une commande directe ou télécharger une copie locale.

Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.

Une commande directe contourne le prompt de vérification. Examinez la source avant de l'exécuter.

npx skills add https://github.com/clawic/Clawix --skill adr-to-guardrail

La commande reste sur une seule ligne. Faites défiler horizontalement pour la vérifier avant de la copier.

Vous préférez une copie locale ? Téléchargez les fichiers actuellement disponibles dans SkillsMP.

Vérifiez les fichiers source

Lisez SKILL.md et les fichiers associés affichés par SkillsMP avant de décider de l'installer.

SKILL.md

Instructions source · Aperçu en lecture seule

Retour à la recherche Retour à l’installation

macos-ux-trace-harness

Run or change the macOS UX trace harness for action-to-visual-completion latency, scroll stability, fixture pressure, and baseline evidence.

2026-05-26

ui-performance-budget

Capture and compare Clawix UI performance budgets for critical flows before optimizing visible or runtime UI behavior.

2026-05-26

canonical-catalog-expansion

Add or improve canonical data catalog collections, fields, aliases, relations, evidence tags, docs, and tests.

2026-05-25

Tout voir dans ce dépôt

adr-to-guardrail

Make an ADR operational.

Procedure

Reserve the ADR number with scripts/adr-reserve.mjs before drafting a new ADR. Read the ADR template and the closest accepted ADRs before changing an existing decision.

State the decision in implementation-neutral terms and fill Decision Tensions for durable architecture, governance, data, security, agent, interface, route, storage, public-surface, or validation-policy changes.

Fill surface parity: human surface, programmatic surface, persistence, gaps, and validation.

Update docs/decision-map.md or the equivalent project router with the new decision and its guardrail.

Register durable meta-code in docs/discoverability.registry.json per docs/adr/0017-discoverability-and-meta-code-routing.md; do not add hidden ADRs, guardrails, harnesses, docs routers, or skills.

For every accepted ADR, satisfy scripts/adr-operational-coverage-check.mjs: decision-map row, discoverability entry, guard/test route, human surface, programmatic surface, persistence, CLI search, and CLI inspect. A doc-only decision needs a scoped expiring public exception in docs/adr-operational-coverage-exceptions.json.

Update affected docs, registries, manifests, CLI inspection/search output, and tests so agents can discover and enforce the decision.

Refactor implementation only as far as needed to make the ADR true for the intended batch.

Apply the Problem-to-Guardrail loop for any defect found while drafting or implementing: record the puntual problem, general class, existing rule, and close with guard/test añadido, ADR/regla añadida, or deuda explícita con expiry.

Enforce the anti-loop rule: if the work adds 2 ciclos seguidos of ADRs, ledgers, manifests, guards, or baselines sin reducir blockers reales, stop and classify the closure as blocker directo, deuda lateral, or pendiente externo; no más gobernanza para arreglar exceso de gobernanza.

Before closure, run node scripts/discoverability-check.mjs closure --changed-file <path> --json for the changed ADR, decision map, registry, or skill. The closing report must cite the real claw search ... --json and claw inspect ... --json evidence and the discovered artifact, or mark the work PARTIAL/BLOCKED.

Record pending guardrails or migrations explicitly when full enforcement cannot land now.

Constraints

An ADR is incomplete if it is not linked from the relevant routing surface.

Do not invent ADR numbers manually; docs/adr/reservations/NNNN.json is the durable reservation record.

Do not accept "doc only" for a decision that changes stable behavior.

Do not mark an ADR accepted while scripts/adr-operational-coverage-check.mjs fails.

Do not close a canon-changing ADR as complete when claw search or claw inspect cannot discover the changed artifact.

Do not close a detected problem with only "fixed"; leave a guard/test, ADR/rule, or expiring debt.

Do not add governance to fix excess governance after 2 ciclos seguidos sin reducir blockers reales; stop as blocker directo, deuda lateral, or pendiente externo.

Do not preserve accidental pre-public legacy unless an ADR explicitly grants a bounded exception.