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

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

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

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

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

# Ст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
• и т.д.

---

Эволюция агентов

Система автоматически отслеживает:

• Изменения моделей
• Оценки производительности
• Рекомендации по улучшению

# Синхронизировать данные
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 паттерны

---

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

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)

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