name

agents-md-pro

description

Create, optimize, update, and validate AGENTS.md files with maximum token efficiency. Use when the user asks to (1) create new AGENTS.md files for any repository, (2) optimize/condense existing AGENTS.md to reduce token count, (3) update/refresh AGENTS.md to sync with codebase changes, (4) validate AGENTS.md quality and completeness, or (5) improve AGENTS.md files to be more effective for AI agents. Always generates token-efficient, condensed output focused on actionable commands and patterns while maintaining model-agnostic language.

AGENTS.md Pro

Create token-efficient AGENTS.md files that maximize clarity with minimal tokens.

Core Principles

Token efficiency - Every word justifies its cost
Commands over explanations - Show, don't tell
Reference configs - Point to .eslintrc, never duplicate
Model-agnostic - Universal terminology only
Condensed default - Always minimal output

Input

Required: Project directory path If missing: Request from user

Workflow Router

Map user request to workflow:

Create → workflows.md
Optimize/condense → workflows.md
Update/refresh → workflows.md
Validate → workflows.md

Quick Reference

Output template - Standard repo:

# [Project] | [Tech Stack]
## COMMANDS
- Dev: `cmd` | Build: `cmd` | Test: `cmd` | Lint: `cmd --fix`
## STRUCTURE
- `dir/` - purpose
## PATTERNS
[1-2 key patterns with minimal code]
## CODE STYLE
See `.eslintrc`, `.prettierrc`
## DOMAIN
| Term | Definition |
## SECURITY
[Auth/validation only]
## GIT
Format: `convention`

Line limits:

Standard: ≤150 lines
Monorepo root: ≤50 lines
Sub-project: ≤100 lines

Target tokens:

Standard: 500-800
Monorepo root: 300-400
Sub-project: 400-600

Resources

Load as needed:

Workflows: workflows.md - All 4 workflows with step-by-step procedures
Optimization: optimization-patterns.md - Token reduction techniques
Validation: validation-rules.md - Quality checklist and scoring
Anti-patterns: anti-patterns.md - Common bloat patterns to avoid