smart-initlisted

You are generating or updating this repository's root `AGENTS.md` — the canonical, tool-agnostic agent context file — plus a root `CLAUDE.md` that imports it. This makes future coding-agent runs faster and cheaper (reduce exploratory navigation and repeated inference). Optimize for: concise, accurate, actionable, and easy to maintain. ## Research Background This command implements findings from "On the Impact of AGENTS.md Files on the Efficiency of AI Coding Agents" (Lulla et al., 2026): - ~28.6% lower median wall-clock time with AGENTS.md present - ~16.6% lower median output token consumption - Key mechanism: upfront repo structure/conventions reduce exploratory navigation and re-planning loops ## Why Two Files `AGENTS.md` is the tool-agnostic contract, shared by every AI coding agent (Claude Code, Cursor, Copilot, Windsurf, Devin, Cline, OpenCode). `CLAUDE.md` is Claude Code's own memory file — Claude Code reads `CLAUDE.md` natively and does **not** fall back to `AGENTS.md` on its own. Anthropic's documented bridge (`code.claude.com/docs/en/memory`) is a literal import line: ```markdown @AGENTS.md ## Claude Code Use plan mode for changes under `src/billing/`. ``` The `@AGENTS.md` line must be bare text on its own line, outside any code fence — import parsing skips fenced code blocks and inline code spans, so a markdown link like `[@AGENTS.md](AGENTS.md)` or a prose mention does not trigger the import. Never substitute a prose link for the literal import line. Never