optimize-agents-md

name	optimize-agents-md
description	Optimize AGENTS.md and rules for token efficiency. Auto-invoked when user asks about improving agent instructions, compressing AGENTS.md, or making rules more effective.
license	ISC

Optimize AGENTS.md

Apply Boris Cherny's compression principles to AGENTS.md and rules files.

Target: ~2.5k tokens (most are 10k+ unnecessarily)

When to Use

• User wants to improve their AGENTS.md or CLAUDE.md
• Agent instructions feel verbose or redundant
• Rules exist but lack verification patterns
• Setting up a new project's agent configuration

Anti-Patterns to Fix

Anti-Pattern	Problem	Fix
Context stuffing	Repeating info agents already know	Delete obvious instructions
Static memory	No learnings section	Add ## Learnings with dates
Format drift	Inconsistent structure	Use consistent headers
Missing verification	No way to check work	Add *Verify:* patterns to rules
Verbose rules	Paragraphs instead of patterns	Compress to pattern + verify + fix

Workflow

Phase 1: Analyze Current State

# Count tokens (rough estimate: words × 1.3)
 -w AGENTS.md


grep -l  AGENTS.md package.json