KeiSeiKit-1.0/skills/docs-scaffold/phase-3-decisions.md
Parfii-bot 0be354a920 KeiSeiKit-public — clean state
Single-commit clean baseline after security scrub of niche-tells,
project codenames, internal jargon, and contributor-email leaks.

Contents:
- 100 Rust crates (_primitives/_rust/)
- 37 agent manifests (_manifests/) + generated specs (_generated/)
- 67 user-invocable skills (skills/)
- 33 hooks (hooks/)
- Composition blocks (_blocks/)
- Documentation (docs/, README.md)
- TS adapter packages (_ts_packages/)
- Assembler (_assembler/)
- Roles (_roles/)
- Templates (_templates/)
- Forgejo CI (.forgejo/)

Author: Denis Parfionovich <info@greendragon.info>

License: see LICENSE.
2026-05-01 12:09:03 +08:00

1.9 KiB

Phase 3 — First ADR walk-through (optional)

Goal: if DECISIONS.md was just scaffolded, offer to append one real ADR now while context is fresh. Otherwise skip.

3a — Gate (AskUserQuestion #3)

{
  "questions": [
    {
      "question": "Append a real ADR now?",
      "header": "ADR",
      "multiSelect": false,
      "options": [
        {"label": "Yes — walk me through ADR-002",   "description": "Interactive: I ask context / drivers / options / outcome; I write the entry"},
        {"label": "No — keep the template only",    "description": "Phase 2 already wrote ADR-001 Constructor Pattern template; leave it"},
        {"label": "Skip this phase",                 "description": "Move to Phase 4 diagrams"}
      ]
    }
  ]
}

On Skip or NoADR_N = 0, continue to Phase 4.

3b — Free-text elicitation (only if "Yes")

Ask the user, in a single message (no AskUserQuestion), for four lines:

  1. Title (≤ 60 chars) — short decision name
  2. Context (1-2 sentences) — what forced the decision
  3. Options considered — comma-separated list (2-4 items)
  4. Chosen option + evidence grade [E1-E6] — one line

3c — Compose the ADR entry

Renumber: Read DECISIONS.md, find the highest existing ADR-NNN, assign NNN+1 (three-digit zero-pad). Append the block using the MADR 4.0 shape from _blocks/docs-decisions-adr.md. Never rewrite existing ADR entries. Never drop below the highest existing number.

Set ADR_N = 1.

3d — Show the user the appended block

Print the new entry inline so they can confirm correctness. No AskUserQuestion here — they can ask to amend in the next turn. Append- only invariant stands: amendments become ADR-MMM that supersedes.

Verify-criterion

  • DECISIONS.md exists at <DIR>/DECISIONS.md.
  • The new ADR number is strictly greater than all prior numbers.
  • Evidence grade is one of E1-E6; if missing, re-ask before writing.
  • No existing ADR entry was modified.