agentsinitlisted

# /agents init Interactive initializer that **creates** `AGENTS.md` and `.github/copilot-instructions.md` in the consumer project from the package-shipped templates (`.augment/templates/AGENTS.md` and `.augment/templates/copilot-instructions.md`), filling in placeholders based on auto-detected stack + user answers. Tool-agnostic by design — AGENTS.md is the universal entry point honoured by Claude Code, Cursor, Codex, Copilot, Augment and Gemini. The `.github/copilot-instructions.md` companion is generated alongside because GitHub Copilot reads its own file path. Other tool stubs (`CLAUDE.md`, `GEMINI.md`, `.cursorrules`) follow the symlink-or-stub strategy in [`agents-md-anatomy § Multi-tool symlink strategy`](../../contexts/contracts/agents-md-anatomy.md#multi-tool-symlink-strategy). Use when either file is missing, or the user wants to start over with a clean scaffold. For tuning an existing file, use `/agents optimize`. ## Steps ### 1. Precondition checks ```bash ls AGENTS.md .github/copilot-instructions.md 2>/dev/null ls .augment/templates/AGENTS.md .augment/templates/copilot-instructions.md ``` Outcomes: | State | Action | |---|---| | Both targets missing | Proceed | | One exists, other missing | Ask whether to fill only the missing one | | Both exist | Ask confirmation — offer `/agents optimize` instead | | Template missing | Abort with "package not installed" hint | ### 2. Auto-detect stack Read (in this order) and record what is found: - `composer.json` →