Skip to content

docs: one canonical statement of compact review and proof reuse - #28

Merged
cskwork merged 1 commit into
mainfrom
docs/compress-compact-review-prompts
Oct 11, 2026
Merged

cskwork merged 1 commit into
mainfrom
docs/compress-compact-review-prompts

Conversation

@cskwork

@cskwork cskwork commented Oct 11, 2026

Copy link
Copy Markdown
Owner

#26 described the compact combined reviewer and proof reuse in both AGENTS.md rule 6 and the build skill. That added 390 words to the build path, after #23 had cut 662. Rule 6 is now the only place these are stated; the build skill keeps its own duties and points there. Wordier older bullets in AGENTS.md and build now state the same rules in fewer words. No rule, cap, path, command or rule number was removed.

Prompt load (wc -w)

File Before After
SKILL.md 628 623
AGENTS.md 3,413 3,285
skills/4-build/SKILL.md 1,594 1,337
Build path 5,635 5,245

The build path is back to the post-#23 level. The word budgets added in #27 are lowered to these counts. These are word counts only, not tokens, cost or latency. Nothing here shows that prompt length causes the time gap in the #25/#26 A/B results.

Validation

  • Blind decision exercise. I wrote 10 build-stage scenarios and their expected answers before any run: compact versus full review dispatch, proof reuse after a source change and with no change, the deviation cap at lazymode 4, the re-gate cap, an intentional test change, deploy during build, legacy input handling, and re-asking an answered question. Two separate codex exec runs (gpt-6.1-sol, high reasoning, read-only) each answered from one snapshot: the old one (7dc17a3) or the new one. Both scored 10/10 and reached the same decision in every scenario. This is a response-level check, not a statistical or product-execution claim.
  • Adversarial semantic review of the diff (gpt-6.1-sol, high, read-only): NO FINDINGS. It confirmed that every relocated requirement resolves, for example roles/verifier.md:25–31 for reuse limits, roles/adversary.md:87–88 for per-file rows, and AGENTS.md:221–225 for "rule 6's proof reuse".
  • Every Markdown link and kit path in the three files resolves.
  • Local macOS: gates/selftest.sh SELFTEST PASS (including the budgets), tests/test_runner.py OK, tests/factory-e2e.sh PASS, git diff --check clean.

#26 stated the compact combined reviewer and proof reuse in both AGENTS.md
rule 6 and the build skill, adding 390 words to the build path after #23 had
cut 662. Rule 6 is now the one statement; build keeps only its own duties
and points there. Wordy older bullets in AGENTS.md and build say the same
rules in fewer words. Build path (router + AGENTS.md + build skill): 5,635 ->
5,245 words. Word budgets lowered to match.
@cskwork
cskwork merged commit d63c851 into main Oct 11, 2026
3 checks passed
@cskwork
cskwork deleted the docs/compress-compact-review-prompts branch October 11, 2026 22:35
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.

2 participants