К основному содержанию
скилл CX Codex

architect · sethgammon — скилл для Claude Code: что делает и как установить

Скилл architect превращает PRD или описание задачи в архитектурный план с деревом файлов, моделью данных и фазами сборки.

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

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

Что делает architect

Скилл берёт готовый PRD из каталога .planning/ либо читает существующий репозиторий вместе с кратким запросом пользователя. На основе этих данных он формирует файл .planning/architecture-{slug}.md, где расписывает компоненты, структуры данных, граф зависимостей фаз и реестр рисков минимум из двух пунктов.

Для неочевидных развилок вроде выбора базы данных или схемы авторизации скилл сравнивает два-три варианта по рискам и удобству для LLM, фиксируя причину выбора и отброшенные альтернативы. В режиме доработки уже существующего кода Phase 0 фиксирует исходное состояние тестов, а дерево показывает только новые и изменённые файлы.

Код проекта скилл не трогает: он создаёт единственный markdown-документ, поэтому любые расчёты легко отменить удалением этого файла.

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

  • Спроектировать структуру нового проекта с нуля по требованиям PRD
  • Спланировать внедрение новой функции без регрессий в существующем коде
  • Выбрать стек и архитектурный паттерн со сравнением альтернатив
  • Разбить сборку системы на проверяемые фазы для агента Archon

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

  • /architect по спецификации из .planning/prd-auth.md
  • Спланируй архитектуру добавления платежей через Stripe в текущий проект
  • /architect greenfield mode для нового API на Hono и SQLite

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

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

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

Команда ставит плагин citadel целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add SethGammon/Citadel --skill architect -a claude-code

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

~/.claude/skills/architect/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/architect/

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

Вопросы об architect

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

В интерфейсе Claude Code выполните по очереди две команды: сначала /plugin marketplace add SethGammon/Citadel, затем /plugin install citadel@citadel-local.

Что делает скилл architect?

Он преобразует требования к продукту в подробный план реализации: расписывает дерево файлов, модель данных, критерии готовности для каждой фазы и передаёт результат на исполнение агенту Archon.

Нужен ли обязательно файл PRD для запуска?

Нет. Скилл умеет работать без PRD: он сканирует существующие файлы проекта, читает package.json и строит архитектуру прямо по текстовому описанию задачи.

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

SKILL.md · MIT
---
name: architect
license: MIT
description: >-
  Given a PRD, produces an implementation architecture: file tree, component
  breakdown, data model, and a phased build plan with end conditions that
  Archon can execute directly. Multi-candidate evaluation for key decisions.
user-invocable: true
auto-trigger: false
trigger_keywords:
  - architect
  - architecture
  - design the system
  - file structure
  - plan the build
effort: high
---

# /architect — Implementation Architecture from PRD

## When to Use

**Don't use when:** you already have an architecture and want to implement it (use /marshal or /archon); you need a PRD first (use /prd before /architect).

- After /prd produces an approved PRD (greenfield or feature mode)
- When the user has a clear direction + existing codebase (no PRD needed)
- When /do routes a build request
- When the user has a spec and wants a build plan

## Inputs

One of:
1. A PRD file path (from /prd) — preferred, contains structured requirements
2. A user-provided spec or description + an existing codebase — sufficient
3. Neither — suggest /prd first, but don't hard-gate. If the user has a clear
   direction ("add auth to my app"), that + the existing code IS the input.

## Mode Detection

**Greenfield mode**: PRD exists with `Mode: greenfield`, or no existing source files.
Produces a complete architecture from scratch.

**Feature mode**: PRD exists with `Mode: feature`, OR the user describes a feature
and the project has existing source files. The architecture describes changes to
existing code, not a standalone system.

In feature mode:
- Read the existing file tree FIRST — understand the current architecture before planning changes
- Read key files (package.json, tsconfig, main entry points, existing patterns)
- The File Tree section shows ONLY new and modified files, not the entire project
- Phases include a Phase 0: "Baseline" that records current typecheck/test state
- Every phase's end conditions include "no new typecheck errors" and "existing tests pass"
- The Risk Register includes "regression in existing functionality" as a default risk

