An agentic skills framework & software development methodology that works.
Adopt audited positive phrasings: evidence rule leads positive; fix-report completeness as checklist
Jesse Vincente9b88d05c8da
diff --git a/skills/subagent-driven-development/SKILL.md b/skills/subagent-driven-development/SKILL.mdindex 64b9e7232..55c8e3d1b 100644--- a/skills/subagent-driven-development/SKILL.md+++ b/skills/subagent-driven-development/SKILL.md@@ -178,8 +178,9 @@ final whole-branch review. When you fill a reviewer template:- Every fix dispatch carries the implementer contract: the fix subagentre-runs the tests covering its change and reports the results. Name thecovering test files in the dispatch — a one-line fix does not need the- whole suite. A fix report without test evidence is incomplete — do not- re-review on top of it.+ whole suite. Before re-dispatching the reviewer, confirm the fix report+ contains the covering tests, the command run, and the output; dispatch+ the re-review once all three are present.- If the final whole-branch review returns findings, dispatch ONE fixsubagent with the complete findings list — not one fixer per finding.Per-finding fixers each rebuild context and re-run suites; a realdiff --git a/skills/subagent-driven-development/task-reviewer-prompt.md b/skills/subagent-driven-development/task-reviewer-prompt.mdindex 19f56b9a4..3bc019a02 100644--- a/skills/subagent-driven-development/task-reviewer-prompt.md+++ b/skills/subagent-driven-development/task-reviewer-prompt.md@@ -110,9 +110,10 @@ Subagent (general-purpose):significantly grow existing files? (Don't flag pre-existing filesizes — focus on what this change contributed.)- Cite file:line evidence for every finding and for any check you would- otherwise answer with a bare "yes." Cite, don't narrate — a tight report- that points at lines beats a long one that retells the diff.+ Your report should point at evidence: file:line references for every+ finding and for any check you would otherwise answer with a bare+ "yes." A tight report that cites lines gives the controller everything+ it needs.## Calibration