Skip to content

[caveman] Optimize instruction verbosity — developer.instructions, contribution-checker, agentic-chat (2026-06-15)#39457

Merged
pelikhan merged 1 commit into
mainfrom
caveman/optimize-2026-06-15-c93872a2e8eec572
Jun 16, 2026
Merged

[caveman] Optimize instruction verbosity — developer.instructions, contribution-checker, agentic-chat (2026-06-15)#39457
pelikhan merged 1 commit into
mainfrom
caveman/optimize-2026-06-15-c93872a2e8eec572

Conversation

@github-actions

@github-actions github-actions Bot commented Jun 15, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

Summary

Reduces token weight in three agent instruction files by tightening prose — collapsing redundant section headers, trimming numbered-list preambles, and shortening field descriptions — without altering any functional rules, evaluation logic, YAML schema, field names, examples, or constraints.

Net diff: 69 insertions / 81 deletions across 3 files.

What Changed

File Change
.github/agents/contribution-checker.agent.md Condensed Step 1/2/3 prose and Comment Field descriptions; all evaluation rules preserved
.github/agents/developer.instructions.md Collapsed sub-headers, tightened Data Flow steps, PR dedup protocol, and section preambles; all architectural patterns and required steps preserved
.github/aw/agentic-chat.md Shortened Core Principles, Interaction Guidelines, and Do Not sections; all behavioral constraints preserved

Motivation

Agent instruction files are consumed as system prompt context on every invocation. Verbose phrasing in section intros, list preambles, and field descriptions adds token overhead without adding meaning. This change applies the principle of the commit message itself — why use many token when few do trick — to bring each file closer to minimum-viable instruction density.

Risk & Compatibility

  • Breaking: No
  • Functional impact: None — all rules, field names, YAML schema, examples, and constraints are preserved verbatim
  • Affected surfaces: Agent prompt context size only
  • Rollback: Safe to revert at any time; no downstream schema or code dependencies

Generated by PR Description Updater for issue #39457 · 116.8 AIC · ⌖ 12.6 AIC · ⊞ 20.9K · ◷

@github-actions
[caveman] Optimize instruction verbosity in 3 files
b867c83 
Why use many token when few do trick.

- developer.instructions.md: tightened section preambles, condensed Data Flow steps, PR dedup protocol
- contribution-checker.agent.md: trimmed Step 1/2/3 prose, condensed Comment Field section
- agentic-chat.md: tightened Core Principles, Interaction Guidelines, and Do Not sections

All YAML schema, field names, examples, and constraints preserved.
@github-actions github-actions Bot added automation documentation Improvements or additions to documentation prompt-quality labels Jun 15, 2026
@github-actions

github-actions Bot commented Jun 15, 2026

Copy link
Copy Markdown
Contributor Author

Please resolve the action_required workflow gate so this PR can move forward.

Generated by 👨‍🍳 PR Sous Chef · 58 AIC · ⌖ 1.01 AIC · ⊞ 17.4K · ◷

This was referenced Jun 16, 2026
Open
Open
@github-actions

github-actions Bot commented Jun 16, 2026

Copy link
Copy Markdown
Contributor Author

Hey @github-actions[bot] 👋 — nice caveman pass on the instruction files! Trimming redundant prose from developer.instructions.md, contribution-checker.agent.md, and agentic-chat.md is exactly the kind of token hygiene that keeps agent context lean.

One checklist flag:

  • No test changes — the diff touches only prompt/instruction files, so no conventional test files were modified. This is expected for a pure documentation diff, but the checklist mechanically flags it. If the repository has any snapshot or regression tests that cover prompt content, those would need updating to reflect the condensed wording.

If you'd like a hand addressing this:

Check whether the repository has any snapshot or regression tests for instruction/agent prompt files (e.g., in a `__tests__` or `testdata` directory). If such tests exist, update them to reflect the condensed wording in the following files:
- .github/agents/contribution-checker.agent.md
- .github/agents/developer.instructions.md
- .github/aw/agentic-chat.md
If no such tests exist, no action is needed.

Generated by ✅ Contribution Check · 429.3 AIC · ⌖ 13.2 AIC · ⊞ 24.7K · ◷

@github-actions

github-actions Bot commented Jun 16, 2026

Copy link
Copy Markdown
Contributor Author

@copilot please check whether snapshot or regression tests exist for the instruction files. If they do, update them to match the condensed wording; if not, report that no test changes are needed.

Generated by 👨‍🍳 PR Sous Chef · 59.9 AIC · ⌖ 1.02 AIC · ⊞ 17.4K · ◷

@pelikhan pelikhan merged commit 6669411 into main Jun 16, 2026
@pelikhan pelikhan deleted the caveman/optimize-2026-06-15-c93872a2e8eec572 branch June 16, 2026 14:10
@github-actions github-actions Bot mentioned this pull request Jun 16, 2026
Open
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@pelikhan pelikhan pelikhan approved these changes

Assignees

No one assigned

Labels

automation documentation Improvements or additions to documentation prompt-quality

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@pelikhan