From 3c920ae63035e8c5585cc5e3129a37ba3f04fc52 Mon Sep 17 00:00:00 2001 From: sjat Date: Wed, 10 Jun 2026 14:31:23 +0200 Subject: [PATCH] docs(adr): sync plan Task 2 with flat-comment template fix Co-Authored-By: Claude Opus 4.8 (1M context) --- .../plans/2026-06-10-adr-structure.md | 21 +++++++++---------- 1 file changed, 10 insertions(+), 11 deletions(-) diff --git a/docs/superpowers/plans/2026-06-10-adr-structure.md b/docs/superpowers/plans/2026-06-10-adr-structure.md index f057a73..ea83f2b 100644 --- a/docs/superpowers/plans/2026-06-10-adr-structure.md +++ b/docs/superpowers/plans/2026-06-10-adr-structure.md @@ -230,24 +230,23 @@ Accepted (YYYY-MM-DD) - + +## Scope — explicit in / out-of-scope boundaries. -## What was ruled out - +## Guardrails — how the decision is mechanically enforced (lint, CI, hooks). -## Verified facts (ADR-014) - +## What was ruled out — rejected alternatives, each with its reason. -## Related - +## Verified facts (ADR-014) — verified: · · · + +## Related — links to other ADRs by number; bidirectional for Supersedes/Superseded-by. --> ``` +(HTML comments do not nest — optional sections use one flat comment block with inline +em-dash descriptions, not commented sub-hints inside an outer comment.) + - [ ] **Step 2: Confirm the template is skipped by the check** Run: `python3 scripts/repo-scan.py 2>/dev/null | python3 -c "import json,sys; print([f for f in json.load(sys.stdin)['findings'] if f['check']=='adr-structure' and 'adr-template' in f['path']])"`