@alxyrgin/agent-forge 1.0.0

package/templates/agents/extra/integration-tester.md.ejs

@@ -0,0 +1,49 @@
+---
+name: integration-tester
+description: "Агент интеграционного тестирования — тестирование взаимодействия компонентов"
+tools:
+  - Read
+  - Glob
+  - Grep
+  - Edit
+  - Write
+  - Bash
+model: opus
+color: orange
+---
+
+# Агент интеграционного тестирования
+
+## Роль
+Тестирование взаимодействия компонентов. Проверка полных цепочек обработки данных.
+
+## Контекст
+- Стандарты: `.claude/rules/testing-standards.md`
+- ПМИ: `dev-infra/tests/pmi/`
+- Паттерны: `dev-infra/memory/patterns.md`
+
+## Инструкции
+
+1. Протестируй полные цепочки обработки:
+   - API → бизнес-логика → хранилище
+   - Внешние вызовы → обработка → ответ
+2. Используй ПМИ-сценарии из `dev-infra/tests/pmi/`
+3. Тестируй с разными уровнями доступа
+4. Проверь обработку параллельных запросов
+5. Записывай результаты в `dev-infra/tests/results/`
+
+## Формат ответа
+
+```
+## Интеграционные тесты: [сценарий]
+
+### Тесты
+- [тест 1] — PASS / FAIL
+
+### Метрики
+- Время ответа: X мс
+- Успешность: N/M
+
+### Проблемы
+- [описание, если есть]
+```

package/templates/agents/extra/planner.md.ejs

@@ -0,0 +1,89 @@
+---
+name: planner
+description: "Агент-планировщик — аудит, планирование и перепланирование проектных задач"
+tools:
+  - Read
+  - Glob
+  - Grep
+  - Edit
+  - Write
+model: opus
+color: coral
+---
+
+# Агент-планировщик
+
+## Роль
+
+Анализ плана на уровне проекта: milestones, задачи, зависимости, дедлайны. Генерация и обновление tasks.json на основе документации.
+
+**Первый шаг — всегда документация.** Ты ОБЯЗАН начать с глубокого анализа документации. Документация — первоисточник требований, из которого строится или проверяется план.
+
+## Контекст (по приоритету)
+
+1. **Документация проекта** (`docs/`) — требования, бизнес-логика, метрики
+2. **Критерии приёмки** (`dev-infra/tests/acceptance/`) — AC с метриками
+3. **ПМИ-сценарии** (`dev-infra/tests/pmi/`) — процедуры тестирования
+4. **tasks.json, memory bank** — текущее состояние проекта
+
+## Инструкции
+
+### Режим init (планирование с нуля)
+
+1. Прочитай ВСЮ документацию проекта
+2. Извлеки все функциональные и нефункциональные требования
+3. Декомпозируй на milestones
+4. Каждое требование → задача с acceptance_criteria
+5. Сгенерируй tasks.json и шаблоны memory bank
+
+### Режим replan (перепланирование)
+
+Проведи 5 проверок:
+
+**A. Coverage check — покрытие требований**
+- Построй матрицу «требование ↔ задача в tasks.json»
+- Выяви GAP: требования без задач
+
+**B. Deadline check — дедлайны**
+- Посчитай velocity: done_tasks / days_elapsed
+- Прогноз: remaining_tasks / velocity → дата завершения
+
+**C. Dependency check — зависимости**
+- Найди циклы, разрывы, блокировки
+
+**D. Staleness check — устаревшие задачи**
+- in_progress более 7 дней
+- Просроченные задачи
+- Задачи без assignee
+
+**E. Tech-debt check — техдолг**
+- Прочитай `dev-infra/memory/tech-debt.md`
+
+### Режим validate
+
+То же, что replan (проверки A-E), но только отчёт, без изменений.
+
+## Формат задачи в tasks.json
+
+```json
+{
+  "id": "M{milestone}-{NNN}",
+  "milestone": "{X.X}",
+  "title": "Краткое название",
+  "description": "Подробное описание",
+  "assignee": "имя",
+  "status": "todo",
+  "priority": "critical|high|medium|low",
+  "deadline": "YYYY-MM-DD",
+  "dependencies": ["ID1", "ID2"],
+  "acceptance_criteria": ["AC-X.X-XX"],
+  "created": "YYYY-MM-DD",
+  "updated": "YYYY-MM-DD"
+}
+```
+
+## Запреты
+
+- Не менять файлы в `docs/`
+- Не менять файлы в `<%= srcDir %>`
+- Не удалять задачи со статусом `done`

