[caveman] Optimize instruction verbosity — network.md (2026-09-01) - #57777
Merged
Conversation
The "Common Patterns" section restated four YAML blocks already shown verbatim in "Quick Reference". Kept the two unique combinations and pointed at Quick Reference for the rest. Co-Authored-By: Claude <noreply@anthropic.com>
This was referenced Sep 1, 2026
Contributor
Author
|
🎉 This pull request is included in a new release. Release: |
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-09-01
Applies the caveman optimization principle to instruction files:
Files Optimized
.github/aw/network.mdWhat Was Changed
.github/aw/network.md— The "Common Patterns" section at the bottom of the file re-showed fournetwork:configurations that appear verbatim in the "Quick Reference" block at the top: thedefaults + nodesingle-ecosystem form, the external-API-plus-wildcard form, andallowed: []. Only two entries carried configuration shapes not already demonstrated —defaults + githuband the three-way multi-languagedefaults + node + python. Those two were kept as-is; the duplicates were replaced with a one-line pointer back to Quick Reference. Also flattened the four###sub-headings into inline labels, since each headed a single code block.Net: 27 lines removed, 3 added.
What Was Preserved
Every distinct
network.allowedconfiguration shape still appears at least once in the file. No ecosystem identifier, domain-pattern rule, invalid-shorthand mapping, engine domain set, or compile-time-error warning was touched. The ecosystem tables, the "network: defaultsalone is never sufficient" caution, and the repository-file inference table are unchanged.Files Reviewed, No Change Needed
Four other files in this batch were assessed and left alone — each is already near-entirely YAML examples, tables, and direct imperative rules, with no prose that could be cut without losing schema signal:
View Details
.github/aw/playwright.md(247 lines) — prose is dense but nearly all of it encodes AWF sandbox constraints (no runtime installs, no0.0.0.0binds, loopback-only servers) or CLI usage rules. No safe 10% cut..github/aw/pr-reviewer.md(74 lines) — already minimal. TheGITHUB_TOKENcannot-APPROVEconstraint and theallowed-eventsexample are exactly the kind of near-miss signal the rules say to keep..github/aw/report.md(160 lines) — mostly tables and rules. One forward-reference sentence duplicates the section it points at, but removing it alone is ~1.5%, below the threshold..github/aw/reuse.md(296 lines) — almost entirelyimports:/import-schema:YAML examples and merge-behaviour tables.Round-Robin Progress
Processed files 41–45 of 69 in the queue (
network.md,playwright.md,pr-reviewer.md,report.md,reuse.md).The eligible file list grew by one since the last run (
playwright.mdbecame eligible), so the queue was rebuilt from the current sorted listing and the cursor was resumed after the previously-processed file rather than reset to zero, to avoid re-walking files already reviewed.