a4e667de10
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.
56 lines
1.9 KiB
Markdown
56 lines
1.9 KiB
Markdown
# 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)
|
|
|
|
```json
|
|
{
|
|
"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 `No` → `ADR_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.
|