MISSION BRIEFING

GETTING STARTED

Everything you need to deploy the team and start running operations.

PREREQUISITES

Before deploying agents, you need Claude Code installed on your machine.

1

Install Claude Code

Follow the official installation guide from Anthropic. Claude Code works on macOS and Linux.

2

Verify it works

Open your terminal and run claude --version.

3

Have git installed

The installer uses git to fetch assets. Run git --version to confirm it's available.

WHAT IS AGENTS ASSEMBLE

Claude Code is Anthropic's CLI for working with Claude in your terminal and IDE. It reads files, runs commands, and follows project-specific instructions—but it's only as good as the context you give it.

Agents Assemble gives Claude Code a team of specialized agents. Each agent is an opinionated persona that orchestrates skills into end-to-end workflows—code review, debugging, feature development—delivering structured, repeatable results instead of ad-hoc prompting.

ASSET TYPES

Two types. Agents are the operators. Skills are their equipment.

AGENTS

Agents are AGENT.md files that define opinionated personas. Each agent has a specialty—Aegis for code review, Deadeye for debugging, Ironclad for feature development—and knows exactly which skills to deploy.

When you install an agent, the installer automatically resolves and installs all required skills. Agents can leverage worktrees for isolation and subagents for parallel work.

~/.claude/skills/
ironclad/ AGENT.md
aegis/ AGENT.md
deadeye/ AGENT.md

SKILLS

Skills are SKILL.md files that teach Claude specific workflows. They live in ~/.claude/skills/ and are available in every Claude Code session.

Skills define structured processes like severity-rated code reviews, TDD workflows, or planning sessions. Agents compose these skills into larger operations.

~/.claude/skills/
code-review/ SKILL.md
tdd/ SKILL.md
planning/ SKILL.md

DEPLOYMENT

One command. Pick your agents. The installer handles dependency resolution.

mission-control
$curl -fsSL assemble.sporich.dev/install.sh | bash

Deployment Sequence

1

Cache the repository

Fetches the latest assets from GitHub into ~/.agents-assemble. Subsequent runs pull updates automatically.

2

Select your team

You'll see a numbered list of all agents and skills. Enter the numbers of the ones you want, or type all to deploy everything.

3

Resolve dependencies and install

Assets are symlinked to ~/.claude/skills/. Agent dependencies are automatically resolved and installed.

4

Deployment summary

See exactly what was installed and where it went.

FIRST MISSION

Deploy Aegis and run your first code review operation.

1

Deploy the Aegis agent

The installer automatically pulls in the code-review skill that Aegis requires.

$ curl -fsSL assemble.sporich.dev/install.sh | bash
2

Open Claude Code in any project

$ cd your-project && claude
3

Initiate review

Aegis will run a multi-layered code review with severity ratings, file references, and actionable suggestions.

FILE LOCATIONS

Where each asset type deploys on your system.

TypeLocationScope
AGENTS~/.claude/skills/<name>/AGENT.mdGlobal — all sessions
SKILLS~/.claude/skills/<name>/SKILL.mdGlobal — all sessions

CONTRIBUTING

Want to add your own agent or skill? Here's the process:

  1. 1Create a .md file in the right directory (agents/<name>/AGENT.md or skills/<group>/<name>/SKILL.md).
  2. 2Add YAML frontmatter with name, description, and tags. Agents also need requires and features.
  3. 3Run bash scripts/build-catalog.sh to regenerate the catalog.
  4. 4Submit a PR to the GitHub repo.