Skip to content

[caveman] Optimize instruction verbosity — memory-stateful-patterns.md (2026-08-31) - #57509

Merged
pelikhan merged 1 commit into
mainfrom
caveman-optimize-2026-08-31-0e4d83cb2055e80c
Aug 31, 2026
Merged

[caveman] Optimize instruction verbosity — memory-stateful-patterns.md (2026-08-31)#57509
pelikhan merged 1 commit into
mainfrom
caveman-optimize-2026-08-31-0e4d83cb2055e80c

Conversation

@github-actions

@github-actions github-actions Bot commented Aug 31, 2026

Copy link
Copy Markdown
Contributor

Caveman Optimization Run — 2026-08-31

Applies the caveman optimization principle to instruction files:

"Why use many token when few do trick."

Files Optimized

File Before After Removed
.github/aw/memory-stateful-patterns.md 122 lines / 5509 chars 114 lines / 4962 chars Duplicated "when to use" prose block and a repeated tradeoff sentence

The other four files in this batch needed no changes — see below.

What Was Changed

.github/aw/memory-stateful-patterns.md — The ## Baseline Comparison (cache-memory) section opened with an intro paragraph, then a When to use this pattern bullet list and a When to use repo-memory instead note that restated the same information a second and third time (the same points also appear in the section's own Key design decisions bullets below the example). Collapsed those three blocks into the intro paragraph plus the one-line repo-memory pointer.

In ## Stateful Scanning (repo-memory), dropped the sentence "Unlike cache-memory, the baseline survives cache expiry, so a missed cycle does not flood the repo with duplicate issues" — it duplicates the first Key design decisions bullet in that same section, which states it more completely.

Net: 3 insertions, 11 deletions. Character reduction is ~9%, marginally under the usual 10% bar. Kept it because the cuts remove genuine three-way duplication rather than cosmetic whitespace; no filler was trimmed merely to clear the threshold.

What Was Preserved

Both markdown workflow examples (frontmatter, tools:, safe-outputs:, permissions:, engine:, network: blocks) are untouched. All Key design decisions bullets are intact, including the cache-memory vs repo-memory tradeoff rationale, the max: flood guard, the engine restriction (repo-memory requires Claude or a custom engine, not Copilot), first-run handling, and the YYYY-MM-DD-HH-MM-SS filename-safety rule.

Files reviewed with no change needed
File Lines Why no change
.github/aw/mcp-clis.md 55 Almost entirely shell examples and terse bullets; prose is already imperative
.github/aw/memory.md 333 Dense reference — decision tables, YAML config blocks, tradeoff matrices, anti-patterns. Nearly every line carries schema or compiler-constraint signal
.github/aw/messages.md 119 Reference tables of message keys/variables/defaults plus templates and do/don't examples
.github/aw/multi-agent-research.md 284 Design guide whose repetition is deliberate: principles, a copy-paste prompt template, and a checklist serve different authoring moments. Only ~3% was cuttable filler — below threshold

Round-Robin Progress

Processed files 35–39 of 68 in the queue (mcp-clis.md through multi-agent-research.md). Next run resumes at index 40 (network.md).

Generated by ⚡ Daily Caveman Optimizer · claude · haiku45 · 155 AIC · ⌖ 57.8 AIC · ⊞ 8K ·

  • expires on Sep 3, 2026, 12:50 PM UTC-08:00

Warning

Firewall blocked 1 domain

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

  • github.com

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

network:
  allowed:
    - defaults
    - "github.com"

See Network Configuration for more information.

Generated by 👨‍🍳 PR Sous Chef · pi · gpt54 · 10 AIC · ⌖ 8.61 AIC · ⊞ 9.2K ·
Comment /souschef to run again

Collapse the "When to use this pattern" / "When to use repo-memory
instead" block, which restated the section intro and the Key design
decisions bullets, and drop a sentence in the repo-memory intro that
duplicated a design-decision bullet verbatim.

All YAML frontmatter examples, field names, compiler constraints and
design-decision rationale left intact.

Co-Authored-By: Claude <noreply@anthropic.com>
@gh-aw-bot

Copy link
Copy Markdown
Collaborator

@copilot Please check this PR for forward progress, refresh the branch if needed, and run the pr-finisher skill before handing back. No action-required CJS/CGO/CWI runs are waiting, but this PR appears idle and ready for a maintainer follow-up.

Warning

Firewall blocked 1 domain

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

  • github.com

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

network:
  allowed:
    - defaults
    - "github.com"

See Network Configuration for more information.

Generated by 👨‍🍳 PR Sous Chef · pi · gpt54 · 10 AIC · ⌖ 8.61 AIC · ⊞ 9.2K ·
Comment /souschef to run again

@github-actions

github-actions Bot commented Sep 1, 2026

Copy link
Copy Markdown
Contributor Author

🎉 This pull request is included in a new release.

Release: v0.88.0

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.

2 participants