Skip to content

docs(skill): bias brainstorm toward minimal solutions and deletion cost - #197

Merged
codeaholicguy merged 1 commit into
mainfrom
skill-brainstorm-minimal
Aug 22, 2026
Merged

docs(skill): bias brainstorm toward minimal solutions and deletion cost#197
codeaholicguy merged 1 commit into
mainfrom
skill-brainstorm-minimal

Conversation

@codeaholicguy

Copy link
Copy Markdown
Owner

Summary

  • add a Baseline step: state the simplest honest solution in 1–3 sentences before diverging; every option must justify what it adds over it, and the baseline stays a candidate
  • add two mandatory Challenge axes: speculative generality (every abstraction/layer/flag/data copy needs a current caller) and verified claims (load-bearing "needed" claims must be checked against runtime behavior, not doc assertions)
  • add deletion cost to Compare: on ties prefer the smaller option — complexity gets added on demand but is rarely removed voluntarily
  • add a self-review gate before Converge: ask "why do we need this?" for each new constant/object/layer/flag; cut messaging-only or future-proofing answers
  • note "scope without a current caller" in the Avoid list

Rationale

Review arcs on #147 (capacity) and #196 (remove-registry) showed late-cut complexity that a baseline-first, deletion-cost-aware brainstorm would have caught at design time: a cache no runtime consumer read, multi-provider scaffolding with one real provider, a 77-line frozen registry-id snapshot used only for message wording, and a mutation object with unused fields. The lesson: always solve with the simple and minimal solution, and treat deletion cost as a first-class criterion.

Validation

  • Markdown-only change; no code paths affected

@codeaholicguy
codeaholicguy force-pushed the skill-brainstorm-minimal branch from 36574c5 to 35695f2 Compare August 22, 2026 15:01
@codeaholicguy
codeaholicguy merged commit 631a81d into main Aug 22, 2026
7 checks passed
@codeaholicguy
codeaholicguy deleted the skill-brainstorm-minimal branch August 22, 2026 15:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant