create-agents-file

Create a concise AGENTS.md that gives AI coding agents the minimum context needed to work effectively in this project. The file loads on every session — every line competes with conversation history for context window space.

Rules

• Every question directed at the user MUST use the AskUserQuestion tool. Never assume or silently decide on behalf of the user.
• Execute steps strictly in order, one at a time.
• Skip steps whose output already exists. If AGENTS.md exists with all sections populated, skip to the review step. If it exists but is incomplete, fill in the gaps.

Step 1: Explore the codebase

Launch two Explore agents in parallel. Agents must use Glob, Grep, and Read exclusively — never Bash commands like ls, cat, find, head, or tail.

Agent A — Project identity (quick):

• package.json — name, description, dependencies, devDependencies, scripts
• Lock files — bun.lock → bun, pnpm-lock.yaml → pnpm, yarn.lock → yarn, package-lock.json → npm
• README or existing documentation
• Existing AGENTS.md / CLAUDE.md
• Top-level config files (tsconfig, eslint/biome, vitest/jest, playwright, tailwind, etc.)