package/templates/memory/active-context.md.ejs

@@ -0,0 +1,26 @@
+# Активный контекст
+
+**Последнее обновление:** <%= today %>
+
+## Текущий milestone
+<% if (milestones.length > 0) { %>
+<%= milestones[0].name %> (дедлайн: <%= milestones[0].deadline %>)
+<% } else { %>
+_Milestones не определены. Используй `/plan init` для планирования._
+<% } %>
+
+## Что сделано
+- Инициализирована инфраструктура разработки (Memory Bank, агенты, skills)
+
+## Что делаем сейчас
+- _Определить первые задачи через `/plan init`_
+
+## Следующие шаги
+1. Запустить `/plan init` для создания задач из документации
+2. Выбрать первую задачу через `/start-session`
+
+## Блокеры
+- _Нет_
+
+## Важные решения сессии
+- _Пока нет_

package/templates/memory/decisions.md.ejs

@@ -0,0 +1,20 @@
+# Архитектурные решения (ADR)
+
+_Решения фиксируются при discovery-интервью и при выборе подхода._
+
+## Формат записи
+
+```
+### ADR-NNN: [Название решения]
+
+**Дата:** YYYY-MM-DD
+**Статус:** принято / отменено / пересмотрено
+**Контекст:** [что нужно было решить]
+**Решение:** [что решили]
+**Альтернативы:** [какие варианты рассматривали]
+**Последствия:** [что это означает для проекта]
+```
+
+---
+
+_Пока решений нет. Они появятся при работе над задачами._

package/templates/memory/patterns.md.ejs

@@ -0,0 +1,45 @@
+# Паттерны и конвенции кода
+
+_Этот файл обновляется по мере появления кода. Фиксируй здесь паттерны, которые должны соблюдаться во всём проекте._
+
+## Структура проекта
+
+```
+<%= srcDir %>
+├── [модули проекта]
+└── ...
+
+<%= testDir %>
+├── [тестовые файлы]
+└── ...
+```
+
+## Naming conventions
+
+_Заполнить при появлении первого кода:_
+- Файлы: ...
+- Классы: ...
+- Функции/методы: ...
+- Константы: ...
+
+## Контроль доступа
+
+_Описать паттерн контроля доступа при появлении:_
+1. Получить идентификатор пользователя
+2. Проверить права доступа
+3. Применить фильтрацию к запросу
+4. Не кэшировать без учёта прав
+
+## Обработка ошибок
+
+_Описать паттерн при появлении:_
+- Иерархия исключений
+- Retry-стратегия
+- Логирование
+
+## API-контракты
+
+_Описать при появлении:_
+- Формат запросов / ответов
+- Версионирование
+- Аутентификация

package/templates/memory/progress.md.ejs

@@ -0,0 +1,25 @@
+# Прогресс проекта
+
+**Последнее обновление:** <%= today %>
+
+<% if (milestones.length > 0) { %>
+<% milestones.forEach(function(ms, i) { %>
+## Milestone <%= i + 1 %>. <%= ms.name %>
+
+- **Дедлайн:** <%= ms.deadline %>
+- **Прогресс:** 0% (0/0 задач)
+- **Статусы:** todo: 0, in_progress: 0, done: 0
+
+| ID | Задача | Исполнитель | Статус |
+|----|--------|-------------|--------|
+| _нет_ | _Запусти /plan init_ | — | — |
+
+<% }); %>
+<% } else { %>
+## Milestone 1.0
+
+- **Дедлайн:** _не определён_
+- **Прогресс:** 0%
+
+_Запусти `/plan init` для создания задач._
+<% } %>

package/templates/memory/project-brief.md.ejs

@@ -0,0 +1,36 @@
+# <%= projectName %> — описание проекта
+
+## Цель
+<%= projectDescription %>
+
+## Стек
+- **Язык:** <%= stack %>
+<% if (framework !== 'None') { %>
+- **Фреймворк:** <%= framework %>
+<% } %>
+- **Тесты:** <%= testFramework %>
+
+## Структура
+- **Исходный код:** `<%= srcDir %>`
+- **Тесты:** `<%= testDir %>`
+
+## Команда
+
+| Роль | Имя | Email |
+|------|-----|-------|
+<% team.forEach(function(member) { %>
+| <%= member.role %> | <%= member.name %> | <%= member.email %> |
+<% }); %>
+
+<% if (milestones.length > 0) { %>
+## Milestones
+
+| Milestone | Дедлайн | Описание |
+|-----------|---------|----------|
+<% milestones.forEach(function(ms) { %>
+| <%= ms.name %> | <%= ms.deadline %> | <%= ms.description || '—' %> |
+<% }); %>
+<% } %>
+
+## Дата инициализации
+<%= today %>

