# c4-architecture

Команда запускает пошаговый анализ репозитория снизу вверх и создаёт архитектурную документацию по модели C4 в папке C4-Documentation/.

- команда · `type=command` · Claude Code, Codex, Cursor · ★ 41823
- Автор: Seth Hobson
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/wshobson/agents/tree/HEAD/plugins/c4-architecture/commands/c4-architecture.md
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/commands/c4-architecture

## Что делает

Команда разбирает кодовую базу от самых глубоких директорий к корню проекта. Для каждого каталога запускается отдельный субагент `c4-architecture::c4-code`, который документирует сигнатуры функций, типы параметров, классы и внешние зависимости в файлах `c4-code-<папка>.md`. Служебные папки вроде `node_modules`, `.git`, `build` и `dist` автоматически отсеиваются.

Далее субагент `c4-architecture::c4-component` объединяет полученные отчёты в логические компоненты на основе доменных и технических границ. Он формирует спецификации интерфейсов и строит диаграммы зависимостей в формате Mermaid. Весь процесс охватывает четыре уровня модели C4: код, компоненты, контейнеры и общий контекст системы.

На больших проектах обход каталогов создаёт десятки Markdown-файлов. Процесс требует множества вызовов субагентов подряд. Все итоговые отчёты сохраняются локально в директории `C4-Documentation/`.

## Установка

### Claude Code (родная платформа)

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add wshobson/agents
```
В чате агента (не в терминале):
```text
/plugin install c4-architecture@claude-code-workflows
```

2. **Вручную: положить файлы**
- Файл: `.claude/commands/c4-architecture.md` — Вызов — /c4-architecture. Для всех проектов — ~/.claude/commands/

### Codex

**Вручную: положить файлы**
- Файл: `~/.codex/prompts/c4-architecture.md` — Вызов — /prompts:c4-architecture. В Codex этот формат помечен устаревшим, замена — скиллы

### GitHub Copilot

**Вручную: положить файлы**
- Файл: `.github/prompts/c4-architecture.prompt.md`

### Gemini CLI

**Вручную: положить файлы**
- Файл: `.gemini/commands/c4-architecture.toml` — Gemini хранит команды в TOML: текст запроса — в поле prompt

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/wshobson/agents/tree/HEAD/plugins/c4-architecture/commands/c4-architecture.md

## Когда брать
- документировать функции, классы и зависимости во всех каталогах проекта
- сгруппировать исходный код в логические компоненты с описанием интерфейсов
- построить Mermaid-диаграммы взаимосвязей между модулями системы
- сформировать полную архитектурную иерархию по модели C4

## Примеры запросов агенту
- /c4-architecture
- Проанализируй кодовую базу и создай архитектурную документацию по модели C4
- Сгенерируй C4-документацию для текущего репозитория в папку C4-Documentation

## Похожие
- [c4-codebase-architecture](https://affpapa.org/nevibecode/skills/c4-codebase-architecture.md) — скилл · ★ 24
- [architecture-diagrams](https://affpapa.org/nevibecode/skills/architecture-diagrams.md) — скилл · 2000 установок
- [create-architecture-documentation](https://affpapa.org/nevibecode/commands/create-architecture-documentation.md) — команда · 6136 установок
- [deep-wiki](https://affpapa.org/nevibecode/plugins/deep-wiki.md) — плагин · ★ 3149
- [033-architecture-diagrams](https://affpapa.org/nevibecode/skills/033-architecture-diagrams.md) — скилл · 344 установки
- [c4m](https://affpapa.org/nevibecode/plugins/c4m.md) — плагин · ★ 43

Из того же набора: [wshobson/agents](https://affpapa.org/nevibecode/by/wshobson/agents.md) — 432 карточки

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md