chore: reorganize project structure and update README

- Move docker-compose.evolution.yml to agent-evolution/docker-compose.yml - Update README with current agent lineup (28+ agents) - Fix model references in README tables - Add recent commits history - Simplify architecture overview
2026-04-05 23:02:44 +01:00
parent ff00b8e716
commit fe28aa5922
2 changed files with 205 additions and 318 deletions
--- a/README.md
+++ b/README.md
@@ -1,349 +1,206 @@
 # APAW — Automatic Programmers Agent Workflow

-**Dual-runtime Agent Pipeline** — полная конфигурация автономного ИТ-офиса из 25+ специализированных ИИ-агентов.
-
-Поддерживает два runtime:
- **KiloCode** (VS Code плагин) — через `.kilo/agents/` (`@kilocode/plugin` формат)
- **Claude Code** (CLI / VS Code extension) — через `.claude/commands/`
-
-Система спроектирована как **Self-Healing Repository**: агенты автоматически анализируют задачи, пишут код, тестируют, проводят ревью и деплоят, не переписывая одно и то же дважды благодаря встроенной памяти коммитов.
+**Self-Improving Agent Pipeline** — автономная система из 28+ специализированных ИИ-агентов с автоматической эволюцией промптов.

 ---

-## Структура репозитория
+## Архитектура

 ```
-.
-├── .claude/                                # Claude Code runtime
-│   ├── commands/                           # 14 slash-команд (/project:*)
-│   ├── rules/                              # Глобальные правила кодирования
-│   └── logs/                               # История оценок агентов
-├── .kilo/                                  # KiloCode plugin runtime
-│   ├── agents/                             # 25 агентов (YAML frontmatter)
-│   ├── commands/                           # 18 workflow команд
-│   ├── skills/                             # 34+ специализированных навыка
-│   ├── rules/                              # Правила кодирования
-│   ├── workflows/                          # Workflow определения
-│   ├── capability-index.yaml               # Индекс возможностей агентов
-│   └── logs/                               # Логи эффективности
-├── src/kilocode/                           # TypeScript API
-├── archive/                                # Архив (устаревшие файлы)
-├── AGENTS.md                               # Справка по агентам
-└── README.md                               # Этот документ
+APAW/
+├── .kilo/                           # KiloCode конфигурация
+│   ├── agents/                      # 28 агентов (YAML frontmatter)
+│   ├── commands/                    # Workflow команды
+│   ├── rules/                       # Правила кодирования
+│   ├── skills/                      # Специализированные навыки
+│   ├── capability-index.yaml        # Индекс возможностей
+│   ├── kilo.jsonc                   # Конфигурация primary агентов
+│   └── KILO_SPEC.md                 # Спецификация агентов
+├── agent-evolution/                 # Dashboard эволюции агентов
+│   ├── index.standalone.html        # Standalone dashboard
+│   ├── scripts/                     # Scripts синхронизации
+│   ├── data/                        # История изменений
+│   └── docker-compose.yml           # Docker запуск
+├── src/kilocode/                    # TypeScript API
+├── archive/                         # Архивные документы
+├── scripts/                         # Utility scripts
+├── AGENTS.md                        # Справка по агентам
+└── README.md                        # Этот документ
 ```

 ---

-## Состав команды (25+ агентов)
+## Быстрый старт