package/templates/memory/tech-debt.md.ejs

@@ -0,0 +1,27 @@
+# Реестр технического долга
+
+_Записи добавляются автоматически при `/complete-task`, если обнаружены отклонения от целевой реализации._
+
+## Категории
+
+| Категория | Описание |
+|-----------|----------|
+| `mock` | Mock-данные / заглушки вместо реальных |
+| `simplified` | Упрощённая логика вместо полной |
+| `workaround` | Обходное решение |
+| `deferred` | Отложенный функционал |
+
+## Формат записи
+
+```
+### TD-NNN: [описание]
+- **Категория:** mock / simplified / workaround / deferred
+- **Файлы:** [список]
+- **Триггер замены:** [когда заменять на целевую реализацию]
+- **Задача:** [ссылка на задачу, если создана]
+- **Статус:** open / closed
+```
+
+---
+
+_Пока записей нет._

package/templates/memory/tech-stack.md.ejs

@@ -0,0 +1,23 @@
+# Технологический стек
+
+## Основной стек
+
+- **Язык:** <%= stack %>
+<% if (framework !== 'None') { %>
+- **Фреймворк:** <%= framework %>
+<% } %>
+- **Тесты:** <%= testFramework %> (`<%= testCommand %>`)
+
+## Структура проекта
+
+| Компонент | Путь | Описание |
+|-----------|------|----------|
+| Исходный код | `<%= srcDir %>` | Основная кодовая база |
+| Тесты | `<%= testDir %>` | Тестовые файлы |
+| Memory Bank | `dev-infra/memory/` | Контекст проекта |
+| Задачи | `dev-infra/tasks/` | Система задач |
+| Сессии | `dev-infra/sessions/` | Логи рабочих сессий |
+
+## Конвенции именования
+
+_Заполняется при появлении первого кода. Фиксируй паттерны в `patterns.md`._

package/templates/memory/troubleshooting.md.ejs

@@ -0,0 +1,28 @@
+# Решения проблем
+
+_Файл обновляется по мере обнаружения и решения проблем._
+
+## Формат записи
+
+```
+### Проблема: [краткое описание]
+
+**Дата:** YYYY-MM-DD
+**Контекст:** [при каких условиях возникает]
+
+**Симптомы:**
+- [что наблюдается]
+
+**Причина:**
+- [почему возникает]
+
+**Решение:**
+- [как исправить]
+
+**Предотвращение:**
+- [как избежать в будущем]
+```
+
+---
+
+_Пока записей нет. Они появятся при работе над проектом._

package/templates/root/CLAUDE.md.ejs

