diff --git a/README.md b/README.md index 78078c6..ef72d70 100644 --- a/README.md +++ b/README.md @@ -1,9 +1,9 @@ # APAW — Automatic Programmers Agent Workflow -**Dual-runtime Agent Pipeline** — полная конфигурация автономного ИТ-офиса из 13+ специализированных ИИ-агентов. +**Dual-runtime Agent Pipeline** — полная конфигурация автономного ИТ-офиса из 25+ специализированных ИИ-агентов. Поддерживает два runtime: -- **KiloCode** (VS Code плагин) — через `.kilo/agent/` (`@kilocode/plugin` формат) +- **KiloCode** (VS Code плагин) — через `.kilo/agents/` (`@kilocode/plugin` формат) - **Claude Code** (CLI / VS Code extension) — через `.claude/commands/` Система спроектирована как **Self-Healing Repository**: агенты автоматически анализируют задачи, пишут код, тестируют, проводят ревью и деплоят, не переписывая одно и то же дважды благодаря встроенной памяти коммитов. @@ -12,6 +12,71 @@ ## Структура репозитория +``` +. +├── .claude/ # Claude Code runtime +│ ├── commands/ # 14 slash-команд (/project:*) +│ │ ├── pipeline.md # Полный цикл одной командой +│ │ ├── orchestrate.md # Диспетчер +│ │ ├── refine.md # Уточнение требований +│ │ ├── mine.md # Поиск дублей в git +│ │ ├── analyze.md # Системный дизайн +│ │ ├── tests.md # TDD red phase +│ │ ├── implement.md # TDD green phase +│ │ ├── skeptic.md # Adversarial ревью +│ │ ├── perf.md # Анализ производительности +│ │ ├── fix.md # Исправление проблем +│ │ ├── security.md # Аудит безопасности +│ │ ├── release.md # Менеджер релизов +│ │ ├── evaluate.md # Оценка агентов +│ │ └── optimize-prompts.md # PromptOps авто-улучшение +│ ├── rules/ +│ │ └── global.md # Глобальные правила кодирования +│ └── logs/ +│ └── efficiency_score.json # История оценок агентов +├── .kilo/ # KiloCode plugin runtime (@kilocode/plugin) +│ ├── agents/ # 25 агентов (YAML frontmatter) +│ │ ├── orchestrator.md # Диспетчер +│ │ ├── requirement-refiner.md # Уточнитель требований +│ │ ├── history-miner.md # Архивариус Git +│ │ ├── system-analyst.md # Системный аналитик +│ │ ├── product-owner.md # Менеджер задач +│ │ ├── lead-developer.md # Ведущий разработчик +│ │ ├── frontend-developer.md # Frontend +│ │ ├── backend-developer.md # Backend (Node.js) +│ │ ├── go-developer.md # Backend (Go) +│ │ ├── the-fixer.md # Исправитель +│ │ ├── sdet-engineer.md # Тестирование TDD +│ │ ├── code-skeptic.md # Критик кода +│ │ ├── performance-engineer.md # Производительность +│ │ ├── security-auditor.md # Безопасность +│ │ ├── release-manager.md # Релизы +│ │ ├── evaluator.md # Оценщик +│ │ ├── prompt-optimizer.md # PromptOps +│ │ ├── capability-analyst.md # Анализ возможностей +│ │ ├── agent-architect.md # Архитектор агентов +│ │ ├── workflow-architect.md # Архитектор workflows +│ │ ├── planner.md # Планировщик (CoT/ToT) +│ │ ├── reflector.md # Рефлексия +│ │ ├── memory-manager.md # Управление памятью +│ │ └── ... +│ ├── commands/ # Workflow команды (18 файлов) +│ ├── skills/ # Специализированные навыки (34+) +│ │ ├── nodejs-* # Node.js навыки +│ │ ├── go-* # Go навыки +│ │ ├── gitea-* # Gitea интеграция +│ │ └── ... +│ ├── rules/ # Правила кодирования +│ ├── workflows/ # Workflow определения +│ ├── capability-index.yaml # Индекс возможностей +│ └── logs/ # Логи +├── src/ +│ └── kilocode/ # TypeScript API +│ ├── index.ts +│ └── ... +├── archive/ # Архив (устаревшие файлы) +├── AGENTS.md # Справка по агентам +└── README.md # Этот документ ``` . ├── install-apaw.sh # Установщик в любой проект (bash) @@ -47,36 +112,31 @@ │ │ ├── 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 # История оценок +│ │ ├── capability-analyst.md # Анализ возможностей +│ │ ├── agent-architect.md # Архитектор агентов +│ │ ├── workflow-architect.md # Архитектор workflows +│ │ ├── planner.md # Планировщик (CoT/ToT) +│ │ ├── reflector.md # Рефлексия +│ │ └── memory-manager.md # Управление памятью +│ ├── commands/ # Workflow команды (18 файлов) +│ ├── skills/ # 34+ специализированных навыков +│ │ ├── nodejs-* # Node.js навыки (8) +│ │ ├── go-* # Go навыки (8) +│ │ ├── gitea-* # Gitea интеграция +│ │ └── ... +│ ├── rules/ # Правила кодирования +│ │ ├── nodejs.md # Node.js правила +│ │ ├── go.md # Go правила +│ │ ├── agent-patterns.md # Паттерны агентов +│ │ └── ... +│ ├── workflows/ # Workflow определения +│ ├── capability-index.yaml # Индекс возможностей агентов +│ └── logs/ # Логи эффективности ├── src/ -│ └── kilocode/ -│ ├── index.ts # Точка входа модуля -│ └── agent-manager/ # TypeScript-интеграция с KiloCode -│ ├── index.ts # Загрузчик конфигурации агентов -│ ├── workflow.ts # State Machine пайплайна -│ ├── router.ts # Маршрутизатор между агентами -│ ├── prompt-loader.ts # Динамическая загрузка промптов -│ ├── git-ops.ts # Git-операции (история, коммиты) -│ ├── evaluator.ts # Логика оценки эффективности -│ ├── gitea-client.ts # Gitea API для логирования -│ ├── pipeline-runner.ts # Оркестратор пайплайна -│ └── types.ts # TypeScript-типы системы +│ └── kilocode/ # TypeScript API +├── archive/ # Архив (устаревшие файлы) +├── AGENTS.md # Справка по агентам +└── README.md # Этот документ ``` --- @@ -190,10 +250,11 @@ sed -i 's|/project:|/user:|g' ~/.claude/commands/*.md ```bash git clone https://git.softuniq.eu/UniqueSoft/APAW.git -./APAW/install-apaw.sh /path/to/your-project +cp -r APAW/.claude /path/to/your-project/ +cp -r APAW/.kilo /path/to/your-project/ ``` -Скрипт создаёт `.claude/` в целевом проекте. Команды доступны как `/project:*`. +Копирует `.claude/` и `.kilo/` в целевой проект. Команды доступны как `/project:*`. #### Быстрый старт @@ -253,6 +314,8 @@ git clone https://git.softuniq.eu/UniqueSoft/APAW.git | `@SDETEngineer` | Writes tests following TDD | ollama-cloud/qwen3-coder:480b | | `@LeadDeveloper` | Primary code writer | ollama-cloud/qwen3-coder:480b | | `@FrontendDeveloper` | UI implementation with multimodal | ollama-cloud/kimi-k2.5 | +| `@BackendDeveloper` | Node.js/Express APIs and database | ollama-cloud/qwen3-coder:480b | +| `@GoDeveloper` | Go/Gin/Echo APIs and concurrency | ollama-cloud/deepseek-v3.2 | | `@CodeSkeptic` | Adversarial code reviewer | ollama-cloud/minimax-m2.5 | | `@TheFixer` | Iteratively fixes bugs | ollama-cloud/minimax-m2.5 | | `@PerformanceEngineer` | Reviews for performance issues | ollama-cloud/nemotron-3-super | @@ -262,9 +325,22 @@ git clone https://git.softuniq.eu/UniqueSoft/APAW.git | `@PromptOptimizer` | Improves agent prompts | qwen/qwen3.6-plus:free | | `@ProductOwner` | Manages issue checklists | qwen/qwen3.6-plus:free | | `@Orchestrator` | Routes tasks between agents | ollama-cloud/glm-5 | -| `@AgentArchitect` | Manages agent network per Kilo.ai spec | qwen/qwen3.6-plus:free | +| `@CapabilityAnalyst` | Gap analysis and recommendations | ollama-cloud/gpt-oss:120b | +| `@WorkflowArchitect` | Creates workflow definitions | ollama-cloud/glm-5 | +| `@Planner` | Task decomposition (CoT/ToT) | ollama-cloud/gpt-oss:120b | +| `@Reflector` | Self-reflection and lesson extraction | ollama-cloud/gpt-oss:120b | +| `@MemoryManager` | Memory systems and context retrieval | ollama-cloud/gpt-oss:120b | +| `@MarkdownValidator` | Validates Markdown formatting | ollama-cloud/glm-5 | +| `@BrowserAutomation` | E2E browser testing with Playwright | ollama-cloud/qwen3-coder:480b | +| `@VisualTester` | Visual regression testing | ollama-cloud/qwen3-coder:480b | -> **Note:** For AgentArchitect, use `subagent_type: "system-analyst"` with prompt "You are Agent Architect..." (workaround for unsupported agent-architect type). +### Cognitive Enhancement Agents (Research-Based) + +| Agent | Pattern | Role | +|-------|---------|------| +| `@Planner` | Chain of Thought / Tree of Thoughts | Task decomposition | +| `@Reflector` | Reflexion | Self-reflection and mistake analysis | +| `@MemoryManager` | Memory Architecture | Context and episodic memory | ## Конфигурация разрешений агентов @@ -304,18 +380,17 @@ git clone https://git.softuniq.eu/UniqueSoft/APAW.git ```bash git clone https://git.softuniq.eu/UniqueSoft/APAW.git -cp -r APAW/.kilocode /your-project/ -cp APAW/.kilocodemodes /your-project/ +cp -r APAW/.kilo /your-project/ ``` -KiloCode автоматически обнаружит `.kilocodemodes` и загрузит все режимы агентов. +KiloCode автоматически обнаружит `.kilo/` и загрузит все агенты. Начните с **Requirement Refiner**, введя описание задачи на естественном языке. --- ## PromptOps: Эволюция промптов через Git -Все системные промпты хранятся в `.kilocode/agents/` и версионируются через Git: +Все системные промпты хранятся в `.kilo/agents/` и версионируются через Git: - **Отслеживать эволюцию** — `git diff` покажет изменения, сделанные Prompt Optimizer - **Откатывать изменения** — `git checkout` вернёт предыдущую версию промпта @@ -334,7 +409,7 @@ chore(ai-brain): optimize Lead Dev prompt based on Issue #142 failures ## Оценка эффективности -Файл `.kilocode/logs/efficiency_score.json` хранит историю оценок по каждому Issue: +Файл `.kilo/logs/efficiency_score.json` хранит историю оценок по каждому Issue: ```json { @@ -529,16 +604,28 @@ GITEA_TOKEN=your-token-here --- -## Удаление дубликатов +## Skills System -Если в проекте есть старые файлы в `packages/opencode/`, выполните: +Система навыков в `.kilo/skills/` обеспечивает специализацию агентов: -```bash -sudo rm -rf packages/opencode/src/kilocode/ -``` +### 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 | -Код интегрирован в `src/kilocode/`. - ---- +### Integration & Workflow +| Skill | Purpose | +|-------|---------| +| `gitea-commenting` | Gitea API integration | +| `gitea-workflow` | Workflow execution | +| `research-cycle` | Self-improvement cycle | +| `planning-patterns` | Task decomposition | *Разработано в рамках проекта APAW (Automatic Programmers Agent Workflow) — 2026*