# AGENTS-SUPPORTED.md — agents covered by `install.sh`

Each row maps an agent to the file (or files) the installer writes into the target project. Same content; different paths because each agent reads a different location.

| Agent | Files written | Notes |
|---|---|---|
| **Claude Code** | `.claude/skills/sd-design/SKILL.md` (with YAML frontmatter) + `CLAUDE.md` | Skill auto-loads on matching triggers. `CLAUDE.md` is a project-wide fallback. |
| **OpenAI Codex** | `AGENTS.md` | Codex reads `AGENTS.md` automatically from project root. |
| **Cursor** | `.cursor/rules/sd-design.mdc` + `.cursorrules` | New-format rules under `.cursor/rules/`; legacy `.cursorrules` for older versions. |
| **Windsurf** | `.windsurf/rules/sd-design.md` + `.windsurfrules` | New + legacy formats. |
| **GitHub Copilot** | `.github/copilot-instructions.md` | Copilot reads this file when generating code. |
| **Gemini CLI** | `GEMINI.md` | Gemini's project-wide system prompt. |
| **Aider** | `CONVENTIONS.md` | Aider reads `CONVENTIONS.md` when present. |
| **Continue** | `.continuerules` | Continue's project rules file. |
| **Kiro** | `.kiro/steering/sd-design.md` | Kiro's steering files directory. |
| **Universal / fallback** | `AGENTS.md` | The [agents.md](https://agents.md) standard. Always installed by `--auto` / default mode. |

## Install modes

```bash
# 1. Auto-detect (default): writes AGENTS.md + files for any agent dir present
curl -fsSL https://sd.michelvalles.com/install.sh | bash

# 2. All agents (writes every supported file)
curl -fsSL https://sd.michelvalles.com/install.sh | bash -s -- --all

# 3. Specific agents only
curl -fsSL https://sd.michelvalles.com/install.sh | bash -s -- --agents=claude,cursor,gemini
```

Valid agent IDs (CSV in `--agents=`):

`claude  codex  cursor  windsurf  copilot  gemini  aider  continue  kiro  universal`

## Adding a new agent later

If you started with Claude Code only and now also want Cursor + Codex:

```bash
curl -fsSL https://sd.michelvalles.com/install.sh | bash -s -- --agents=cursor,codex
```

The installer overwrites existing files (it always writes the latest version from the host).

## Why same content, different filenames

Each agent looks in a different place for its rules. We could put the rules in one place and symlink, but symlinks break on Windows / many shells / many CI systems. Duplicating ~9 KB of text is cheaper than the support burden of symlinks.

If you commit these files to git, your repo gets ~9 KB × (agents you target) of duplicate text. That is the actual cost.

## Tools NOT covered (and why)

- **Sourcegraph Cody** — reads `AGENTS.md` (covered) or `.sourcegraph/AGENTS.md`. Adding `.sourcegraph/` if asked.
- **Cline** — reads `AGENTS.md` (covered).
- **Pi**, **Trae**, **Qoder**, **Rovo Dev**, **OpenCode** — not yet stable / not widely used; add by request.

To request support for another agent, open the issue at the source repo or extend `install.sh` locally — the `install_<name>()` helper pattern makes it trivial.