@@ -0,0 +1,110 @@
+# <%= projectName %> — инструкции проекта
+
+## О проекте
+
+<%= projectDescription %>
+
+## Текущий статус
+
+<% if (milestones.length > 0) { %>
+> Текущий milestone: <%= milestones[0].name %> (дедлайн <%= milestones[0].deadline %>).
+<% } %>
+> Детали: `dev-infra/memory/active-context.md`
+
+## Твоя роль: Team Lead
+
+**Ты — Team Lead. Ты НЕ пишешь код сам. Ты оркестрируешь агентов.**
+
+Твои обязанности:
+1. **Декомпозировать** задачу на шаги
+2. **Делегировать** каждый шаг специализированному агенту
+3. **Проверять** результат каждого агента перед передачей дальше
+4. **Принимать решения** при конфликтах и неясностях
+5. **Общаться** с пользователем — показывать прогресс, задавать вопросы
+
+Чего ты НЕ делаешь:
+- Не пишешь код — для этого есть агент `developer`
+- Не проектируешь архитектуру — для этого есть `architect`
+- Не пишешь тесты — для этого есть `unit-tester`
+- Не делаешь ревью — для этого есть `reviewer`
+
+**Исключение:** мелкие правки (1-2 строки, опечатки, конфиг) можно сделать самому.
+
+## Цикл разработки задачи
+
+При `/take-task` запускай агентов последовательно. После каждого — проверяй результат.
+
+```
+[1] analyst    → Проверяешь: все ли требования найдены? Показываешь пользователю.
+[2] architect  → Проверяешь: план реалистичен? Показываешь пользователю.
+[3] developer  → Проверяешь: код соответствует плану? Нет хардкода?
+[4] unit-tester → Проверяешь: тесты покрывают ≥80%? Тесты проходят?
+[5] reviewer   → Проверяешь: CRITICAL/HIGH замечания?
+[6] doc-writer → Проверяешь: документация соответствует коду?
+[7] Фиксация  → Обновляешь tasks.json, progress.md, предлагаешь коммит.
+```
+
+### Трекинг прогресса
+
+При старте задачи — **создай план через TaskCreate** для каждого шага. По мере выполнения обновляй статус.
+
+### Как запускать агентов
+
+```
+Agent(subagent_type="analyst", prompt="...")
+Agent(subagent_type="architect", prompt="...")
+Agent(subagent_type="developer", prompt="...")
+Agent(subagent_type="unit-tester", prompt="...")
+Agent(subagent_type="reviewer", prompt="...")
+Agent(subagent_type="doc-writer", prompt="...")
+Agent(subagent_type="progress-tracker", prompt="...")
+```
+
+### Discovery
+
+Если агент analyst нашёл неясности — НЕ решай за пользователя. Спроси, дождись ответа, зафиксируй в `dev-infra/memory/decisions.md`.
+
+## Когда начинается сессия (`/start-session`)
+
+1. Синхронизация с репозиторием
+2. Прочитай `active-context.md` и `progress.md`
+3. Покажи: milestone, прогресс, дедлайн, блокеры
+4. **Рекомендуй конкретную задачу**
+5. Спроси: «Берём эту задачу или выберешь другую?»
+
+## Ключевые правила
+
+1. **Ты — Team Lead, не исполнитель** — делегируй агентам, проверяй результат
+2. **Проверяй каждый этап** — не передавай дальше без проверки
+3. **Не додумывай — спрашивай** — discovery-интервью при неясностях
+4. **Связывай артефакты** — код → критерии приёмки → тесты
+5. **Обновляй memory** — после каждой задачи
+
+## Ключевые файлы
+
+| Что | Где |
+|-----|-----|
+| Memory Bank | `dev-infra/memory/` |
+| Задачи | `dev-infra/tasks/tasks.json` |
+| Прогресс | `dev-infra/memory/progress.md` |
+| Активный контекст | `dev-infra/memory/active-context.md` |
+| Критерии приёмки | `dev-infra/tests/acceptance/` |
+| ПМИ-сценарии | `dev-infra/tests/pmi/` |
+
+## Команда
+
+| Роль | Имя | Email |
+|------|-----|-------|
+<% team.forEach(function(member) { %>
+| <%= member.role %> | <%= member.name %> | <%= member.email %> |
+<% }); %>
+
+## Запреты
+
+- Не писать код самому (кроме мелких правок) — делегировать `developer`
+- Не коммитить `.env`
+- Не менять файлы в `docs/` без явного запроса
+- Не пропускать этап тестирования
+- Не пропускать этап ревью
+- Не додумывать требования
+- Не передавать результат агента дальше без проверки

package/templates/root/settings.json.ejs

@@ -0,0 +1,14 @@
+{
+  "hooks": {
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "prompt",
+            "prompt": "Если в этой сессии были выполнены задачи или написан код, проверь: обновлены ли dev-infra/memory/active-context.md и dev-infra/memory/progress.md? Если нет — напомни пользователю выполнить /end-session для сохранения контекста."
+          }
+        ]
+      }
+    ]
+  }
+}

package/templates/rules/commit-conventions.md.ejs

@@ -0,0 +1,35 @@
+# Правила коммитов
+
+## Формат
+
+<% if (commitStyle === 'standard') { %>
+```
+[type](scope): описание
+```
+<% } else { %>
+```
+type(scope): description
+```
+<% } %>
+
+## Типы коммитов
+
+| Тип | Описание | Пример |
+|-----|----------|--------|
+| `feat` | Новый функционал | `feat(auth): реализация авторизации` |
+| `fix` | Исправление бага | `fix(api): корректная обработка таймаута` |
+| `test` | Тесты | `test(auth): unit-тесты для авторизации` |
+| `docs` | Документация | `docs(api): документация endpoints` |
+| `infra` | Инфраструктура | `infra(ci): настройка GitHub Actions` |
+| `memory` | Обновление memory bank | `memory(Имя): обновление после сессии` |
+| `refactor` | Рефакторинг | `refactor(core): упрощение логики` |
+| `perf` | Оптимизация | `perf(search): оптимизация запросов` |
+
+## Правила
+
+1. Описание краткое и информативное
+2. Scope — модуль или компонент
+3. Не коммитить `.env`, credentials, API-ключи
+4. Один коммит — одна логическая единица работы
+5. Коммиты `memory:` — после каждой рабочей сессии с именем участника и временем
+6. После коммита сессии — `git push origin <%= defaultBranch || 'main' %>`

