agents-md-pro
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
More from alexander-danilenko/ai-skills
nestjs-expert
Use when building NestJS applications requiring modular architecture, dependency injection, or TypeScript backend development. Invoke for modules, controllers, services, DTOs, guards, interceptors, TypeORM/Prisma.
23nextjs-developer
Use when building Next.js 14+ applications with App Router, server components, or server actions. Invoke for full-stack features, performance optimization, SEO implementation, production deployment.
22code-documenter
Use when adding docstrings, creating API documentation, or building documentation sites. Invoke for OpenAPI/Swagger specs, JSDoc, doc portals, tutorials, user guides.
19test-master
Use when writing tests, creating test strategies, or building automation frameworks. Invoke for unit tests, integration tests, E2E, coverage analysis, performance testing, security testing.
19csharp-developer
Use when building C# applications with .NET 8+, ASP.NET Core APIs, or Blazor web apps. Invoke for Entity Framework Core, minimal APIs, async patterns, CQRS with MediatR.
18rag-architect
Use when building RAG systems, vector databases, or knowledge-grounded AI applications requiring semantic search, document retrieval, or context augmentation.
18