agents-md-generatorlisted

# AGENTS.md Generator Generate hierarchical AGENTS.md structures optimized for AI coding agents with minimal token usage. ## Core Principles 1. **Root AGENTS.md is LIGHTWEIGHT** - Only universal guidance, links to sub-files (~100-200 lines max) 2. **Nearest-wins hierarchy** - Agents read closest AGENTS.md to file being edited 3. **JIT indexing** - Provide paths/globs/commands, NOT full content 4. **Token efficiency** - Small, actionable guidance over encyclopedic docs 5. **Sub-folder files have MORE detail** - Specific patterns, examples, commands ## Workflow ### Phase 1: Repository Analysis Analyze and report: 1. **Repository type**: Monorepo, multi-package, or simple? 2. **Tech stack**: Languages, frameworks, key tools 3. **Major directories** needing own AGENTS.md: - Apps (`apps/web`, `apps/api`, `apps/mobile`) - Services (`services/auth`, `services/transcribe`) - Packages (`packages/ui`, `packages/shared`) - Workers (`workers/queue`, `workers/cron`) 4. **Build system**: pnpm/npm/yarn workspaces? Turborepo? Lerna? 5. **Testing setup**: Jest, Vitest, Playwright, pytest? 6. **Key patterns**: Organization, conventions, examples, anti-patterns Present as structured map before generating files. ### Phase 2: Root AGENTS.md Create lightweight root (~100-200 lines): ```markdown # Project Name ## Project Snapshot [3-5 lines: repo type, tech stack, note about sub-AGENTS.md files] ## Root Setup Commands [5-10 lines: install, build all, typecheck all, test all]