Skip to content

[caveman] Optimize instruction verbosity — report.md (2026-05-09)#31273

Merged
pelikhan merged 1 commit into
mainfrom
caveman/optimize-report-2026-05-09-16a0b695ed6ab2e8
May 9, 2026
Merged

[caveman] Optimize instruction verbosity — report.md (2026-05-09)#31273
pelikhan merged 1 commit into
mainfrom
caveman/optimize-report-2026-05-09-16a0b695ed6ab2e8

Conversation

@github-actions
Copy link
Copy Markdown
Contributor

@github-actions github-actions Bot commented May 9, 2026

Caveman Optimization Run — 2026-05-09

Applies the caveman optimization principle to instruction files:

"Why use many token when few do trick."

Files Optimized

File Before After Removed
.github/aw/report.md 133 lines 120 lines Fluffy Design Principles block, redundant lead-in sentences before bullet lists

What Was Changed

  • .github/aw/report.md: Removed the Design Principles subsection (Build trust through clarity / Exceed expectations / Create delight / Maintain consistency) — its content was already covered by the adjacent Report Structure Pattern and Progressive Disclosure sections, and the wording added no agentic-workflow schema signal.
  • Tightened Header Levels: dropped a redundant bold restatement of the rule and a When creating GitHub issues or discussions: framing line, leaving the three direct bullet rules.
  • Tightened 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 the mentions / allowed-github-references / max-bot-mentions filter 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.json for the next run.

Generated by Daily Caveman Optimizer · ● 7.5M ·

  • expires on May 12, 2026, 9:04 PM UTC

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>
@github-actions github-actions Bot added automation documentation Improvements or additions to documentation prompt-quality labels May 9, 2026
@pelikhan pelikhan merged commit dfa9870 into main May 9, 2026
@pelikhan pelikhan deleted the caveman/optimize-report-2026-05-09-16a0b695ed6ab2e8 branch May 9, 2026 21:05
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