agentsoptimizelisted

# /agents optimize Refactor of a single `AGENTS.md` file (project root, package root, or consumer template) into the Thin-Root contract: hard char caps, ≥ 40 % substantive-pointer ratio, Capabilities-over-Structure Iron Law, mandatory emergency-triage block. Propagates the result to the multi-tool stubs the consumer ships (`copilot-instructions.md`, `CLAUDE.md`, `GEMINI.md`, `.cursorrules`) per the symlink-or-stub strategy. **Suggest only — never auto-apply.** **Source of truth:** the canonical contract lives in [`agents-md-thin-root`](../../skills/agents-md-thin-root/SKILL.md); the long-form anatomy lives in [`agents-md-anatomy`](../../contexts/contracts/agents-md-anatomy.md). This command orchestrates the diagnose-and-propose flow, it does not restate the contract. ## When to invoke - Lint emits FAIL or WARN on `AGENTS.md` size, pointer-ratio, or path-enumeration. - A new section feels like it belongs at the root and you want a pre-flight check before adding it. - A monorepo grew a 6 KB root `AGENTS.md` because every package appended its own section. - Migrating from a hand-grown `AGENTS.md` (path enumerations, no emergency triage) to the package's contract. ## Steps ### 1. Identify the target file Default: the AGENTS.md the user is editing right now. If unclear, ask: > 1. project root — `AGENTS.md` > 2. consumer template — `.agent-src.uncondensed/templates/AGENTS.md` > 3. package root — `AGENTS.md` of `event4u/agent-config` itself > 4. monorepo package — `<