[caveman] Optimize instruction verbosity — adr-writer, contribution-checker (2026-07-03)

[github-actions]

Summary

Reduces instruction verbosity in two agent definition files by consolidating redundant prose while preserving all actionable constraints.

Changes

.github/agents/adr-writer.agent.md

• Collapses the Writing Quality Standards section from four sub-headed blocks (Context, Decision, Alternatives Considered, Consequences — ~12 lines) into a single introductory line plus three focused bullets (~4 lines).
• Removes the "Context" sub-section guidance entirely (sentence-count hints and problem-space framing).
• Retains key constraints: active voice for Decision, ≥2 genuine alternatives, ≥2 consequences per Positive/Negative/Neutral category.

.github/agents/contribution-checker.agent.md

• Replaces a Where: list of 9 individual field-description bullets with a Field values: list of 6 bullets.
• Groups boolean fields focused, deps, tests onto a single line.
• Removes title and author field descriptions from the output spec.

Impact

File	Lines removed	Lines added
adr-writer.agent.md	~9	~3
contribution-checker.agent.md	~10	~6

No Go code, compiled artifacts, or tests changed. Pure instruction-text optimization to reduce token consumption in agent prompts.

Generated by PR Description Updater for #43266 · 30.7 AIC · ⌖ 6.09 AIC · ⊞ 4.7K · ◷

[github-actions]

Thanks for the caveman optimization run on adr-writer and contribution-checker! The consolidation is clean — collapsing the per-field Where: list in contribution-checker.agent.md and merging the redundant per-section quality bullets in adr-writer.agent.md both read well and preserve every valid value enum.

One mechanical flag to note:

• No test files in the diff — this is expected for markdown-only instruction changes, but the automated checker still flags it. If the project has any snapshot or rendering tests for agent instruction files, a pointer here would silence the flag for future runs.

If you'd like to address this for future caveman runs, here's a prompt:

Check whether the repository has any automated tests or validation scripts that cover .github/agents/*.agent.md files (e.g., snapshot tests, schema validation, or lint rules). If so, update them to reflect the changes in adr-writer.agent.md and contribution-checker.agent.md from PR #43266. If no such tests exist, document in DEVGUIDE.md or a relevant spec that agent instruction files are intentionally excluded from test coverage.

Warning

Firewall blocked 1 domain

The following domain was blocked by the firewall during workflow execution:

• patchdiff.githubusercontent.com

To allow these domains, add them to the network.allowed list in your workflow frontmatter:

network:
  allowed:
    - defaults
    - "patchdiff.githubusercontent.com"

See Network Configuration for more information.

Generated by ✅ Contribution Check · 269.8 AIC · ⌖ 22.3 AIC · ⊞ 6.3K · ◷