[caveman] Optimize instruction verbosity — serena-tool, skills, subagents (2026-06-12)

[github-actions]

Summary

Condenses prose in three agentic-workflow instruction files — serena-tool.md, skills.md, and subagents.md — trading verbose framing for tighter, scan-friendly equivalents. Net result: −8 lines (34 in / 42 out) with zero functional or behavioural change.

Changes

.github/aw/serena-tool.md — modified (low impact)

• Shortened section header "Quick Decision: Should I Use Serena?" → "When to Use Serena".
• Collapsed ✅/❌ framing into plain "Use when / Don't use" lists; removed one redundant bullet (Simple file operations).
• Trimmed configuration intro sentence and step-description preamble; converted "Use bash for ... Serena for ... edit for ..." to a compact noun-phrase list.

.github/aw/skills.md — modified (low impact)

• Rewrote opening paragraph into a single compact sentence.
• Removed blank line between "Detecting Skills" header and the bash snippet.
• Condensed inline-skills explanation from four sentences to two; collapsed naming-constraint prose from three sentences to one.
• Tightened Strategy 1 (Hint) and Strategy 2 (Fusion) preambles to single sentences each; removed "Do not paste the entire SKILL.md" sub-sentence (implicit from "only specific sections").
• Simplified closing comparison sentence.

.github/aw/subagents.md — modified (low impact)

• Condensed opening definition to one sentence (moved runtime mechanics inline).
• "Sub-agents are most useful in two scenarios" → "Two main scenarios".
• Collapsed Scenario 1 and Scenario 2 descriptions into tighter prose; removed "The parent model (e.g. Claude Sonnet or Copilot) orchestrates, while the sub-agents do the heavy lifting" → compact equivalent.
• Reworded Planner-Worker header from "Use a planner-worker split to..." → "Split work to...".
• Condensed planner and worker role bullets; trimmed delegation-rule sentences (raw logs / file dumps guidance retained, cloud payload clause dropped as redundant).

Impact

Attribute	Value
Breaking change	No
Functional / behavioural change	No
Affects runtime logic	No
Affects compiled .lock.yml output	No
Testing required	None — docs-only

Related

Commit: d2e9fdddd — [caveman] Optimize instruction verbosity in serena-tool, skills, subagents

Generated by PR Description Updater for issue #38930 · 106.5 AIC · ⌖ 13.2 AIC · ⊞ 19.8K · ◷