From 3bd7388b7dcd06d85c0f801183874e0846ada5f7 Mon Sep 17 00:00:00 2001 From: Drew Ritter Date: Mon, 20 Jul 2026 02:58:07 -0700 Subject: [PATCH] sdd: controller context diet (terse checkpoints, ledger-based finish) --- skills/subagent-driven-development/SKILL.md | 16 +++++++++++++--- 1 file changed, 13 insertions(+), 3 deletions(-) diff --git a/skills/subagent-driven-development/SKILL.md b/skills/subagent-driven-development/SKILL.md index 6c0b8349..b90589ab 100644 --- a/skills/subagent-driven-development/SKILL.md +++ b/skills/subagent-driven-development/SKILL.md @@ -140,7 +140,11 @@ a ledger file, not only in todos. that happens, recover from `git log`. Read the plan once, note its context and Global Constraints, and create a -todo per task. +todo per task. That is the plan's one full read for the whole session: +after Setup, the ledger and `scripts/task-brief` extracts are your working +memory — re-reading the plan or spec late in the run (to "double-check" +completion, to rebuild the final-review dispatch) re-buys context you +already paid for and is forbidden. Before dispatching Task 1, scan the plan once for conflicts: @@ -195,7 +199,10 @@ that implementer. Single-file mechanical fixes also take the cheapest tier. Everything you paste into a dispatch prompt — and everything a subagent prints back — stays resident in your context for the rest of the session -and is re-read on every later turn. Hand artifacts over as files. +and is re-read on every later turn. Hand artifacts over as files. The same +tax applies to your own words: checkpoint in one short line, keep +bookkeeping in the ledger file, and never paste back into the conversation +what a file already holds. ### 1. Dispatch the implementer @@ -399,7 +406,10 @@ on the most capable available model (see Model Selection), using superpowers:requesting-code-review's [code-reviewer.md](../requesting-code-review/code-reviewer.md). Point it at the ledger's deferred-minor and parked lines so it can triage which must be -fixed before merge. +fixed before merge. Build that dispatch from the ledger alone — the +completion lines, parked rulings, and deferred minors are the whole-run +summary; do not re-read the plan, the spec, or per-task reports to +reconstruct what the ledger already states. If the final whole-branch review returns findings, dispatch ONE fix subagent with the complete findings list — not one fixer per finding.