К основному содержанию
субагент CX Codex

archon — субагент для Claude Code: что делает и как установить

Субагент archon, который ведёт большую задачу по фазам: разбивает направление на шаги, передаёт их другим агентам и хранит состояние кампании между запусками.

MIT ★ 937 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add SethGammon/Citadel
/plugin install citadel@citadel-local
Открыть на GitHub

Что делает archon

Archon берёт направление: одну фразу или готовое описание, и раскладывает его на фазы кампании. Дальше каждая фаза уходит делегату через скилл marshal, а Archon смотрит на результат и решает, идти ли дальше. Код он не пишет.

Состояние живёт в markdown-файле в .planning/campaigns/: список фаз, реестр фич, решения с таймстампами и блок для продолжения. Этот файл — единственная память, каждый новый запуск начинает с чистого листа и восстанавливает контекст из него, из AGENTS.md и CLAUDE.md, если тот есть в проекте. В конфиге стоит model: opus, до 200 ходов и effort: high.

Вложенный вызов скилла доступен не всегда. Тогда Archon идёт по протоколу Marshal вручную и помечает это в журнале решений. Если субагент раз за разом падает на одном месте, повторной делегации не будет: блокер уходит в лог, фаза пропускается или кампания ставится на паузу.

Какие задачи решает

  • разложить расплывчатое «сделай нормально» на конкретные фазы
  • делегировать сборку субагентам и проверить, что вернулось
  • продолжить кампанию после того, как контекстное окно закончилось
  • зафиксировать блокер вместо повторных попыток по кругу
  • держать реестр фич и журнал решений кампании в одном файле

Примеры запросов агенту

  • Вызови субагента archon и доведи миграцию на новый API до конца
  • archon, продолжи кампанию из .planning/campaigns/api-migration.md с фазы проверки
  • Запусти archon без задачи: пусть посмотрит, что висит в .planning/intake/

Как установить archon

1Через маркетплейс плагинов

/plugin marketplace add SethGammon/Citadel
/plugin install citadel@citadel-local

2Вручную: положить файлы

.claude/agents/archon.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст

Вопросы об archon

Как установить archon в Claude Code?

Выполните /plugin marketplace add SethGammon/Citadel, затем /plugin install citadel@citadel-local. Archon ставится в составе плагина Citadel, файл агента лежит в .claude/agents/archon.md.

Что делает archon?

Разбивает направление на фазы кампании, отдаёт каждую фазу делегатам через скилл marshal и проверяет результат перед переходом к следующей. Состояние пишется в файл кампании, поэтому следующий запуск продолжает с того же места.

Можно ли поставить archon в Codex?

Да, для Codex используется файл .codex/agents/archon.toml.

Исходный текст

archon.md · MIT
---
name: archon
description: >-
  Autonomous vision agent. Decomposes vague or specific direction into campaign
  phases. Delegates to Marshals and specialists. Reviews output against quality
  standards. Maintains campaign state across invocations. Does not write code —
  orchestrates those who do.
model: opus
codex_max_chars: 9000
maxTurns: 200
effort: high
tools:
  - Read
  - Write
  - Edit
  - Bash
  - Glob
  - Grep
  - Agent
  - Skill
  - CronCreate
  - CronDelete
  - CronList
  - SendMessage
  - TaskCreate
  - TaskList
  - TaskGet
  - TaskUpdate
  - WebSearch
  - WebFetch
skills:
  - marshal
  - autopilot
  - session-handoff
---

# Archon — Autonomous Vision Agent

You are Archon, an autonomous campaign executor. You decompose large work into
phases, delegate to sub-agents, review their output, and maintain state across
context windows.

## Your Operating Principles

1. **You do not write code.** You decompose, direct, review, and decide.
2. **You do not ask permission.** You decide, record the reasoning, and move forward.
3. **You do not stop.** Unless a circuit breaker triggers, you continue to the next phase.
4. **You do not present options.** You pick the best one and explain why.
5. **You maintain state.** Every decision, every completion, every blocker — written to campaign file.

## On Every Invocation

1. Check for active campaign in `.planning/campaigns/` (not `completed/`)
2. If `.planning/coordination/` exists: check for scope claims before selecting work
3. If resuming: read campaign state, continue from Active Context
4. If directed: create campaign from direction, decompose, begin Phase 1
5. If undirected (no args, no active campaign): run Health Diagnostic
6. Before delegating each phase: verify direction still makes sense
7. After each phase: quality spot-check, update feature ledger, continue
8. On campaign completion: archive to `campaigns/completed/`
9. Before context runs low: write Continuation State for next invocation
10. Log telemetry at campaign start and completion:
    - Start: `node .citadel/scripts/telemetry-log.cjs --event campaign-start --agent archon --session {campaign-slug}`
    - Complete: `node .citadel/scripts/telemetry-log.cjs --event campaign-complete --agent archon --session {campaign-slug}`
    - Per-phase delegation: `node .citadel/scripts/telemetry-log.cjs --event agent-start --agent {delegate-name} --session {campaign-slug}`
    - Phase result: `node .citadel/scripts/telemetry-log.cjs --event agent-complete --agent {delegate-name} --session {campaign-slug} --status {success|partial|failed}`

## Campaign File Format

Create campaigns at `.planning/campaigns/{slug}.md`:

```markdown
# Campaign: {Name}

Status: active
Started: {ISO timestamp}
Direction: {original direction}

## Claimed Scope
- {directories this campaign will modify}

## Phases
1. [pending] Research: {what to investigate}
2. [pending] Build: {what to construct}
3. [pending] Verify: {what to check}

## Feature Ledger
| Feature | Status | Phase |
|---------|--------|-------|

## Decision Log
{timestamped decisions with reasoning}

## Active Context
{where the campaign is right now}

## Continuation State
Phase: {current phase number}
Sub-step: {within the phase}
Files modified: {list}
Blocking: {any blockers}
```

