[caveman] Optimize instruction verbosity — report.md (2026-05-09)#31273
Merged
pelikhan merged 1 commit intoMay 9, 2026
Conversation
Apply caveman optimization: cut redundant lead-ins and the fluffy "Design Principles" section. All schema/structural guidance preserved. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Caveman Optimization Run — 2026-05-09
Applies the caveman optimization principle to instruction files:
Files Optimized
.github/aw/report.mdDesign Principlesblock, redundant lead-in sentences before bullet listsWhat Was Changed
.github/aw/report.md: Removed theDesign Principlessubsection (Build trust through clarity/Exceed expectations/Create delight/Maintain consistency) — its content was already covered by the adjacentReport Structure PatternandProgressive Disclosuresections, and the wording added no agentic-workflow schema signal.Header Levels: dropped a redundant bold restatement of the rule and aWhen creating GitHub issues or discussions:framing line, leaving the three direct bullet rules.Progressive Disclosure: merged the bold restatement into the introductory line of the bullet list.Net: 13 lines removed (~10% of the file).
What Was Preserved
All YAML frontmatter examples, safe-output type recommendations, automatic-cleanup field references (
expires,close-older-issues,close-older-discussions,hide-older-comments), header-level rules, the example report structure, the workflow-run reference format, and thementions/allowed-github-references/max-bot-mentionsfilter guidance.Files Inspected But Not Changed
.github/aw/github-mcp-server.md— predominantly tool reference tables; high schema signal, already concise..github/aw/memory.md— densely packed schema and design notes; could not reach the 10% reduction threshold without losing agent-relevant signal..github/aw/messages.md— already a tight style guide of tables, templates, and good-vs-bad examples..github/aw/network.md— almost entirely tables of ecosystem identifiers, invalid shorthands, and rule examples.Round-Robin Progress
First run (no prior cache state). Started at random index 10; processed files 11–15 of 26 in the eligible queue. Cache state saved at
/tmp/gh-aw/cache-memory/caveman-optimizer/state.jsonfor the next run.