# Setup

This repo is three plain-text subagent definitions for Claude Code (`agents/orchestrator.md`, `agents/worker.md`, `agents/advisor.md`). There is no application code, no build step, and nothing to compile. Setup means: install Claude Code, then copy three files into a folder.

## What you need

| Requirement | Why | Have it already? |
|---|---|---|
| A terminal (macOS Terminal, Windows PowerShell, or Linux shell) | To run the install command and the `cp`/`copy` step | Check by opening it |
| Claude Code CLI | This repo's files are Claude Code subagent definitions — they only do anything inside a Claude Code session | Run `claude --version` |
| An Anthropic account (Claude.ai login, or an Anthropic Console API key) | Claude Code needs to authenticate to run any model at all | You'll be prompted on first `claude` launch if you don't have one |
| git (to clone this repo) | To get the files onto your machine | Run `git --version` |
| **NOT needed:** Docker | Nothing here runs in a container | — |
| **NOT needed:** GPU | These are text prompt files, not models | — |
| **NOT needed:** Python, Node project deps, `pip install`, `npm install` in this repo | The repo has no `requirements.txt` / `package.json` — the only npm install is for the Claude Code CLI itself, a global tool, not a project dependency | — |
| **NOT needed:** any paid API key of your own for this repo's content | The three `.md` files are static prompts with no code that calls an API; you only need whatever Claude Code subscription/API access you already use for Claude Code itself | — |

## Install, step by step

### 1. Install git (skip if `git --version` already prints a version)

macOS (Homebrew):
```bash
brew install git
```
If you don't have Homebrew yet:
```bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```

Windows (PowerShell, using winget):
```powershell
winget install --id Git.Git -e --source winget
```

Linux (Debian/Ubuntu):
```bash
sudo apt-get update && sudo apt-get install -y git
```

Check it worked:
```bash
git --version
```
Expected output: something like `git version 2.x.x`.

### 2. Install Claude Code (skip if `claude --version` already prints a version)

macOS / Linux:
```bash
curl -fsSL https://claude.ai/install.sh | bash
```

Windows (PowerShell):
```powershell
irm https://claude.ai/install.ps1 | iex
```

Alternative for any OS with Node.js 18+ already installed:
```bash
npm install -g @anthropic-ai/claude-code
```

Check it worked:
```bash
claude --version
```
Expected output: a version string, e.g. `1.x.x (Claude Code)`.

### 3. Clone this repo

```bash
git clone <this-repo-url> orchestrator-agents
cd orchestrator-agents
```

Check it worked:
```bash
ls agents/
```
Expected output:
```
advisor.md  orchestrator.md  worker.md
```

### 4. Copy the agent files into your Claude Code global agents directory

macOS / Linux:
```bash
mkdir -p ~/.claude/agents
cp agents/*.md ~/.claude/agents/
```

Windows (PowerShell):
```powershell
New-Item -ItemType Directory -Force -Path "$HOME\.claude\agents" | Out-Null
Copy-Item .\agents\*.md "$HOME\.claude\agents\"
```

Check it worked:
```bash
ls ~/.claude/agents | grep -E "orchestrator|worker|advisor"
```
Expected output:
```
advisor.md
orchestrator.md
worker.md
```

## Configure

Nothing to configure. There are no environment variables, config files, or secrets in this repo — the `.md` files are the entire product. The only account interaction is the normal Claude Code login/authentication you already do to use `claude` at all (handled by the `claude` CLI itself on first run, not by anything in this repo).

If you want to point the agents at different models than the frontmatter ships with (`model: sonnet` in `worker.md`, `model: fable` in `orchestrator.md` and `advisor.md`), edit those lines directly in `~/.claude/agents/*.md` after copying — see the README's "Make it your own" section.

## Run it

1. Start (or restart) a Claude Code session anywhere on your machine:
```bash
claude
```
2. Inside the session, invoke one of the subagents by name, for example:
```
@worker rename the variable `foo` to `bar` in src/app.js
```

Success looks like: Claude Code recognizes `@worker` (or `@orchestrator`, `@advisor`) as a known subagent — it responds in that agent's voice/role instead of saying it doesn't recognize the name. If you started your session before copying the files, exit (`Ctrl+D` or `/exit`) and run `claude` again so it picks up the new agents.

## Troubleshooting

1. **`claude: command not found`** — the installer didn't add it to your `PATH`, or your shell hasn't reloaded. Close and reopen your terminal, or run `source ~/.zshrc` (macOS default shell) / `source ~/.bashrc`, then retry `claude --version`.
2. **`@worker` / `@orchestrator` / `@advisor` not recognized inside a session** — the files aren't in the right place, or the session started before you copied them. Confirm with `ls ~/.claude/agents/` (macOS/Linux) or `dir $HOME\.claude\agents` (Windows), then start a brand new `claude` session — subagents are loaded at session start, not live-reloaded.
3. **Claude Code prompts for login / says you're not authenticated** — this is unrelated to this repo; it's your Claude Code account setup. Run `claude` and follow the on-screen login prompt (Claude.ai account or Anthropic Console API key), then retry.