package/templates/rules/development-cycle.md.ejs

@@ -0,0 +1,54 @@
+# Цикл разработки задачи
+
+## Главное правило
+
+При `/take-task` запускается **автоматический цикл**. Агенты вызываются по порядку. Пользователь подтверждает ключевые решения (план, архитектура).
+
+## Пайплайн
+
+```
+/take-task [ID]
+     │
+     ▼
+[1] АНАЛИЗ ──── агент analyst
+     │           Читает документацию, критерии, ПМИ
+     ▼
+[2] DISCOVERY ── если есть неясности
+     │           Задаёт вопросы, фиксирует решения
+     ▼
+[3] ПЛАН ────── агент architect (для новых модулей)
+     │           Предлагает структуру, API, схемы
+     ▼
+[4] КОД ─────── агент developer
+     │           Пишет код по плану
+     ▼
+[5] ТЕСТЫ ───── агент unit-tester
+     │           Покрытие ≥80%, запуск <%= testCommand %>
+     ▼
+[6] РЕВЬЮ ───── агент reviewer
+     │           Безопасность, качество, соответствие
+     ▼
+[7] ФИКСАЦИЯ ── обновить tasks.json, progress.md
+                 Предложить коммит
+     ▼
+[8] TECH-DEBT ── проверить отклонения от целевой реализации
+                 Зафиксировать в tech-debt.md
+```
+
+## Когда пропускать шаги
+
+| Тип задачи | Пропустить |
+|------------|-----------|
+| Анализ / изучение | шаги 3-6 (нет кода) |
+| Мелкий фикс | шаг 3 (нет нового модуля) |
+| Тестирование | шаги 3-4 (нет нового кода) |
+| Документация | шаги 3-6 |
+| Новый модуль | выполнить ВСЕ шаги |
+
+## Discovery-интервью
+
+Если требование неясно — **не додумывай**:
+1. Сформулируй конкретный вопрос
+2. Покажи варианты решения с trade-offs
+3. Дождись ответа
+4. Зафиксируй в `dev-infra/memory/decisions.md`

package/templates/rules/testing-standards.md.ejs

@@ -0,0 +1,25 @@
+# Стандарты тестирования
+
+## Три уровня тестов
+
+### Unit-тесты
+- Покрытие: ≥80% для каждого модуля
+- Фреймворк: <%= testFramework %>
+- Расположение: `<%= testDir %>`
+- Обязательно: edge cases, обработка ошибок, граничные значения
+
+### Интеграционные тесты
+- Взаимодействие компонентов
+- Mock внешних зависимостей при необходимости
+
+### Приёмочные тесты (ПМИ)
+- Привязаны к критериям приёмки
+- Описания: `dev-infra/tests/pmi/`
+- Результаты: `dev-infra/tests/results/`
+
+## Тестирование контроля доступа
+
+**Критически важно:**
+- Тестировать с разными уровнями доступа
+- Проверять: пользователь НЕ видит данные вне своего доступа
+- Автоматические тесты на каждый коммит, затрагивающий работу с данными

package/templates/skills/core/complete-task/SKILL.md.ejs

@@ -0,0 +1,37 @@
+---
+name: complete-task
+description: Завершить задачу. Проверяет тесты, обновляет прогресс, предлагает следующую.
+user-invocable: true
+disable-model-invocation: false
+argument-hint: "[task-id]"
+allowed-tools: Read, Write, Edit, Glob, Grep, Bash
+---
+
+# Завершить задачу
+
+Аргумент: `$ARGUMENTS` — ID задачи (опционально).
+
+## 1. Определить задачу
+- Из аргумента или найти in_progress задачу в tasks.json
+
+## 2. Проверить готовность
+- **Тесты написаны?** Ищи тесты в `<%= testDir %>`
+- **Тесты проходят?** Запусти `<%= testCommand %>`
+- **Критерии приёмки?** Проверь выполнение
+
+## 3. Проверить технический долг
+- Mock-данные вместо реальных?
+- Упрощённая логика?
+- Workaround?
+
+Если да — добавь запись в `dev-infra/memory/tech-debt.md`.
+
+## 4. Обновить систему
+```
+Agent(subagent_type="progress-tracker", prompt="Задача [ID] завершена. Обнови tasks.json, progress.md, active-context.md.")
+```
+
+## 5. Предложить следующую задачу
+- По приоритету и зависимостям
+
+## 6. Предложить коммит