-### Блок А: Вход и Планирование
-
-| # | Роль | Модель | Специализация |
-|---|------|--------|---------------|
-| 1 | **Requirement Refiner** | Kimi-k2-thinking | Транслирует задачи в строгие технические чек-листы |
-| 2 | **Orchestrator** | GLM-5 | Главный диспетчер, управляет State Machine |
-| 3 | **History Miner** | GPT-OSS 20B | Сканирует git log, предотвращает дублирование |
-| 4 | **Planner** | GPT-OSS 120B | Декомпозиция задач (Chain of Thought) |
-
-### Блок Б: Проектирование
-
-| # | Роль | Модель | Специализация |
-|---|------|--------|---------------|
-| 5 | **System Analyst** | Qwen3.6-Plus | Создаёт схемы БД, API-контракты |
-| 6 | **Product Owner** | Qwen3.6-Plus | Управляет чек-листами в Issues |
-| 7 | **Capability Analyst** | GPT-OSS 120B | Gap analysis, рекомендации |
-| 8 | **Workflow Architect** | GLM-5 | Создание workflow определений |
-
-### Блок В: Производство
-
-| # | Роль | Модель | Специализация |
-|---|------|--------|---------------|
-| 9 | **Lead Developer** | Qwen3-Coder 480B | Пишет основной код по TDD |
-| 10 | **Backend Developer** | Qwen3-Coder 480B | Node.js/Express APIs |
-| 11 | **Go Developer** | DeepSeek-v3.2 | Go/Gin/Echo APIs, concurrency |
-| 12 | **Frontend Dev** | Kimi-k2.5 | UI-компоненты, мультимодальный анализ |
-| 13 | **The Fixer** | MiniMax-m2.5 | Итеративно исправляет баги |
-
-### Блок Г: Контроль Качества
-
-| # | Роль | Модель | Специализация |
-|---|------|--------|---------------|
-| 14 | **SDET Engineer** | Qwen3-Coder 480B | TDD Red Phase — пишет падающие тесты |
-| 15 | **Code Skeptic** | MiniMax-m2.5 | Adversarial ревью кода |
-| 16 | **Performance Engineer** | Nemotron-3-Super | N+1, утечки памяти, блокировки |
-| 17 | **Security Auditor** | Kimi-k2.5 | OWASP Top 10, CVE в зависимостях |
-
-### Блок Д: Релиз и Самообучение
-
-| # | Роль | Модель | Специализация |
-|---|------|--------|---------------|
-| 18 | **Release Manager** | Qwen3-Coder 480B | SemVer, Git Flow, мердж |
-| 19 | **Evaluator** | GPT-OSS 120B | Оценивает эффективность агентов (1-10) |
-| 20 | **Prompt Optimizer** | Qwen3.6-Plus | Анализирует ошибки, улучшает промпты |
-
-### Блок Е: Когнитивное усиление (Research-Based)
-
-| # | Роль | Паттерн | Специализация |
-|---|------|---------|---------------|
-| 21 | **Planner** | Chain of Thought / Tree of Thoughts | Декомпозиция сложных задач |
-| 22 | **Reflector** | Reflexion | Self-reflection, анализ ошибок |
-| 23 | **Memory Manager** | Memory Architecture | Контекст и эпизодическая память |
-
-### Блок Ж: Специализированные
-
-| # | Роль | Модель | Специализация |
-|---|------|--------|---------------|
-| 24 | **Browser Automation** | Qwen3-Coder 480B | E2E тесты с Playwright |
-| 25 | **Visual Tester** | Qwen3-Coder 480B | Visual regression testing |
-| 26 | **Markdown Validator** | GLM-5 | Валидация Markdown |
-
---
-
-## Жизненный цикл задачи (State Machine)
-
-```
-[Пользователь]
-      │
-      ▼
-┌─────────────────┐
-│ Requirement     │  Вагные идеи → технические чек-листы
-│ Refiner         │
-└────────┬────────┘
-         │
-         ▼
-┌─────────────────┐
-│ History Miner   │  Проверка дублей в git
-└────────┬────────┘
-         │
-         ▼
-┌─────────────────┐
-│ System Analyst   │  Схемы БД, API-контракты
-└────────┬────────┘
-         │
-         ▼
-┌─────────────────┐
-│ SDET Engineer    │  RED Phase — тесты падают
-└────────┬────────┘
-         │
-         ▼
-┌─────────────────┐
-│ Lead Developer   │  GREEN Phase — тесты проходят
-└────────┬────────┘
-         │
-         ▼
-┌─────────────────┐     замечания     ┌─────────────┐
-│ Code Skeptic     │ ───────────────▶ │ The Fixer   │
-└────────┬────────┘                   └──────┬──────┘
-         │ approve                          │
-         ▼                                  │
-┌─────────────────┐                         │
-│ Performance      │ ◀───────────────────────┘
-│ Engineer         │
-└────────┬────────┘
-         │ approve
-         ▼
-┌─────────────────┐
-│ Security Auditor │
-└────────┬────────┘
-         │ approve
-         ▼
-┌─────────────────┐
-│ Release Manager  │  SemVer + Merge
-└────────┬────────┘
-         │
-         ▼
-┌─────────────────┐
-│ Evaluator        │  Оценка 1-10
-└────────┬────────┘
-         │
-         ▼
-┌─────────────────┐
-│ Prompt Optimizer │  Если оценка < 7
-└────────┬────────┘
-         │
-         ▼
-┌─────────────────┐
-│ Product Owner    │  Закрывает Issue
-└─────────────────┘
-```
-
---
-
-## Установка и использование
-
-### Вариант A: Claude Code (рекомендуется)
-
-#### Глобальная установка
+### Использование с KiloCode

 ```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/
-```

