[caveman] Optimize instruction verbosity — adr-writer, developer.instructions, agentic-chat (2026-05-18)

[github-actions]

Summary

Trims verbose prose in three agent instruction files to reduce token usage and improve readability without changing the meaning or requirements.

Changes

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

• Collapsed multi-bullet verbose descriptions into compact inline forms throughout all procedure sections (Part 1, Part 2, writing procedures, validation checklist, examples)
• Shortened table cell descriptions in the RFC 2119 keyword table
• Reduced line count in "Procedure: Analyzing a PR Diff" and "Procedure: Verifying an Existing ADR" sections
• Condensed "Examples of ADR-Worthy Decisions" lists

.github/agents/developer.instructions.md

• Collapsed "Pattern + Examples" two-line headings into single-line descriptions across code organization patterns (Create Functions, Engine Separation, Test Organization)
• Shortened validation architecture bullet lists (centralized and domain-specific validators)
• Compressed security guidelines (Template Injection Prevention, GitHub Actions Security), golden test instructions, repo-memory data flow steps, changeset commands block, and PR deduplication protocol
• Consolidated version-type descriptions to a single line

.github/aw/agentic-chat.md

• Inlined the two instruction-file URLs onto single lines
• Condensed Core Principles sections (Neutral Technical Tone, Specification Generation Only, Problem Decomposition) to shorter bullets
• Shortened Interaction Guidelines list and Terminology section
• Simplified "What You Should NOT Do" and final step note

Type of change

• Bug fix
• New feature
• Documentation / instruction files only
• Refactor

Notes

No functional changes. All content preserved; only prose length reduced.

Generated by PR Description Updater for issue #33162 · ● 3.9M · ◷