Menú
Create a new ADR (Architecture Decision Record). Use BEFORE implementing a big decision.
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Basado en la clasificación ocupacional SOC
Domain Engineering diagnostic — shows what the classifier decides for an objective (CMIS/DAS/profile/skills/mode). Observation-only; never mutates or blocks.
Business-driven methodology entry point — classify (intake), create/advance an Operation or Business work context, and drive the intake → operation → nested-workflow flow. Host-neutral; dry-run by default.
Workflow Navigator — shows the current phase, deliverables, and next commands for an ADR-0057 workflow. Read-only; never mutates state.
Start a focused session on one objective — locks scope, blocks opportunistic refactors.
Deterministic QA gate (ADR-0055) — run the project suite; green + complete acceptance criteria ⇒ qa-approve testing cards into conclusion; red ⇒ report (and qa-reject only attributable failures).
L6 — autonomous feature pipeline. Drives the full squad: design → implement → review → test → log. Checkpoints can be manual or automatic.
| name | source-command-new-adr |
| description | Create a new ADR (Architecture Decision Record). Use BEFORE implementing a big decision. |
Use this skill when the user asks to run the migrated source command new-adr.
Create a new Architecture Decision Record for: $ARGUMENTS
node contextkit/tools/scripts/adr-digest.mjs --search "<key terms from the title>".
If an ADR already covers this, extend or supersede it rather than create a duplicate.0b. Deliberation gate [ADR-0070]: a strategic/architectural decision should be
argued before it hardens. Resolve the decision-deliberation area
(resolveAutonomy('decision-deliberation', config)): at grade ≥ 3 with
deliberations.active, this is debate mode — run /debate "<the decision question>" FIRST and use its synthesis as this ADR's Context (the debate offers a
pre-filled draft). At grade ≤ 2 it is a suggestion, not a block. Skip only for a
trivial/mechanical decision (no real tension). Writing the ADR itself stays
manual at every grade — the deliberation precedes the write, never authorizes it.
Find the next ADR number: list contextkit/memory/decisions/, take the highest NNNN + 1
(zero-padded to 4 digits). The 0000 meta-ADR and _TEMPLATE.md do not count as the latest
numbered decision beyond their own number.
Copy the structure from contextkit/memory/decisions/_TEMPLATE.md into a new file
contextkit/memory/decisions/<NNNN>-<kebab-slug>.md.
Fill in:
Proposed (the user accepts it later).Supersedes ADR-XXXX and update the old one's status
to Superseded by ADR-<NNNN>.Show the user the draft and ask for confirmation before marking it Accepted.
Generate the backlog from the decision [ADR-0034] — a decision with no tasks is
decorative. Once Accepted, preview the work it implies and create it:
node contextkit/tools/scripts/adr-tasks.mjs <NNNN> # preview (dry-run)
node contextkit/tools/scripts/adr-tasks.mjs <NNNN> --write # create, tagged source: adr:NNNN
It parses the Decision points into backlog tasks (auto-classified, ADR-tagged).
Review the preview, prune/merge as needed, then --write. The tasks then flow
through the pipeline (/pipeline start → working → conclusion on accepted criteria).
ADRs are immutable once Accepted — to change a decision, write a new ADR that supersedes it.
Never delete or rewrite an accepted ADR.