# APAW — Automatic Programmers Agent Workflow

**Self-Improving Agent Pipeline** — автономная система из 28+ специализированных ИИ-агентов с автоматической эволюцией промптов.

---

## Архитектура

```
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                        # Этот документ
```

---

## Быстрый старт

### Использование с KiloCode

```bash
# Клонировать репозиторий
git clone https://git.softuniq.eu/UniqueSoft/APAW.git

# Скопировать конфигурацию в проект
cp -r APAW/.kilo /your-project/
```

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

### Запуск Dashboard эволюции

```bash
# Стandalone (без Docker)
bun run sync:evolution
open agent-evolution/index.standalone.html

# Или через Docker
cd agent-evolution
docker-compose up -d
# Dashboard доступен на http://localhost:3001
```

---

## Команда агентов (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 run sync:evolution

# Открыть dashboard
bun run evolution:open
```

---

## Skills System

Навыки в `.kilo/skills/`:
- `gitea-workflow` — Gitea интеграция
- `gitea-commenting` — Автоматические комментарии
- `research-cycle` — Self-improvement
- `planning-patterns` — CoT/ToT паттерны

---

## Переменные окружения

```bash
GITEA_API_URL=https://git.softuniq.eu/api/v1
GITEA_TOKEN=your-token-here
```

---

## Последние изменения

| Дата | Коммит | Описание |
| |------|---------|
| 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 |

---

## Технический стек

| Layer | Technology |
|-------|------------|
| 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 |

---

## 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*