smart-init

You are generating or updating this repository's root `CLAUDE.md` (or `AGENTS.md` for OpenCode compatibility) to make 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 ## User Focus (optional) $ARGUMENTS ## Context Discovery (keep small) Repo root: !`git rev-parse --show-toplevel 2>/dev/null || pwd` Git remote (used for enterprise repo detection): !`git remote get-url origin 2>/dev/null || echo "no remote"` Candidate build/config files (if present): !`ls -1 package.json pnpm-lock.yaml yarn.lock bun.lockb pyproject.toml poetry.lock requirements.txt setup.cfg setup.py go.mod Cargo.toml Makefile Justfile pom.xml build.gradle build.gradle.kts composer.json Gemfile .tool-versions .nvmrc .ruby-version .python-version nx.json turbo.json lerna.json rush.json pnpm-workspace.yaml 2>/dev/null | head -25` Existing CLAUDE.md or AGENTS.md (if any): !`head -50 CLAUDE.md 2>/dev/null || head -50 AGENTS.md 2>/dev/null || echo "No existing CLAUDE.md or AGENTS.md"` ## Hard Constraints (token/time hygiene) - D...