# APAW — Automatic Programmers Agent Workflow **Dual-runtime Agent Pipeline** — полная конфигурация автономного ИТ-офиса из 13+ специализированных ИИ-агентов. Поддерживает два runtime: - **KiloCode** (VS Code плагин) — через `.kilo/agent/` (`@kilocode/plugin` формат) - **Claude Code** (CLI / VS Code extension) — через `.claude/commands/` Система спроектирована как **Self-Healing Repository**: агенты автоматически анализируют задачи, пишут код, тестируют, проводят ревью и деплоят, не переписывая одно и то же дважды благодаря встроенной памяти коммитов. --- ## Структура репозитория ``` . ├── install-apaw.sh # Установщик в любой проект (bash) ├── .claude/ # Claude Code runtime │ ├── commands/ # 13 slash-команд (/project:*) │ │ ├── pipeline.md # Полный цикл одной командой │ │ ├── orchestrate.md # Диспетчер (Sonnet) │ │ ├── refine.md # Уточнение требований (Sonnet) │ │ ├── mine.md # Поиск дублей в git (Haiku) │ │ ├── analyze.md # Системный дизайн (Opus) │ │ ├── tests.md # TDD red phase (Sonnet) │ │ ├── implement.md # TDD green phase (Opus) │ │ ├── skeptic.md # Adversarial ревью (Sonnet) │ │ ├── perf.md # Анализ производительности (Sonnet) │ │ ├── fix.md # Исправление проблем (Sonnet) │ │ ├── security.md # Аудит безопасности (Opus) │ │ ├── release.md # Менеджер релизов (Sonnet) │ │ ├── evaluate.md # Оценка агентов (Haiku) │ │ └── optimize-prompts.md # PromptOps авто-улучшение (Opus) │ ├── rules/ │ │ └── global.md # Глобальные правила кодирования │ └── logs/ │ └── efficiency_score.json # История оценок агентов ├── .kilo/ # KiloCode plugin runtime (@kilocode/plugin) │ ├── agent/ # 19 агентов в формате plugin (YAML frontmatter) │ │ ├── orchestrator.md # Диспетчер (GLM-5) │ │ ├── requirement-refiner.md # Уточнитель требований (Kimi-k2-thinking) │ │ ├── history-miner.md # Архивариус Git (Gemini-3-Flash) │ │ ├── system-analyst.md # Системный аналитик (GPT-OSS 120B) │ │ ├── product-owner.md # Менеджер задач (Qwen3.5 122B) │ │ ├── lead-developer.md # Ведущий разработчик (DeepSeek-v3.2) │ │ ├── frontend-developer.md # Frontend (Kimi-k2.5) │ │ ├── the-fixer.md # Исправитель (MiniMax-m2.7) │ │ ├── sdet-engineer.md # Тестирование TDD (Qwen3-Coder-Next) │ │ ├── code-skeptic.md # Критик кода (GPT-OSS 120B) │ │ ├── performance-engineer.md # Производительность (Nemotron-3-Super) │ │ ├── security-auditor.md # Безопасность (GLM-4.7) │ │ ├── release-manager.md # Релизы (Devstral-2 123B) │ │ ├── evaluator.md # Оценщик (GPT-o3) │ │ ├── prompt-optimizer.md # PromptOps (Claude 4.5) │ │ ├── ask.md # Knowledge agent (Gemini-3-Flash) │ │ ├── code.md # Quick coder (DeepSeek-v3.2) │ │ ├── debug.md # Диагностика (MiniMax-m2.7) │ │ └── plan.md # Стратег (GPT-OSS 120B) │ ├── package.json # @kilocode/plugin dependency │ └── node_modules/ # Plugin runtime ├── .kilocode/ │ ├── agents/ # Устаревший формат (заменён .kilo/agent/) │ ├── rules/ │ │ └── global.md # Глобальные правила │ └── logs/ │ └── efficiency_score.json # История оценок └── packages/ └── opencode/ └── src/ └── kilocode/ └── agent-manager/ # TypeScript-интеграция с KiloCode ├── index.ts # Загрузчик конфигурации агентов ├── workflow.ts # State Machine пайплайна ├── router.ts # Маршрутизатор между агентами ├── prompt-loader.ts # Динамическая загрузка промптов ├── git-ops.ts # Git-операции (история, коммиты) ├── evaluator.ts # Логика оценки эффективности └── types.ts # TypeScript-типы системы ``` --- ## Состав команды (14 агентов) ### Блок А: Вход и Планирование | # | Роль | Модель | Специализация | |---|------|--------|---------------| | 1 | **Requirement Refiner** | Kimi-k2-thinking | Транслирует задачи в строгие технические чек-листы | | 2 | **Orchestrator** | GLM-5 | Главный диспетчер, управляет State Machine | | 3 | **History Miner** | Gemini-3-Flash | Сканирует git log, предотвращает дублирование работы | ### Блок Б: Проектирование | # | Роль | Модель | Специализация | |---|------|--------|---------------| | 4 | **System Analyst** | GPT-OSS 120B | Создаёт схемы БД, TypeScript-интерфейсы и API-контракты | | 5 | **Product Owner** | Qwen3.5 122B | Управляет чек-листами в Issues и статусными лейблами | ### Блок В: Производство | # | Роль | Модель | Специализация | |---|------|--------|---------------| | 6 | **Lead Developer** | DeepSeek-v3.2 | Пишет основной код (Go / Node.js) по TDD-спецификации | | 7 | **Frontend Dev** | Kimi-k2.5 | UI-компоненты, мультимодальный анализ скриншотов | | 8 | **The Fixer** | MiniMax-m2.7 | Итеративно исправляет баги после тестов и ревью | ### Блок Г: Контроль Качества | # | Роль | Модель | Специализация | |---|------|--------|---------------| | 9 | **SDET Engineer** | Qwen3-Coder-Next | Пишет падающие тесты до реализации (TDD Red Phase) | | 10 | **Code Skeptic** | GPT-OSS 120B | Ищет race conditions, уязвимости, логические дыры | | 11 | **Performance Engineer** | Nemotron-3-Super | Проверяет на N+1, утечки памяти, блокировки event loop | | 12 | **Security Auditor** | GLM-4.7 | OWASP Top 10, SQL-инъекции, XSS, CVE в зависимостях | ### Блок Д: Релиз и Самообучение | # | Роль | Модель | Специализация | |---|------|--------|---------------| | 13 | **Release Manager** | Devstral-2 123B | SemVer, Git Flow, мердж только при Green Build | | 14 | **Performance Evaluator** | GPT-o3 | Оценивает эффективность каждого агента по шкале 1-10 | | 15 | **Prompt Optimizer** | Claude 4.5 | Анализирует ошибки и переписывает системные промпты | --- ## Жизненный цикл задачи (State Machine) ``` [Пользователь] -> Requirement Refiner -> Orchestrator | +-------------------------+ v v History Miner (если дубль -> закрыть) | v System Analyst | v SDET Engineer (Red Phase: тесты падают) | v Lead Developer (Green Phase: тесты проходят) | v Code Skeptic ---- замечания ---> The Fixer --+ | | +--------------------------------------+ | (Approve) v Performance Engineer -- проблемы -> The Fixer | (OK) v Security Auditor -- уязвимости -> The Fixer | (OK) v Release Manager (SemVer + Merge) | v Performance Evaluator (оценка 1-10) | v Prompt Optimizer (если оценка < 7 -> улучшить промпт) | v Product Owner (закрывает Issue) ``` --- ## Установка и использование ### Вариант A: Claude Code (рекомендуется) #### Глобальная установка — команды работают во ВСЕХ проектах ```bash git clone https://git.softuniq.eu/UniqueSoft/APAW.git mkdir -p ~/.claude/commands ~/.claude/rules cp APAW/.claude/commands/*.md ~/.claude/commands/ cp APAW/.claude/rules/global.md ~/.claude/rules/ # Заменить /project: на /user: во внутренних ссылках: sed -i 's|/project:|/user:|g' ~/.claude/commands/*.md ``` После этого в **любом проекте** доступны команды `/user:pipeline`, `/user:refine` и т.д. #### Установка в конкретный проект ```bash git clone https://git.softuniq.eu/UniqueSoft/APAW.git ./APAW/install-apaw.sh /path/to/your-project ``` Скрипт создаёт `.claude/` в целевом проекте. Команды доступны как `/project:*`. #### Быстрый старт ``` # Полный цикл от идеи до релиза: /project:pipeline добавить эндпоинт авторизации через JWT # или глобально (после глобальной установки): /user:pipeline добавить эндпоинт авторизации через JWT # Или пошагово: /project:refine хочу кнопку экспорта в PDF /project:mine экспорт PDF /project:analyze экспорт PDF — user story + acceptance criteria /project:tests ... /project:implement ... ``` #### Таблица команд | Команда | Агент | Модель | Назначение | |---------|-------|--------|-----------| | `/project:pipeline` | Pipeline Runner | Sonnet | Весь цикл одной командой | | `/project:orchestrate` | Orchestrator | Sonnet | Маршрутизация по состоянию | | `/project:refine` | Requirement Refiner | Sonnet | Вагные идеи → чеклист | | `/project:mine` | History Miner | **Haiku** | Поиск дублей в git | | `/project:analyze` | System Analyst | **Opus** | Схемы БД, API-контракты | | `/project:tests` | SDET Engineer | Sonnet | TDD — пишет падающие тесты | | `/project:implement` | Lead Developer | **Opus** | TDD — делает тесты зелёными | | `/project:skeptic` | Code Skeptic | Sonnet | Adversarial ревью кода | | `/project:perf` | Performance Engineer | Sonnet | N+1, утечки, блокировки | | `/project:fix` | The Fixer | Sonnet | Точечные исправления | | `/project:security` | Security Auditor | **Opus** | OWASP Top 10, CVE | | `/project:release` | Release Manager | Sonnet | SemVer, gate-check, тег | | `/project:evaluate` | Evaluator | **Haiku** | Оценка агентов 1–10 | | `/project:optimize-prompts` | Prompt Optimizer | **Opus** | PromptOps авто-улучшение | > Haiku = быстро и дёшево. Opus = максимальное качество. Sonnet = баланс. --- ### Вариант B: KiloCode (VS Code плагин) ```bash git clone https://git.softuniq.eu/UniqueSoft/APAW.git cp -r APAW/.kilocode /your-project/ cp APAW/.kilocodemodes /your-project/ ``` KiloCode автоматически обнаружит `.kilocodemodes` и загрузит все режимы агентов. Начните с **Requirement Refiner**, введя описание задачи на естественном языке. --- ## PromptOps: Эволюция промптов через Git Все системные промпты хранятся в `.kilocode/agents/` и версионируются через Git: - **Отслеживать эволюцию** — `git diff` покажет изменения, сделанные Prompt Optimizer - **Откатывать изменения** — `git checkout` вернёт предыдущую версию промпта - **Анализировать обучение** — частые коммиты в промпт означают, что агент требует доработки Пример коммита от Prompt Optimizer: ``` chore(ai-brain): optimize Lead Dev prompt based on Issue #142 failures - Added: "Always check type compatibility in index.d.ts before implementation" - Reason: 4 fix iterations due to TypeScript interface mismatches ``` --- ## Оценка эффективности Файл `.kilocode/logs/efficiency_score.json` хранит историю оценок по каждому Issue: ```json { "version": "1.0", "history": [ { "issue": 142, "date": "2026-03-31T10:30:00Z", "agents": { "requirement-refiner": 8, "lead-developer": 6, "code-skeptic": 9 }, "iterations": 3, "duration_hours": 2.5 } ] } ``` --- ## Технический стек - **Оркестрация**: Node.js / TypeScript (Agent Manager) - **Интеграция**: KiloCode VS Code Extension - **Версионирование**: Gitea + Git Flow - **Язык разработки**: Go / Node.js (основные проекты) - **Тестирование**: TDD (Red-Green-Refactor) --- *Разработано в рамках проекта APAW (Automatic Programmers Agent Workflow) — 2026*