agents-md-setuplisted

# AGENTS.md Setup ## Two Modes - **Create:** no instruction file exists yet. Run the interview below and write it. - **Optimize:** a file already exists. Read it first, then audit it: flag lines that are generic (any AI does this by default), missing boundaries, stale facts, and gaps the interview questions below would fill. Propose the edits, apply on approval, and keep what already works. ## The Job Most people use powerful AI agents that know nothing about them. Every session starts from zero: wrong tone, wrong assumptions, wrong priorities, re-explaining the same context. The fix is a written working context: a short instruction file the agent reads before it starts working. This skill interviews the user, writes that file, installs it where their agent reads it, and verifies it works. ## Step 1: Find Out Where It Will Live Ask which AI tool they mainly use, then target the right file: | Tool | File the agent reads | |---|---| | Claude Code | `CLAUDE.md` in the project folder, or `~/.claude/CLAUDE.md` for everything | | Codex | `AGENTS.md` in the project folder, or `~/.codex/AGENTS.md` for everything | | ChatGPT | Custom instructions (settings), pasted text | | Claude apps | Project instructions or preferences, pasted text | | Other or several | Write one canonical Markdown file; the user pastes or links it per tool | If they use more than one tool, write one source file and produce a copy or paste-block for each surface. Do not invent file locations for tools yo