Agentic system

A reusable Claude Code multi-agent setup: 1 coordinator + 5 specialists + 6 team recipes + delegation policy. Drop it into any project and Claude Code will route every prompt through structured dispatch — token-economical, parallel by default, drift-resistant.

What's inside

agentic-system/
├── README.md                  ← this file
├── INSTALL.sh                 ← installer (idempotent)
├── REFINE.md                  ← project-specific tuning guide
├── agents/                    ← 6 agent definitions
│   ├── coordinator.md
│   ├── analyst.md
│   ├── architect.md
│   ├── builder.md
│   ├── explorer.md
│   └── reviewer.md
├── teams/                     ← 6 team recipes
│   ├── audit.md
│   ├── feature.md
│   ├── bugfix.md
│   ├── refactor.md
│   ├── research.md
│   └── cleanup.md
├── CLAUDE.md.template         ← delegation policy snippet
└── settings.json.template     ← optional Claude Code settings

Install into any project

git clone https://github.com/Unrecordedxyz/agentic-system.git /tmp/agentic-system
cd /path/to/your/project
/tmp/agentic-system/INSTALL.sh

Or, if you've vendored agentic-system/ into your project:

cd /path/to/your/project
./agentic-system/INSTALL.sh

The installer copies agents/ and teams/ into your project's .claude/, appends the delegation policy to your CLAUDE.md (creating it if missing), and optionally seeds .claude/settings.local.json. Idempotent: safe to re-run.

Flags:

• --force — overwrite existing .claude/agents/ and .claude/teams/ files.
• --dry-run — print what would change, write nothing.
• --no-claude-md — skip the CLAUDE.md append.
• --no-settings — skip the settings.local.json seed.

How it works (per prompt)

1. Claude Code loads CLAUDE.md automatically. The delegation policy section instructs the main thread to either respond directly (trivial), invoke a team (recurring shape), dispatch a specialist (focused task), or hand off to the coordinator (multi-step).
2. Specialists have whitelisted tools — they cannot drift outside their role mechanically.
3. Teams in .claude/teams/ are dispatch recipes the coordinator (or main thread) reads to spawn the right pipeline.
4. The coordinator can autonomously create a new project-specific team file when it spots a reusable pattern, saving plan-decomposition tokens on future similar tasks.

After install

Read REFINE.md for tuning the system to your project's specifics (project-context block in coordinator.md, project-specific teams, etc.).

Updating

Re-run the installer with --force to pull in upstream changes. Project-specific teams (those you've added in .claude/teams/ not present in agentic-system/teams/) are preserved.