Отдел разработки ПО
tranhieutt/software_development_departmentСтруктурированная мультиагентная система: 31 агент, 116 навыков, 10 паттернов harness. Разграничение полномочий, принудительное соблюдение процессов, многоуровневая память и точная маршрутизация задач — всё в рамках одной сессии Claude Code.
Установка
git clone https://github.com/tranhieutt/software_development_department.gitREADME
Предварительные требования (совместимость платформ)
- Claude Code:
npm install -g @anthropic-ai/claude-code - Git: обязателен для контроля версий и хуков.
- Пользователи Windows: требуется Git Bash 2.40+ или WSL2. CMD/PowerShell поддерживаются для большинства команд, однако автоматизированные хуки валидации требуют POSIX-совместимой оболочки.
- jq (рекомендуется): используется хуками валидации для разбора JSON.
- Python 3 (рекомендуется): используется скриптами оценки навыков и аудита.
Проблема
AI-сессия без структуры ведёт себя как джуниор-разработчик без надзора: задачи выполняются, но проектная документация пропускается, граничные случаи игнорируются, накапливается скрытый технический долг, и некому остановить расползание scope.
Фундаментальное ограничение — не возможности модели, а организационная энтропия. AI в рамках одной сессии не имеет границ между отделами, путей эскалации, доменных полномочий и памяти между задачами. Он отвечает на любой вопрос, но ни за что не отвечает.
Claude Code Software Development Department — архитектурное решение этой проблемы.
Что представляет собой система
SDD — это управляемый мультиагентный harness, построенный нативно на агентных примитивах Claude Code. Это не обёртка и не библиотека промптов. Это организационная структура, которая накладывает паттерны координации реального инженерного отдела поверх сессии Claude Code.
В результате получается система, где:
- Полномочия разграничены: агенты владеют доменами и не пересекают границы без явного делегирования
- Процессы соблюдаются принудительно: спецификация до реализации, план до кода, тесты до слияния — обеспечивается хуками и верификационными шлюзами, а не рекомендациями
- Память сохраняется: 5-уровневая архитектура долговременной памяти (индекс Tier 1 → тематические файлы Tier 2 → холодный архив Tier 3 → семантическое хранилище MCP Supermemory) переживает перезапуски сессий (Privacy-first: Bring Your Own Brain)
- Контекст загружается точечно: инкрементальная загрузка с трёхвопросным шлюзом релевантности предотвращает переполнение контекста; максимум 3 файла Tier 2 за сессию
- Маршрутизация точная: 117 навыков с триггерами
paths:, семантикойwhen_to_use:и оценкамиeffort:позволяют AI самостоятельно выбирать нужный навык без участия человека - Визуальный интеллект: автоматическое построение технических диаграмм (SVG/PNG) для архитектур, диаграмм последовательностей и моделей процессов через
/visualize
Архитектура
Иерархия отдела
Три уровня. Чёткие пути эскалации. Никакой размытой ответственности.
Tier 1 — Руководство (Opus)
cto technical-director producer
Tier 2 — Лиды (Sonnet)
product-manager lead-programmer ux-designer
qa-lead release-manager
Tier 3 — Специалисты (Sonnet / Haiku)
frontend-developer backend-developer fullstack-developer
mobile-developer ai-programmer network-programmer
tools-programmer ui-programmer data-engineer
analytics-engineer ux-researcher tech-writer
prototyper performance-analyst devops-engineer
security-engineer qa-tester accessibility-specialist
community-manager
Модель координации
| Паттерн | Поведение |
|---|---|
| Вертикальное делегирование | CTO → лиды → специалисты. Решения идут вниз; блокеры эскалируются вверх. |
| Горизонтальные консультации | Агенты одного уровня могут давать советы, но не принимать обязывающих межdomainных решений. |
| Разрешение конфликтов | Стратегические конфликты → cto. Технические конфликты → technical-director. |
| Межотдельные изменения | Координируются исключительно через producer. |
| Изоляция доменов | Агенты не могут изменять файлы вне своего домена без явного делегирования. |
Покрытие паттернов Agentic Harness
SDD реализует 10 из 12 паттернов внутренней архитектуры agentic harness Claude Code:
| Паттерн | Статус | Реализация |
|---|---|---|
| #1 Структурированные определения агентов | ✅ | 31 агент с YAML frontmatter и владением доменом |
| #2 Правила с привязкой к путям | ✅ | 13 правил, автоматически применяемых по пути файла |
| #3 Многоуровневая память | ✅ | 5 уровней: MEMORY.md → тематические файлы → архив → Supermemory |
| #4 Dream Consolidation | ✅ | auto-dream.sh — автоматическая консолидация в 5 фаз |
| #6 Контекст: Fork | ✅ | 10 тяжёлых аналитических навыков выполняются в изолированном контексте субагента |
| #7 Маршрутизация навыков | ✅ | 118 навыков с метаданными paths:, when_to_use:, effort: |
| #8 Fork-Join параллелизм | ✅ | fork-join.sh — менеджер жизненного цикла git worktree |
| #10 Инструменты с минимальными привилегиями | ✅ | allowed-tools: на навык + список разрешений из 22 записей |
| #11 Bash Guard | ✅ | bash-guard.sh блокирует паттерны RCE и деструктивные команды |
| #12 Система аннотаций | ✅ | Навык /annotate + постоянное хранилище annotations.md |
| #5 Многоэтапное сжатие контекста | ⚠️ | Требует управления диалогом на уровне платформы (HISTORY_SNIP, Microcompact, CONTEXT_COLLAPSE, Autocompact) — недоступно из области проекта |
| #9 Прогрессивное расширение инструментов | ⚠️ | Частично реализовано |