[caveman] Optimize instruction verbosity — memory.md, mcp-clis.md (2026-06-27) by github-actions[bot] · Pull Request #41943 · github/gh-aw · GitHub
Skip to content

[caveman] Optimize instruction verbosity — memory.md, mcp-clis.md (2026-06-27)#41943

Merged
pelikhan merged 1 commit into
mainfrom
caveman/optimize-memory-mcp-clis-2026-06-27-e1bcecb21cbeeae6
Jun 27, 2026
Merged

[caveman] Optimize instruction verbosity — memory.md, mcp-clis.md (2026-06-27)#41943
pelikhan merged 1 commit into
mainfrom
caveman/optimize-memory-mcp-clis-2026-06-27-e1bcecb21cbeeae6

Conversation

@github-actions

@github-actions github-actions Bot commented Jun 27, 2026

Copy link
Copy Markdown
Contributor

Summary

Reduces token footprint of two agentic instruction files by trimming prose verbosity without changing meaning or behavior.

Changes

.github/aw/mcp-clis.md

  • Consolidated three separate example blocks (playwright, safeoutputs, mcpscripts) into a single unified **Examples:** block.
  • Removed inline code comments that restated the surrounding prose.
  • Simplified JSON-stdin description: replaced multi-sentence explanation with a terse single line.
  • Shortened file-redirection fallback sentence.
  • Net: ~11 lines removed.

.github/aw/memory.md

  • Rewrote repo-memory/cache-memory disambiguation callout for brevity.
  • Shortened all five caching-strategy table rows by removing trailing qualifiers.
  • Condensed design-guidance bullets (dropped redundant qualifiers like "from GitHub graph data", "when possible").
  • Simplified cache-memory section intro to a single descriptive phrase.
  • Trimmed all six cache-memory "When to use" bullets.
  • Removed "Advanced — " prefix from "Custom key:" subheading.
  • Compressed branch-scoping paragraph.
  • Removed redundant introductory sentence from deduplication example section.
  • Merged multi-line deduplication prose into single lines.
  • Simplified stateful-analysis paragraph (cache-miss notation).
  • Shortened filename-safety comments and instruction sentence.
  • Condensed repo-memory "When to use" bullets from full sentences to noun phrases.
  • Shortened YAML inline comments.
  • Simplified push_repo_memory job description sentences.
  • Condensed repo-memory + wiki section and its "When to use" bullets.
  • Compressed comment-memory description, "When to use" bullets, and "How it works" steps.
  • Condensed stateful-scanning-pattern paragraph.
  • Net: ~40 lines removed.

Type

docs — instruction-file verbosity reduction; no functional or behavioral changes.

Testing

No tests required; documentation-only changes with no logic modifications.

Generated by PR Description Updater for #41943 · 45.7 AIC · ⌖ 11.9 AIC · ⊞ 4.6K ·

Trim filler prose, redundant restatements of YAML examples, and
verbose descriptions. Preserve all schema field names, valid value
examples, compiler constraints, and engine-compatibility notes.

Co-Authored-By: Claude <noreply@anthropic.com>
@github-actions github-actions Bot added automation documentation Improvements or additions to documentation prompt-quality labels Jun 27, 2026
@pelikhan pelikhan merged commit 3ab9317 into main Jun 27, 2026
@pelikhan pelikhan deleted the caveman/optimize-memory-mcp-clis-2026-06-27-e1bcecb21cbeeae6 branch June 27, 2026 21:10
@github-actions

Copy link
Copy Markdown
Contributor Author

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