diff --git a/README.md b/README.md index 6a5ff64..a7d50ec 100644 --- 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* \ No newline at end of file +## 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* \ No newline at end of file diff --git a/docker-compose.evolution.yml b/agent-evolution/docker-compose.yml similarity index 100% rename from docker-compose.evolution.yml rename to agent-evolution/docker-compose.yml