From 81280b71efe7b065fb1ccbf205a704c7425bc3f8 Mon Sep 17 00:00:00 2001 From: Craig Jennings Date: Fri, 22 May 2026 15:53:17 -0500 Subject: chore(todo): close brainstorm audit item --- todo.org | 9 +++------ 1 file changed, 3 insertions(+), 6 deletions(-) diff --git a/todo.org b/todo.org index 4457927..0d93573 100644 --- a/todo.org +++ b/todo.org @@ -796,7 +796,7 @@ Each item below is a one-line summary of a sub-TODO further down. Tick the box w - [X] [#B] =five-whys=: require evidence + counterfactual validation per why **** Brainstorming -- [ ] [#B] =brainstorm=: timebox + research/source rules for high-stakes designs +- [X] [#B] =brainstorm=: timebox + research/source rules for high-stakes designs **** Architecture - [X] [#B] =arch-decide=: timeless examples, drop unverifiable claims @@ -955,12 +955,9 @@ Rewrote step b in =root-cause-trace/SKILL.md=: instead of "add a check at each l Expanded step 2 in =five-whys/SKILL.md=: each link now owes an evidence field (a log/commit/metric/config you can point to) and a counterfactual check (remove this cause — does the symptom above plausibly not happen?). Framed the counterfactual as the main guard against monocausal storytelling, and updated the worked example to show both fields. -*** TODO [#A] =brainstorm=: add timebox and research/source rules for high-stakes designs +*** 2026-05-22 Fri @ 15:51:59 -0500 Added timebox + fresh-sources rules to brainstorm -The one-question-at-a-time flow can run long. Add a timebox and a rule that -claims about markets, regulations, tools, vendors, or current APIs require -fresh sources. The design doc should distinguish researched facts from -assumptions. +Phase 1 gained a "Timebox the dialogue" rule (aim for the one-sentence restatement in ~5-8 questions, then move on and park the rest as open questions). Phase 2 gained "Ground high-stakes claims in fresh sources" (check load-bearing claims about markets/regulations/tools/vendors/APIs against a current source; mark unverified ones as assumptions). The design-doc skeleton gained an "## Assumptions" section that distinguishes researched facts (with source) from assumptions (to confirm before building). *** 2026-05-22 Fri @ 14:59:32 -0500 Made arch-decide examples timeless + required citations -- cgit v1.2.3