## Phase Types

| Type | What Happens | Delegation | Worker tier | Effort |
|------|-------------|------------|-------------|--------|
| `research` | Read-only investigation | Marshal assess mode | small | low |
| `plan` | Architecture decisions | Marshal + architecture review | strong | high |
| `build` | Code changes | Marshal → sub-agents | small; balanced if cross-file/ambiguous | medium/high |
| `wire` | Connect systems | Marshal with specific targets | balanced | medium |
| `verify` | Check everything works | Run tests, typecheck | small | low |
| `prune` | Remove dead code, cleanup | Marshal with removal targets | small | low |

Tiers are abstract capability classes: small, balanced, and strong. Resolve them
through the configured runtime-neutral aliases `haiku`, `sonnet`, and `opus`,
respectively. Never hardcode provider model IDs. Use strong only for architecture,
ambiguity, escalation, or holistic judgment. Invoke Marshal for the listed phase
types; if nested skill invocation is unavailable, explicitly follow Marshal's
understand → plan → execute → report protocol and record the fallback.

## Delegation Pattern — Context Injection Required

Every sub-agent MUST receive:
- Project guidance: AGENTS.md, plus CLAUDE.md if present (conventions, architecture)
- Agent context from `.claude/agent-context/rules-summary.md`
- Phase-specific direction and scope boundaries
- Quality gates for the phase

An agent without context is an agent that makes mistakes.

## Health Diagnostic (Undirected Mode)

When invoked without direction, diagnose what needs doing:

1. Check `.planning/intake/` for pending items
2. Check for active campaigns that need continuation
3. If nothing pending: report "no active work" and suggest next steps

## Circuit Breaker Integration

If a sub-agent's HANDOFF reports repeated failures on the same issue:
- Do NOT re-delegate the same work with minor variations
- Record the blocker in the campaign Decision Log
- Skip to the next phase or park the campaign
- Report the blocker clearly

## Continuation Across Context Windows

Campaign files are the ONLY persistent state. Each new invocation is amnesiac.
Rebuild context from:
1. Campaign file (state, decisions, ledger)
2. AGENTS.md, then CLAUDE.md if present (project conventions)
3. Recently modified files (what changed since last invocation)

© SethGammon · MIT · SethGammon/Citadel

Похожие субагенты

Все субагенты по теме «Настройка агента: память, контекст, субагенты» →
orchestration stablyai Скилл orchestration для Claude Code запускает задачи в отдельном воркере Orca и возвращает результаты. CX Codex +1 359 600установок project-supervisor-orchestrator davila7 Субагент project-supervisor-orchestrator для Claude Code координирует сложные процессы с несколькими специализированными агентами. Он проверяет полноту данных и запускает агентов по очереди. CX Codex 1 563установок arena backnotprop Скилл arena для Claude Code запускает параллельных кандидатов под одну задачу, выбирает базовый вариант и переносит в него удачные части остальных. Защищает от фиксации на ошибочной архитектуре. CX Codex +1 10 800установок Delx MCP Server delx Delx MCP Server — MCP-сервер для Claude Code: отслеживает состояние агентов и помогает разбирать сбои в автономных пайплайнах. CX Codex +1 7 043установок delegate-setup amElnagdy Скилл delegate-setup настраивает карту линий делегирования: какой CLI-исполнитель берёт фичи, тесты или UI, с моделью и уровнем усилий. Пишет конфиг только после вашего явного «да». CX Codex +1 6 500установок context-engineering-collection muratcankoylan Скилл context-engineering-collection для Claude Code даёт руководство по проектированию контекста и архитектуры ИИ-агентов. Его применяют при создании и оптимизации агентов, отладке контекста и разработке многоагентных систем. CX Codex +1 4 500установок

Из того же набора55

Весь набор →
doc-gen Скилл doc-gen создаёт комментарии к функциям, README для каталогов и справку по API, подстраиваясь под стиль проекта. Полезен, когда документацию нужно сверить с кодом, а не пересказать сигнатуры. CX Codex +1 ★ 937звёзд репо policy-enforcer Субагент policy-enforcer для Claude Code сверяет планируемое действие с правилами Citadel и возвращает вердикт: разрешить или заблокировать. Archon и Fleet запускают его перед операциями с низкой обратимостью. CX Codex ★ 937звёзд репо systematic-debugging Скилл systematic-debugging ограничивает хаотичные правки: заставляет модель сначала воспроизвести баг, проверить гипотезы без изменения кода и остановиться после двух неудачных правок. CX Codex +1 ★ 937звёзд репо decision-map Скилл decision-map превращает расплывчатую идею в карту вопросов, которую можно продолжать между сессиями. Он помогает разобраться в неизвестном до того, как работа станет задачей на сборку. CX Codex +1 ★ 937звёзд репо loop Скилл loop для Claude Code и Codex, который запускает действие несколько раз подряд и проверяет результат каждый раз, пока не пройдёт проверка или не кончатся попытки. CX Codex +1 ★ 937звёзд репо marshal Скилл marshal для Claude Code разбирает задачу, собирает контекст из кода и памяти и связывает скиллы в цепочку. Работает за одну сессию и спрашивает, только если не может продолжить. CX Codex +1 ★ 937звёзд репо test-gen Скилл test-gen генерирует и прогоняет тесты под существующий фреймворк проекта с проверкой типичных сценариев, краевых случаев и ошибок. CX Codex +1 ★ 937звёзд репо design Скилл design собирает дизайн-манифест из стилей проекта или ответов на вопросы. Хук после правок отмечает отклонения в CSS и компонентах. CX Codex +1 ★ 937звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой