agents-md-pro

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

1. Token efficiency - Every word justifies its cost
2. Commands over explanations - Show, don't tell
3. Reference configs - Point to .eslintrc, never duplicate
4. Model-agnostic - Universal terminology only
5. 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