Skip to content

[caveman] Optimize instruction verbosity — developer.instructions.md, agentic-chat.md (2026-04-30)#29291

Merged
pelikhan merged 1 commit intomainfrom
caveman/2026-04-30-developer-instructions-agentic-chat-f42611f42b644bc6
Apr 30, 2026
Merged

[caveman] Optimize instruction verbosity — developer.instructions.md, agentic-chat.md (2026-04-30)#29291
pelikhan merged 1 commit intomainfrom
caveman/2026-04-30-developer-instructions-agentic-chat-f42611f42b644bc6

Conversation

@github-actions
Copy link
Copy Markdown
Contributor

Caveman Optimization Run — 2026-04-30

Applies the caveman optimization principle to instruction files:

"Why use many token when few do trick."

Files Optimized

File Before After Removed
.github/agents/developer.instructions.md ~852 lines ~761 lines 3 "Why it works" prose blocks, Test Maintenance description, Meta-Orchestrator Key Capabilities list, Additional Documentation index section
.github/aw/agentic-chat.md ~142 lines ~120 lines Problem Decomposition sub-header/intro, pseudo-code section lead-in, Output Format self-evident explanation, Example Interaction Flow (sub-bullets preserved in Guideline 1)

What Was Changed

developer.instructions.md: Removed three "Why it works" blocks under code organization patterns (Clear separation of concerns, Engine-specific logic is isolated, Tests are co-located — all self-evident from the pattern names and examples). Removed a "Test Maintenance" section listing vague quality adjectives (self-validating, comprehensive, maintainable). Removed a "Key Capabilities" bullet list under Hierarchical Agent Management (generic role words already implied by the table above). Removed the "Additional Documentation" link index — all critical scratchpad references already appear inline as "See scratchpad/X.md" in each section.

agentic-chat.md: Collapsed verbose Problem Decomposition sub-headers into a direct bullet list. Dropped a "When pseudo-code is necessary to clarify logic:" lead-in line. Removed a "This allows users to: 1. Select... 2. Copy... 3. Paste..." block (obvious from context). Removed the Example Interaction Flow section that duplicated the Interaction Guidelines; preserved its unique clarifying-question specifics by folding them into Guideline 1.

What Was Preserved

All technical accuracy, field names, YAML examples, schema definitions, security rules, inline scratchpad references, and compiler constraints were kept intact.

Round-Robin Progress

Queue rebuilt (new files added since last run). Processed files 0–4 of 21 total files in the queue.

Generated by Daily Caveman Optimizer · ● 608.4K ·

  • expires on May 3, 2026, 11:55 AM UTC

…hat.md (2026-04-30)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@github-actions github-actions Bot added automation documentation Improvements or additions to documentation prompt-quality labels Apr 30, 2026
@pelikhan pelikhan merged commit 0feba9e into main Apr 30, 2026
@pelikhan pelikhan deleted the caveman/2026-04-30-developer-instructions-agentic-chat-f42611f42b644bc6 branch April 30, 2026 13:43
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