---

name: token-economy description: Apply token optimization when writing docs, changelogs, MCP tasks. Quality #1, Tokens #2. allowed-tools: Read, Edit, Grep

Token Economy

Optimize text for AI context: docs, changelogs, MCP tasks, subtasks.

Principle: Quality first. Never sacrifice essential info.

15 Techniques

Quick Workflow

1. Identify: Prose → tables? Multiple examples → one? ASCII → numbered? Teaching → facts?
2. Apply: Convert, consolidate, compact
3. Check: Essential info preserved? Scannable? No fluff?

MCP Templates

Task:

CopyRequirements: [WHAT] | Files: [PATH:LINES] (action) | Acceptance: [CRITERIA] | Why: [CONTEXT]

progress_notes: [ACTION] [WHAT]. [NEXT]

completion_summary: [DONE]. [TECH]. Files: [PATHS]. [IMPACT]

Examples

Before (prose):

CopyThis function validates user input. Takes string input_text, returns bool.
If valid returns true, otherwise false. Checks empty, special chars, length ≤100.

After (compact):

Copy**validate_input(input_text: str) → bool**: True if valid (non-empty, no special chars, ≤100)

Before (ASCII art - 180 tokens):

Copy┌─────────┐
│  Auth?  │
└────┬────┘
     ▼
┌─────────┐
│ Valid?  │
└──┬───┬──┘
   Y   N

After (numbered - 36 tokens):

Copy1. Check auth
2. Valid → YES: Process | NO: Reject

Common Fixes

See TEMPLATES.md for copy-paste templates.