-После этого в **любом проекте** доступны команды `/user:pipeline`, `/user:refine` и т.д.
-
-#### Установка в конкретный проект
-
-```bash
-git clone https://git.softuniq.eu/UniqueSoft/APAW.git
-cp -r APAW/.claude /path/to/your-project/
-cp -r APAW/.kilo /path/to/your-project/
-```
-
-#### Быстрый старт
-
-```bash
-# Полный цикл от идеи до релиза:
-/project:pipeline добавить JWT авторизацию
-
-# Или пошагово:
-/project:refine хочу экспорт в PDF
-/project:mine экспорт PDF           # Проверка дублей
-/project:analyze экспорт PDF        # User story + acceptance criteria
-/project:tests ...                  # TDD Red
-/project:implement ...              # TDD Green
-```
-
-#### Таблица команд
-
-| Команда | Назначение |
-|---------|-----------|
-| `/project:pipeline` | Весь цикл одной командой |
-| `/project:refine` | Идеи → чеклист |
-| `/project:mine` | Поиск дублей в git |
-| `/project:analyze` | Схемы БД, API-контракты |
-| `/project:tests` | TDD — падающие тесты |
-| `/project:implement` | TDD — реализация |
-| `/project:skeptic` | Adversarial ревью |
-| `/project:perf` | N+1, утечки, блокировки |
-| `/project:fix` | Точечные исправления |
-| `/project:security` | OWASP Top 10, CVE |
-| `/project:release` | SemVer, gate-check, тег |
-| `/project:evaluate` | Оценка агентов 1-10 |
-
---
-
-### Вариант B: KiloCode (VS Code плагин)
-
-```bash
-git clone https://git.softuniq.eu/UniqueSoft/APAW.git
+# Скопировать конфигурацию в проект
 cp -r APAW/.kilo /your-project/
 ```

 KiloCode автоматически обнаружит `.kilo/` и загрузит всех агентов.

---
-
-## KiloCode Pipeline Agents
-
-| Agent | Role | Model |
-|-------|------|-------|
-| `@RequirementRefiner` | Converts ideas to User Stories | ollama-cloud/kimi-k2-thinking |
-| `@HistoryMiner` | Finds duplicates in git | ollama-cloud/gpt-oss:20b |
-| `@SystemAnalyst` | Technical specifications | qwen/qwen3.6-plus:free |
-| `@SDETEngineer` | TDD tests | ollama-cloud/qwen3-coder:480b |
-| `@LeadDeveloper` | Primary code writer | ollama-cloud/qwen3-coder:480b |
-| `@FrontendDeveloper` | UI implementation | ollama-cloud/kimi-k2.5 |
-| `@BackendDeveloper` | Node.js/Express APIs | ollama-cloud/qwen3-coder:480b |
-| `@GoDeveloper` | Go/Gin/Echo APIs | ollama-cloud/deepseek-v3.2 |
-| `@CodeSkeptic` | Adversarial reviewer | ollama-cloud/minimax-m2.5 |
-| `@TheFixer` | Bug fixes | ollama-cloud/minimax-m2.5 |
-| `@PerformanceEngineer` | Performance review | ollama-cloud/nemotron-3-super |
-| `@SecurityAuditor` | Vulnerability scan | ollama-cloud/kimi-k2.5 |
-| `@ReleaseManager` | Git operations | ollama-cloud/qwen3-coder:480b |
-| `@Evaluator` | Effectiveness scoring | ollama-cloud/gpt-oss:120b |
-| `@PromptOptimizer` | Prompt improvements | qwen/qwen3.6-plus:free |
-| `@ProductOwner` | Issue management | qwen/qwen3.6-plus:free |
-| `@Orchestrator` | Task routing | ollama-cloud/glm-5 |
-| `@Planner` | Task decomposition | ollama-cloud/gpt-oss:120b |
-| `@Reflector` | Self-reflection | ollama-cloud/gpt-oss:120b |
-| `@MemoryManager` | Context management | ollama-cloud/gpt-oss:120b |
-
---
-
-## Прямой вызов агентов
+### Запуск Dashboard эволюции

 ```bash
-@lead-developer implement authentication flow
-@code-skeptic review the auth module
-@security-auditor check for vulnerabilities
+# Стandalone (без Docker)
+bun run sync:evolution
+open agent-evolution/index.standalone.html
+
+# Или через Docker
+cd agent-evolution
+docker-compose up -d
+# Dashboard доступен на http://localhost:3001
 ```

 ---

-## Agent Manager API
+## Команда агентов (28+)

