smart-initlisted
Install: claude install-skill tkolleh/skills
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