## Protocol

### Step 1: READ

**If PRD exists**, read it. Extract:
- Core features (the numbered list)
- Technical decisions (stack choices)
- End conditions (what "done" looks like)
- Out of scope (what NOT to build)
- Integration points (feature mode)

**If no PRD**, read the codebase instead:
- Scan the file tree for structure and conventions
- Read package.json / equivalent for dependencies and scripts
- Read the main entry point(s) to understand the architecture
- Use the user's description as the feature spec
- Infer end conditions from the description ("add auth" → "protected routes return 401 without token")

### Step 2: EVALUATE OPTIONS (for non-trivial decisions)

For decisions with multiple valid approaches — state management, API structure, auth pattern, DB schema, routing — generate 2-3 candidates. Assess each on complexity, risk, maintainability, and LLM-friendliness. Pick the winner and document why. Reject alternatives with reasoning.

Simple decisions (file naming, folder structure, CSS) don't need this — use the PRD's stack choices and move on.

### Step 3: PRODUCE

Write to `.planning/architecture-{slug}.md`:

```markdown
# Architecture: {App Name}
> PRD: .planning/prd-{slug}.md  |  Date: {ISO date}

## File Tree
{Greenfield: complete file tree for v1, every file listed.
Feature mode: ONLY new (+) and modified (~) files.}

## Component Breakdown
### Feature: {name}
- Files: | Dependencies: | Complexity: {low/medium/high}

## Data Model
### {Entity name}
- Fields: {name: type}  |  Relationships: {connections}
{Omit section if no database.}

## Key Decisions
### {Decision}: {chosen approach}
- **Chosen**: {approach} — {reasoning}
- **Rejected**: {alternative} — {why not}

## Build Phases
### Phase N: {name}
- **Goal**: {one sentence}
- **Files**: | **Dependencies**: {or "none"}
- **End Conditions**: [ ] {machine-verifiable}

## Phase Dependency Graph
{Text format: Phase 1 → Phase 2 → Phase 3 / Phase 3 + 4 → Phase 5}

## Risk Register
1. {risk}: {mitigation}
2. {risk}: {mitigation}
3. {risk}: {mitigation}

## Deployment Strategy
{Skip if "deploy later" or static-only.}
- **Platform**: | **Method**: | **Environment variables**: | **Pre-deploy checks**:
{Final phase is "Deploy" when a platform is specified. A failed deploy does NOT fail the campaign.}
```

### Step 4: CONNECT TO CAMPAIGN

Each build phase becomes a campaign phase; end conditions carry over; the dependency graph determines ordering; parallel-safe phases flagged for Fleet.

Present summary to user (file count, phase count, key decisions, estimated complexity) and ask: "Ready to build? This will create an Archon campaign." If approved, write the campaign file.

### Step 5: HANDOFF

```
---HANDOFF---
- Architecture: {app name}
- Document: .planning/architecture-{slug}.md
- Phases: {count}
- Estimated complexity: {low/medium/high}
- Next: Archon campaign ready to execute
- Reversibility: green — delete .planning/architecture-{slug}.md to undo
---
```

## Contextual Gates

**Disclosure:** "Generating architecture plan for [description]. No files modified until you approve."
**Reversibility:** green — creates `.planning/architecture-{slug}.md` only; undo with `rm .planning/architecture-{slug}.md`.
**Trust gates:**
- Any: generate architecture document, evaluate options, connect to campaign.

## Quality Gates

- Every phase has at least one machine-verifiable end condition
- Every key decision documents what was rejected and why
- File tree is complete (no "etc." or "..." placeholders)
- Phase dependencies are explicit (no implicit ordering)
- Risk register has at least 2 entries

## Fringe Cases

**No PRD:** Treat user description + existing codebase as the spec; read file tree and package.json; proceed without requiring a PRD.

**Project already has code:** Use feature mode; read existing architecture first; file tree shows only new/modified files; Phase 0 records baseline typecheck/test state.

**Vague description:** Ask at most 2 clarifying questions; don't block on perfect clarity.

**`.planning/` missing:** Create it; if not possible, output the architecture inline and instruct the user to save it.