-### Установка
+### Планирование и Анализ
+
+| Агент | Модель | Назначение |
+|-------|--------|------------|
+| `@orchestrator` | GLM-5 | Главный диспетчер, маршрутизация задач |
+| `@requirement-refiner` | Nemotron-3-Super | Идеи → User Stories |
+| `@history-miner` | Nemotron-3-Super | Поиск дублей в git |
+| `@system-analyst` | GLM-5 | Схемы БД, API контракты |
+| `@planner` | Nemotron-3-Super | Декомпозиция задач (CoT/ToT) |
+| `@capability-analyst` | Nemotron-3-Super | Gap analysis |
+
+### Разработка
+
+| Агент | Модель | Назначение |
+|-------|--------|------------|
+| `@lead-developer` | Qwen3-Coder 480B | Основной код по TDD |
+| `@frontend-developer` | Qwen3-Coder 480B | UI компоненты |
+| `@backend-developer` | Qwen3-Coder 480B | Node.js/Express APIs |
+| `@go-developer` | Qwen3-Coder 480B | Go/Gin/Echo APIs |
+| `@flutter-developer` | Qwen3-Coder 480B | Flutter mobile apps |
+| `@devops-engineer` | Nemotron-3-Super | Docker, K8s, CI/CD |
+
+### Качество
+
+| Агент | Модель | Назначение |
+|-------|--------|------------|
+| `@sdet-engineer` | Qwen3-Coder 480B | TDD Red Phase |
+| `@code-skeptic` | MiniMax-m2.5 | Adversarial ревью |
+| `@the-fixer` | MiniMax-m2.5 | Исправление багов |
+| `@performance-engineer` | Nemotron-3-Super | N+1, утечки памяти |
+| `@security-auditor` | Nemotron-3-Super | OWASP Top 10, CVE |
+
+### Релиз и Метрики
+
+| Агент | Модель | Назначение |
+|-------|--------|------------|
+| `@release-manager` | Devstral-2 123B | Git Flow, SemVer |
+| `@evaluator` | Nemotron-3-Super | Оценка агентов 1-10 |
+| `@prompt-optimizer` | Qwen3.6-Plus | Улучшение промптов |
+| `@product-owner` | Qwen3.6-Plus | Управление Issues |
+
+### Когнитивное усиление
+
+| Агент | Паттерн | Назначение |
+|-------|---------|------------|
+| `@reflector` | Reflexion | Анализ ошибок |
+| `@memory-manager` | Memory Arch | Управление контекстом |
+
+### Специализированные
+
+| Агент | Модель | Назначение |
+|-------|--------|------------|
+| `@browser-automation` | Qwen3-Coder 480B | Playwright E2E |
+| `@visual-tester` | Qwen3-Coder 480B | Visual regression |
+| `@workflow-architect` | Qwen3.6-Plus | Workflow определения |
+| `@markdown-validator` | Nemotron-3-Nano | Валидация Markdown |
+| `@agent-architect` | Nemotron-3-Super | Создание агентов |
+
+---
+
+## Pipeline Workflow
+
+```
+[Issue] 
+   ↓
+[@requirement-refiner] → User Story + Acceptance Criteria
+   ↓
+[@history-miner] → Проверка дублей
+   ↓
+[@system-analyst] → Схемы БД, API контракты
+   ↓
+[@sdet-engineer] → TDD Red Phase (тесты падают)
+   ↓
+[@lead-developer] → TDD Green Phase (тесты проходят)
+   ↓
+[@code-skeptic] → Adversarial review
+   ↓ (fail)            ↓ (pass)
+[@the-fixer]          [@performance-engineer]
+   ↓                      ↓
+   ─────────────────→ [@security-auditor]
+                          ↓
+                      [@release-manager]
+                          ↓
+                      [@evaluator] → Score 1-10
+                          ↓ (score < 7)
+                      [@prompt-optimizer]
+                          ↓
+                      [@product-owner] → Close Issue
+```
+
+---
+
+## Конфигурация
+
+### Models (kilo.jsonc)
+
+Primary агенты для UI:
+- `orchestrator` — GLM-5 (главный диспетчер)
+- `code` — Qwen3-Coder 480B (быстрый код)
+- `ask` — Qwen3.6-Plus (вопросы по коду)
+- `plan` — Nemotron-3-Super (планирование)
+- `debug` — Gemma4 31B (диагностика)
+
+Subagent модели определены в `.md` файлах агентов.
+
+### Capability Index (capability-index.yaml)
+
+Карта возможностей для маршрутизации:
+- `code_writing` → `lead-developer`
+- `code_review` → `code-skeptic`
+- `test_writing` → `sdet-engineer`
+- `security` → `security-auditor`
+- и т.д.
+
+---
+
+## Эволюция агентов
+
+Система автоматически отслеживает:
+- Изменения моделей
+- Оценки производительности
+- Рекомендации по улучшению

 ```bash
-bun install
-bun run build
-```
+# Синхронизировать данные
+bun run sync:evolution

