Skip to content

[caveman] Optimize instruction verbosity — network.md (2026-09-01) - #57777

Merged
pelikhan merged 1 commit into
mainfrom
caveman-optimize-2026-09-01-ae9d8c5db8fe7f30
Sep 1, 2026
Merged

[caveman] Optimize instruction verbosity — network.md (2026-09-01)#57777
pelikhan merged 1 commit into
mainfrom
caveman-optimize-2026-09-01-ae9d8c5db8fe7f30

Conversation

@github-actions

@github-actions github-actions Bot commented Sep 1, 2026

Copy link
Copy Markdown
Contributor

Caveman Optimization Run — 2026-09-01

Applies the caveman optimization principle to instruction files:

"Why use many token when few do trick."

Files Optimized

File Before After Removed
.github/aw/network.md ~208 lines ~184 lines Four YAML examples in "Common Patterns" that were byte-identical duplicates of blocks already shown in "Quick Reference"

What Was Changed

.github/aw/network.md — The "Common Patterns" section at the bottom of the file re-showed four network: configurations that appear verbatim in the "Quick Reference" block at the top: the defaults + node single-ecosystem form, the external-API-plus-wildcard form, and allowed: []. Only two entries carried configuration shapes not already demonstrated — defaults + github and the three-way multi-language defaults + 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.allowed configuration 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: defaults alone 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, no 0.0.0.0 binds, loopback-only servers) or CLI usage rules. No safe 10% cut.
  • .github/aw/pr-reviewer.md (74 lines) — already minimal. The GITHUB_TOKEN cannot-APPROVE constraint and the allowed-events example 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 entirely imports: / 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.md became 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.

Generated by ⚡ Daily Caveman Optimizer · claude · haiku45 · 126.3 AIC · ⌖ 57.2 AIC · ⊞ 8K ·

  • expires on Sep 4, 2026, 12:50 PM UTC-08:00

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>
@github-actions github-actions Bot added automation documentation Improvements or additions to documentation prompt-quality labels Sep 1, 2026
@pelikhan
pelikhan merged commit a529799 into main Sep 1, 2026
@pelikhan
pelikhan deleted the caveman-optimize-2026-09-01-ae9d8c5db8fe7f30 branch September 1, 2026 21:21
@github-actions

github-actions Bot commented Sep 1, 2026

Copy link
Copy Markdown
Contributor Author

🎉 This pull request is included in a new release.

Release: v0.88.0

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

automation documentation Improvements or additions to documentation prompt-quality

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant