Added: 2026-04-20 | Source: sw-audit | Work: audit-2026-04-20
Audit finding: F34 (BLOCKER)
Location:
- core/protocols/decision.md:295-324
- adapters/claude-code/hooks/session-start.mjs:15-79
- adapters/opencode/plugin.ts:170-226
- evals/tests/test_grader.py:1598-1666
Problem:
Specwright writes useful stage-report.md / review-packet.md artifacts, but the primary terminal and recovery surfaces still optimize for the three-line machine trailer. Users see a pointer to hidden runtime artifacts instead of a compact human digest, while the model continues with context the user often never saw.
Recommendation:
Keep the exact three-line trailer as the machine footer, but add a short human-facing closeout digest before it and teach the Claude/Opencode recovery surfaces to lift the latest stage-report.md or review-packet.md summary automatically. Add eval coverage for that human-facing digest so legibility is a tested contract, not an incidental artifact.
Added: 2026-04-20 | Source: sw-audit | Work: audit-2026-04-20
Audit finding: F34 (BLOCKER)
Location:
Problem:
Specwright writes useful
stage-report.md/review-packet.mdartifacts, but the primary terminal and recovery surfaces still optimize for the three-line machine trailer. Users see a pointer to hidden runtime artifacts instead of a compact human digest, while the model continues with context the user often never saw.Recommendation:
Keep the exact three-line trailer as the machine footer, but add a short human-facing closeout digest before it and teach the Claude/Opencode recovery surfaces to lift the latest
stage-report.mdorreview-packet.mdsummary automatically. Add eval coverage for that human-facing digest so legibility is a tested contract, not an incidental artifact.