AGENTS.md Initialization
Analyze this codebase and create an AGENTS.md file containing:
- •Build/lint/test commands - especially for running a single test
- •Code style guidelines including imports, formatting, types, naming conventions, error handling, etc.
Guidelines
- •Target length: ~150 lines
- •Include Cursor rules (from
.cursor/rules/or.cursorrules) if present - •Include Copilot rules (from
.github/copilot-instructions.md) if present - •If there's already an AGENTS.md at
${path}, improve it
Progressive Disclosure Approach
- •Find contradictions: Identify conflicting instructions and ask which to keep
- •Identify the essentials: Extract what belongs in root AGENTS.md:
- •One-sentence project description
- •Package manager (if not npm)
- •Non-standard build/typecheck commands
- •Anything truly relevant to every single task
- •Group the rest: Organize remaining instructions into logical categories (TypeScript conventions, testing patterns, API design, Git workflow)
- •Create the file structure:
- •Minimal root AGENTS.md with markdown links to separate files
- •Each separate file with relevant instructions
- •Suggested docs/ folder structure
- •Flag for deletion: Identify redundant, vague, or overly obvious instructions
$ARGUMENTS