# Universal Agent Setup

This kit works through one shared workflow and thin adapters for each coding agent.

## Shared Source

`skills/feynman/SKILL.md` is the source of truth. Keep the reference files in `skills/feynman/refs/` next to it so agents can load only the workflow they need.

## Adapter Matrix

| Agent | Reads | What to copy |
|---|---|---|
| Codex | `AGENTS.md` | `AGENTS.md` + `skills/feynman` |
| Antigravity | `AGENTS.md`, `GEMINI.md` | `AGENTS.md` + `GEMINI.md` + `skills/feynman` |
| Claude Code | `SKILL.md`, `CLAUDE.md` | `skills/feynman` into `.claude/skills/` or `~/.claude/skills/`; optional `agents/` |
| Cursor | `.cursor/rules/*.mdc`, `AGENTS.md` | `.cursor/rules/feynman-research.mdc` + `AGENTS.md` + `skills/feynman` |

## Project Install

```bash
cp AGENTS.md CLAUDE.md GEMINI.md /path/to/project/
mkdir -p /path/to/project/skills /path/to/project/.cursor/rules
cp -R skills/feynman /path/to/project/skills/
cp .cursor/rules/feynman-research.mdc /path/to/project/.cursor/rules/
```

PowerShell:

```powershell
Copy-Item AGENTS.md, CLAUDE.md, GEMINI.md C:\path\to\project\
New-Item -ItemType Directory -Force C:\path\to\project\skills, C:\path\to\project\.cursor\rules
Copy-Item -Recurse skills\feynman C:\path\to\project\skills\
Copy-Item .cursor\rules\feynman-research.mdc C:\path\to\project\.cursor\rules\
```

## Claude Code Personal Install

```bash
mkdir -p ~/.claude/skills ~/.claude/agents
cp -R skills/feynman ~/.claude/skills/
cp agents/feynman-*.md ~/.claude/agents/
```

## Codex Check

Run from a project root that contains `AGENTS.md`:

```bash
codex --ask-for-approval never "Summarize the current instructions."
```

Expected: Codex mentions the Feynman workflow and points to `skills/feynman/SKILL.md`.

## Cursor Check

Open Cursor in the project. The rule should appear as an available project rule named `feynman-research`.

## Antigravity Check

Open Antigravity in the project root. Ask the agent to list its research workflow instructions; it should cite `AGENTS.md`, `GEMINI.md`, and `skills/feynman/SKILL.md`.

## Compatibility References

- Codex `AGENTS.md`: <https://developers.openai.com/codex/guides/agents-md>
- Agent Skills spec: <https://agentskills.io/specification>
- Claude Code skills: <https://code.claude.com/docs/en/skills>
- Cursor rules: <https://docs.cursor.com/en/context>
- Antigravity rules/workflows: <https://antigravity.google/docs/rules-workflows>