Skip to content

[caveman] Optimize instruction verbosity — serena-tool.md, runbooks/README.md (2026-05-10)#31378

Merged
pelikhan merged 1 commit intomainfrom
caveman-opt-2026-05-10-d91b9c44ea769d21
May 10, 2026
Merged

[caveman] Optimize instruction verbosity — serena-tool.md, runbooks/README.md (2026-05-10)#31378
pelikhan merged 1 commit intomainfrom
caveman-opt-2026-05-10-d91b9c44ea769d21

Conversation

@github-actions
Copy link
Copy Markdown
Contributor

Caveman Optimization Run — 2026-05-10

Applies the caveman optimization principle to instruction files:

"Why use many token when few do trick."

Files Optimized

File Before After Removed
.github/aw/serena-tool.md 182 lines 156 lines Duplicate import example, restating-the-YAML "Pattern:" list, anecdotal Production Examples section
.github/aw/runbooks/README.md 32 lines 19 lines Generic "Purpose" bullet list and obvious "How to Use" numbered steps

What Was Changed

serena-tool.md — Merged the basic + multi-language imports: examples into a single block (the multi-language form already supersedes the single-language form). Removed the three-step Pattern: list under "Combine with Other Tools" since it just restated the surrounding YAML/heading. Dropped the "Production Examples" section listing workflow names with success percentages — anecdotal, no agentic schema signal.

runbooks/README.md — Collapsed the 4-bullet "Purpose" list and 5-step "How to Use Runbooks" section into a single sentence; the steps were trivially obvious ("Identify the issue", "Open the relevant runbook").

What Was Preserved

All YAML schema examples, field names, tool lists, decision tables, supported-language references, the Common Pitfalls do-this-not-that list, and the Decision Tree section were kept intact. No compiler constraints removed.

Round-Robin Progress

Processed files 17–21 of 27 in the queue. Files 17 (runbooks/README.md) and 20 (serena-tool.md) optimized; files 18 (workflow-health.md), 19 (safe-outputs.md), and 21 (skills.md) were already tight — schema-dense YAML or already minimal prose — and left unchanged.

Generated by Daily Caveman Optimizer · ● 7.8M ·

  • expires on May 13, 2026, 9:03 PM UTC

Why use many token when few do trick.

- serena-tool.md: 182 -> 156 lines. Merged two redundant import
  examples, removed restating-the-YAML "Pattern:" list, dropped the
  anecdotal "Production Examples" section (workflow names + success
  percentages with no schema signal).
- runbooks/README.md: 32 -> 19 lines. Collapsed generic "Purpose" and
  obvious "How to Use" sections that added no agent-actionable signal.

All YAML examples, schema field names, and decision tables preserved.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
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