## Exit Protocol

```
---HANDOFF---
- Architecture: {app name}
- Document: .planning/architecture-{slug}.md
- Phases: {count}
- Estimated complexity: {low/medium/high}
- Next: Archon campaign ready to execute
- Reversibility: green — delete .planning/architecture-{slug}.md to undo
---
```

© SethGammon · MIT · SethGammon/Citadel

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →

Сначала — architect от других авторов.

architect backnotprop Скилл architect для Claude Code проектирует типы, сигнатуры и границы модулей до написания кода. Включается по запросу /architect или перед сложными доработками. CX Codex +1 10 600установок architect jsmastery-pro Скилл architect помогает выбрать стек, спроектировать фичу и зафиксировать технические решения. Он задаёт уточняющие вопросы и сохраняет готовые спецификации в docs/specs/. CX Codex +1 7 600установок architect jsmastery-pro Скилл architect помогает согласовать термины и решения до начала кода, затем готовит план реализации для подтверждения. CX Codex +1 1 000установок product-capability affaan-m Скилл product-capability превращает PRD, пункт роадмапа или обсуждение продукта в план capability с явными ограничениями, инвариантами и интерфейсами до начала работы над несколькими сервисами. CX Codex +1 6 300установок code-architect официальный Anthropic Субагент code-architect анализирует паттерны в кодовой базе и составляет план реализации новой фичи: список файлов для правок, схему данных и пошаговый чеклист сборки. CX Codex 1 439установок senior-architect sickn33 Скилл senior-architect для проектирования и проверки архитектуры системы на основе явных требований, компромиссов и фактических данных. Помогает выбрать решение, оценив текущее состояние, альтернативы и риски. CX Codex +1 2 200установок 4-spec challengepost Скилл 4-spec превращает утверждённый PRD в технический план: стек, где всё работает, компоненты, данные, структура файлов. Последний шаг планирования перед сборкой. CX Codex +1 1 800установок prd snarktank Скилл опрашивает разработчика и формирует структурированный PRD для новой фичи в файле tasks/prd-[feature-name].md. Помогает зафиксировать требования до написания кода. CX Codex +1 1 500установок spec owainlewis Скилл spec для Claude Code и Codex формирует спецификацию отдельной фичи перед написанием кода. Он описывает пользовательские сценарии и технический дизайн в виде готового тикета. CX Codex +1 440установок

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

Весь набор →
marshal Скилл marshal для Claude Code разбирает задачу, собирает контекст из кода и памяти и связывает скиллы в цепочку. Работает за одну сессию и спрашивает, только если не может продолжить. CX Codex +1 ★ 937звёзд репо test-gen Скилл test-gen генерирует и прогоняет тесты под существующий фреймворк проекта с проверкой типичных сценариев, краевых случаев и ошибок. CX Codex +1 ★ 937звёзд репо design Скилл design собирает дизайн-манифест из стилей проекта или ответов на вопросы. Хук после правок отмечает отклонения в CSS и компонентах. CX Codex +1 ★ 937звёзд репо live-preview Скилл live-preview делает скриншоты компонентов в процессе сборки, а не по готовности. Ловит регрессии вёрстки и невидимые блоки до того, как они уйдут дальше. CX Codex +1 ★ 937звёзд репо cost Скилл cost показывает расход токенов и стоимость сессий, кампаний и периодов. Помогает понять, куда уходит бюджет и как меняется темп расходов. CX Codex +1 ★ 937звёзд репо merge-review Скилл merge-review проверяет очередь слияний от fleet-агентов, находит пересечения файлов между ветками и предлагает безопасный порядок merge перед тем, как принимать изменения в main. CX Codex +1 ★ 937звёзд репо deploy-steward Скилл deploy-steward для Claude Code по очереди вливает готовые PR в main, проверяет CI, запускает деплой и создаёт задачи на починку при сбоях. CX Codex +1 ★ 937звёзд репо prd Собирает PRD по описанию приложения: задаёт вопросы, определяет объём и технические решения. Документ можно передать Archon для разбиения на кампанию. CX Codex +1 ★ 937звёзд репо

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

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