agent-project

# Set Up Agents on a Project Create the portable instruction and skill layer once, then add only the tool-specific configuration the project needs. ## Workflow 1. **Create the Shared Layer**: ```bash mkdir -p .agents/skills .agents/prompts touch AGENTS.md ``` Start `AGENTS.md` from the minimal [project template](templates/AGENTS.md), then put project-wide rules there, store reusable project skills in `.agents/skills/<name>/SKILL.md`, and keep prompt files in `.agents/prompts/` (globally gitignored by default). 1. **Add Tool-Specific Files Only When Needed**: - **Antigravity**: use `.agents/settings.json` for workspace settings and `.agents/mcp_config.json` for MCP. It respects `.gitignore`; do not invent an `.antigravityignore`. - **Codex**: use `.codex/config.toml` for trusted project overrides and MCP. Codex reads `AGENTS.md` and `.agents/skills` natively. - **OpenCode**: use `opencode.json` for settings and MCP. OpenCode reads `AGENTS.md` and `.agents/skills` natively. - **Claude**: create `CLAUDE.md` containing `@AGENTS.md`, link `.claude/skills` to `../.agents/skills`, and use `.mcp.json` for project MCP servers. - **Copilot**: Copilot CLI reads `AGENTS.md` and `.agents/skills` natively. Use `.github/copilot-instructions.md` only for additional repository-wide Copilot instructions and `.github/mcp.json` or `.mcp.json` for MCP. 1. **Inspect Before Creating Links**: Never replace an existing `CLAUDE.md` or `.claude/skills` path without revi...