-### Использование
-
-```typescript
-import { 
-  PipelineRunner, 
-  GiteaClient, 
-  decideRouting 
-} from './src/kilocode/index.js'
-
-const runner = await createPipelineRunner({
-  giteaToken: process.env.GITEA_TOKEN,
-  giteaApiUrl: 'https://git.softuniq.eu/api/v1'
-})
-
-const result = await runner.run({
-  issueNumber: 42,
-  files: ['src/auth.ts']
-})
-```
-
-### Gitea интеграция
-
-```typescript
-const client = new GiteaClient({
-  apiUrl: 'https://git.softuniq.eu/api/v1',
-  token: process.env.GITEA_TOKEN
-})
-
-const issue = await client.getIssue(42)
-await client.setStatus(42, 'implementing')
-await client.createComment(42, {
-  body: '## ✅ Implementation Complete'
-})
+# Открыть dashboard
+bun run evolution:open
 ```

 ---

 ## Skills System

-Система навыков в `.kilo/skills/` обеспечивает специализацию агентов:
-
-### Backend Development
-
-| Skill | Technology |
-|-------|------------|
-| `nodejs-express-patterns` | Express.js routing, middleware |
-| `nodejs-auth-jwt` | JWT authentication |
-| `nodejs-db-patterns` | Database operations |
-| `nodejs-security-owasp` | Security best practices |
-| `go-web-patterns` | Gin/Echo web framework |
-| `go-db-patterns` | GORM/sqlx patterns |
-| `go-concurrency` | Goroutines, channels |
-| `go-modules` | Go modules management |
-
-### Integration & Workflow
-
-| Skill | Purpose |
-|-------|---------|
-| `gitea-commenting` | Gitea API integration |
-| `gitea-workflow` | Workflow execution |
-| `research-cycle` | Self-improvement cycle |
-| `planning-patterns` | Task decomposition |
+Навыки в `.kilo/skills/`:
+- `gitea-workflow` — Gitea интеграция
+- `gitea-commenting` — Автоматические комментарии
+- `research-cycle` — Self-improvement
+- `planning-patterns` — CoT/ToT паттерны

 ---

@@ -356,13 +213,15 @@ GITEA_TOKEN=your-token-here

 ---

-## PromptOps: Эволюция промптов
+## Последние изменения

-Все промпты хранятся в `.kilo/agents/` и версионируются через Git:
-
- **Отслеживать эволюцию** — `git diff` покажет изменения
- **Откатывать изменения** — `git checkout` вернёт предыдущую версию
- **Анализировать обучение** — частые коммиты означают необходимость доработки
+| Дата | Коммит | Описание |
+| |------|---------|
+| 2026-04-05 | `ff00b8e` | Синхронизация моделей агентов |
+| 2026-04-05 | `4af7355` | Обновление моделей по research-рекомендациям |
+| 2026-04-05 | `15a7b4b` | Agent Evolution Dashboard |
+| 2026-04-05 | `b899119` | html-to-flutter skill |
+| 2026-04-05 | `af5f401` | Flutter development support |

 ---

@@ -370,12 +229,40 @@ GITEA_TOKEN=your-token-here

 | Layer | Technology |
 |-------|------------|
-| Runtime | Node.js / TypeScript |
-| Integration | KiloCode VS Code Extension / Claude Code |
+| Runtime | TypeScript / Node.js |
+| Agent Runtime | KiloCode VS Code Extension |
 | Version Control | Gitea + Git Flow |
 | Languages | TypeScript / Node.js / Go |
 | Testing | TDD (Red-Green-Refactor) |
+| Containerization | Docker / Docker Compose |

 ---

-*Разработано в рамках проекта APAW (Automatic Programmers Agent Workflow) — 2026*
+## API (TypeScript)
+
+```typescript
+import { 
+  PipelineRunner, 
+  GiteaClient 
+} from 'apaw'
+
+const runner = await createPipelineRunner({
+  giteaToken: process.env.GITEA_TOKEN
+})
+
+await runner.run({ issueNumber: 42 })
+```
+
+---
+
+## Статус проекта
+
+✅ Production Ready  
+✅ 28+ агентов  
+✅ Self-improving pipeline  
+✅ Gitea интеграция  
+✅ Agent Evolution Dashboard  
+
+---
+
+*APAW (Automatic Programmers Agent Workflow) — 2026*
--- a/agent-evolution/docker-compose.yml
+++ b/agent-evolution/docker-compose.yml