@alxyrgin/agent-forge 1.0.0 → 3.1.0

package/templates/skills/core/end-session/SKILL.md.ejs

@@ -1,6 +1,6 @@
 ---
 name: end-session
-description: Завершение рабочей сессии. Сохраняет контекст, обновляет memory bank, создаёт лог сессии.
+description: Завершение рабочей сессии. Сохраняет контекст, checkpoint, обновляет memory bank, создаёт лог сессии.
 user-invocable: true
 disable-model-invocation: false
 allowed-tools: Read, Write, Edit, Glob, Grep, Bash
@@ -17,7 +17,14 @@ allowed-tools: Read, Write, Edit, Glob, Grep, Bash
 Что ещё было сделано в этой сессии, помимо того, что я зафиксировал?
 ```
 
-## 2. Обновить active-context.md
+## 2. Сохранить checkpoint (если задача не закончена)
+
+Прочитай `dev-infra/memory/checkpoint.yml`. Если `active: true`:
+- Убедись, что `current_step`, `step_name` и `context` актуальны
+- Обнови `last_updated` на текущую дату
+- Сообщи пользователю: «Checkpoint сохранён. При следующем /start-session предложу восстановление.»
+
+## 3. Обновить active-context.md
 
 Перезапиши `dev-infra/memory/active-context.md`:
 - **Дата:** сегодня
@@ -27,15 +34,15 @@ allowed-tools: Read, Write, Edit, Glob, Grep, Bash
 - **Блокеры:** если появились
 - **Важные решения:** если были (также добавь в decisions.md)
 
-## 3. Обновить progress.md
+## 4. Обновить progress.md
 
 Пересчитай статусы задач из tasks.json.
 
-## 4. Определить участника
+## 5. Определить участника
 
 Определи, кто работал в этой сессии. Если неясно — спроси.
 
-## 5. Создать лог сессии
+## 6. Создать лог сессии
 
 Получи текущее время: `date +%H:%M`
 
@@ -65,7 +72,7 @@ allowed-tools: Read, Write, Edit, Glob, Grep, Bash
 - [если есть]
 ```
 
-## 6. Коммит и пуш
+## 7. Коммит и пуш
 
 Формат коммита:
 ```
@@ -75,6 +82,7 @@ memory(Участник): обновление после сессии YYYY-MM-D
 Включить в коммит:
 - dev-infra/memory/active-context.md
 - dev-infra/memory/progress.md
+- dev-infra/memory/checkpoint.yml
 - dev-infra/sessions/YYYY-MM-DD_HH-MM.md
 - dev-infra/tasks/tasks.json (если обновлён)
 

package/templates/skills/core/review/SKILL.md.ejs

@@ -25,5 +25,5 @@ Agent(subagent_type="reviewer", prompt="Проверь файл [путь]. Па
 1. Загрузи задачу из `dev-infra/tasks/tasks.json`
 2. Найди acceptance_criteria и связанные файлы
 3. ДЕЛЕГИРУЙ агенту reviewer
-4. Если задача работает с данными — дополнительно запусти security-auditor
+4. Если задача работает с данными — укажи reviewer'у фокус на безопасность (check_security: true)
 5. Покажи сводный отчёт

package/templates/skills/core/start-session/SKILL.md.ejs

@@ -1,6 +1,6 @@
 ---
 name: start-session
-description: Начало рабочей сессии. Загружает контекст проекта, показывает прогресс и рекомендует задачу.
+description: Начало рабочей сессии. Загружает контекст проекта, показывает прогресс и рекомендует задачу. Используй при запуске Claude Code, начале работы, или когда пользователь говорит «начать», «что делать», «где мы».
 user-invocable: true
 disable-model-invocation: false
 allowed-tools: Read, Glob, Grep, Bash
@@ -16,43 +16,106 @@ allowed-tools: Read, Glob, Grep, Bash
 git fetch origin
 ```
 
-Проверь, есть ли новые коммиты:
+Проверь, есть ли новые коммиты от других разработчиков:
 ```bash
 git log HEAD..origin/<%= defaultBranch || 'main' %> --oneline
 ```
 
-Если есть новые коммиты — подтяни:
+Если есть новые коммиты — подтяни изменения:
 ```bash
 git pull origin <%= defaultBranch || 'main' %>
 ```
 
+Если есть изменения — сообщи пользователю:
+```
+Подтянуты изменения от [автор]: [описание коммитов]
+```
+
+Если конфликт слияния — сообщи и помоги разрешить.
+
 ## 2. Загрузить контекст
 
 Прочитай параллельно:
 - `dev-infra/memory/active-context.md`
 - `dev-infra/memory/progress.md`
 - `dev-infra/tasks/tasks.json`
+- `dev-infra/memory/checkpoint.yml`
+
+### Checkpoint recovery
+
+Если в `checkpoint.yml` поле `active: true` — есть незавершённая задача:
+```
+Обнаружен незавершённый checkpoint:
+- Задача: [task_id] — [task_title]
+- Размер: [feature_size]
+- Последний шаг: [current_step]
+- Последнее обновление: [last_updated]
+
+Продолжить с [current_step] через /take-task [task_id]?
+```
+
+## 2.5. Проверка tech-debt триггеров
+
+Прочитай `dev-infra/memory/tech-debt.md`. Для каждой записи со статусом `open` или `partially_resolved`:
+1. Проверь поле «Триггер замены» — наступил ли триггер?
+2. Сопоставь с текущим состоянием проекта:
+   - Задача-триггер в статусе `done`? (проверь tasks.json)
+   - Ресурс появился? (production DB, API-ключ)
+   - Milestone завершён?
+
+Если найдены TD-записи с наступившими триггерами — покажи:
+```
+Tech-debt: можно закрыть N записей:
+- TD-XXX: [описание] -> триггер «[триггер]» наступил ([почему])
+- TD-YYY: [описание] -> триггер «[триггер]» наступил ([почему])
+
+Создать задачи на закрытие или отложить?
+```
+
+Если пользователь подтверждает — создай задачи в tasks.json (тип: tech-debt, приоритет по влиянию).
+Если нет наступивших триггеров — пропусти молча.
 
 ## 3. Показать сводку
 
 Выведи компактно:
-- **Milestone:** какой milestone, процент выполнения
-- **Дедлайн:** дата, сколько дней осталось
-- **Прогресс:** задач done / in_progress / todo
+- **Этап и milestone:** какой этап, какой milestone, процент выполнения
+- **Дедлайн:** дата (контракт / внутренний), сколько дней осталось
+- **Прогресс:** сколько задач done / in_progress / todo / blocked
 - **Блокеры:** если есть — подсветить
+- **Tech-debt:** N open / N partially_resolved (если есть с наступившими триггерами — подсветить)
 
 ## 4. Показать незавершённые задачи
 
-Из tasks.json покажи задачи со статусом `in_progress`.
+Из tasks.json покажи задачи со статусом `in_progress` (те, что уже начаты).
 Если таких нет — покажи `todo` с приоритетом critical/high.
 
 ## 5. Рекомендовать задачу
 
-Выбери ОДНУ задачу и объясни почему:
+Выбери ОДНУ конкретную задачу и объясни почему:
 - Приоритет (critical первые)
-- Зависимости выполнены?
+- Зависимости выполнены? (dependencies — все ли в статусе done?)
 - Дедлайн (что ближе?)
+- Исполнитель (задачи текущего разработчика приоритетнее)
+
+Формат:
+```
+Рекомендую начать с [ID] «[название]» — приоритет [priority],
+зависимость [dep] выполнена, дедлайн [date].
+Берём эту задачу?
+```
+
+### Проверка плана (опционально)
+
+Если при загрузке контекста обнаружены проблемы:
+- Просроченные задачи (deadline_internal < сегодня, status != done)
+- Задачи in_progress >7 дней без обновлений
+- Блокирующие зависимости (todo зависит от todo)
+
+Добавь к сводке:
+```
+Обнаружены проблемы с планом (N шт.). Рекомендую: /plan validate
+```
 
 ## 6. Ожидать решения
 
-Дождись ответа. Если согласен — запусти `/take-task` для этой задачи.
+Дождись ответа пользователя. Если согласен — автоматически запусти `/take-task` для этой задачи.

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

@@ -1,69 +1,318 @@
 ---
 name: take-task
-description: Взять задачу в работу и запустить полный цикл разработки (анализ → план → код → тесты → ревью).
+description: |
+  Взять задачу в работу и запустить полный цикл разработки.
+  Определяет размер (S/M/L), запускает агентов по пайплайну, проверяет quality gates.
+
+  Use when: «возьми задачу», «давай делать», «начни работу над», «следующая задача», «take task»
 user-invocable: true
 disable-model-invocation: false
 argument-hint: "[task-id]"
 allowed-tools: Read, Write, Edit, Glob, Grep, Bash, Agent, WebSearch
 ---
 
-# Взять задачу и запустить полный цикл разработки
+# Взять задачу и запустить цикл разработки
 
 Аргумент: `$ARGUMENTS` — ID задачи (опционально). Если не указан — покажи доступные.
 
+## Шаг 0. Checkpoint (восстановление после обрыва)
+
+1. Прочитай `dev-infra/memory/checkpoint.yml`
+2. Если `active: true` — предложи восстановление:
+   ```
+   Обнаружен незавершённый checkpoint:
+   - Задача: [task_id] — [task_title]
+   - Последний шаг: [current_step]
+   - Прогресс: [completed_steps / total_steps]
+
+   Продолжить с [current_step] или начать заново?
+   ```
+3. При продолжении — перейди к текущему шагу, загрузив контекст из checkpoint
+4. При начале заново — очисти checkpoint (active: false)
+
 ## Если ID не указан
 
 1. Прочитай `dev-infra/tasks/tasks.json`
 2. Покажи задачи для текущего milestone со статусом `todo`, отсортированные по приоритету
 3. Проверь зависимости: не предлагай задачу, если её dependencies не в статусе done
-4. Спроси, какую задачу взять
+4. Для каждой: ID, название, приоритет, wave, дедлайн
+5. Спроси, какую задачу взять
 
-## При выборе задачи — автоматический цикл
+## Определение размера
 
-### Шаг 1. Обновить статус и создать план
-- В tasks.json: статус → `in_progress`, updated → сегодня
-- Создать прогресс-бар задачи через TaskCreate
+| Критерий | S (Small) | M (Medium) | L (Large) |
+|----------|-----------|------------|-----------|
+| Файлы | 1-2 | 3-5 | >5 или новый модуль |
+| AC | Нет или простые | Есть AC | Несколько AC + ПМИ |
+| Зависимости | 0-1 | 1-2 | 3+ |
+| Тип | Фикс, правка, конфиг | Новая функция | Новый модуль, архитектура |
 
-### Шаг 2. Анализ требований — ДЕЛЕГИРОВАТЬ агенту analyst
 ```
-Agent(subagent_type="analyst", prompt="Проанализируй задачу [ID]. Описание: [description].")
+Задача [ID]: [название]
+Размер: [S / M / L] — [обоснование]
+Пайплайн: [N шагов]
 ```
 
-Покажи пользователю результат анализа. Дождись подтверждения.
+## Обновить статус и создать план
 
-### Шаг 3. Discovery (если есть вопросы)
-- Задай конкретные вопросы пользователю
-- Зафиксируй решения в `dev-infra/memory/decisions.md`
+- tasks.json: статус -> `in_progress`, updated -> сегодня
+- active-context.md: обновить «Что делаем сейчас»
+- checkpoint.yml:
+  ```yaml
+  active: true
+  task_id: [ID]
+  task_title: [название]
+  feature_size: [S/M/L]
+  current_step: start
+  started_at: [ISO-8601]
+  steps: {}
+  ```
+- Создать прогресс-бар через TaskCreate по размеру
 
-### Шаг 4. Проектирование — ДЕЛЕГИРОВАТЬ агенту architect
+**Для S (6 шагов):**
 ```
-Agent(subagent_type="architect", prompt="Спроектируй [модуль]. Требования: [результат шага 2].")
+TaskCreate(subject="[ID] Реализация кода")
+TaskCreate(subject="[ID] Тесты + Inspector")
+TaskCreate(subject="[ID] Quick Review")
+TaskCreate(subject="[ID] Tech-debt проверка")
+TaskCreate(subject="[ID] Фиксация результата")
 ```
-- Покажи план пользователю, дождись подтверждения
 
-### Шаг 5. Реализация — ДЕЛЕГИРОВАТЬ агенту developer
+**Для M (8 шагов):**
 ```
-Agent(subagent_type="developer", prompt="Реализуй [модуль] по плану: [результат шага 4].")
+TaskCreate(subject="[ID] Анализ требований")
+TaskCreate(subject="[ID] TDD — failing тесты (RED)")
+TaskCreate(subject="[ID] Реализация + тесты (GREEN)")
+TaskCreate(subject="[ID] Inspector — качество тестов")
+TaskCreate(subject="[ID] Код-ревью")
+TaskCreate(subject="[ID] Tech-debt проверка")
+TaskCreate(subject="[ID] Фиксация результата")
 ```
-- Проверь: код соответствует плану?
 
-### Шаг 6. Тестирование — ДЕЛЕГИРОВАТЬ агенту unit-tester
+**Для L (10 шагов):**
 ```
-Agent(subagent_type="unit-tester", prompt="Напиши тесты для [модуль]. Покрытие ≥80%. Запусти <%= testCommand %>.")
+TaskCreate(subject="[ID] Анализ требований")
+TaskCreate(subject="[ID] Архитектура + ревью плана")
+TaskCreate(subject="[ID] Reality Check (skeptic)")
+TaskCreate(subject="[ID] TDD + Код + Тесты (per-feature)")
+TaskCreate(subject="[ID] Inspector — качество тестов")
+TaskCreate(subject="[ID] Код-ревью")
+TaskCreate(subject="[ID] Tech-debt проверка")
+TaskCreate(subject="[ID] Фиксация результата")
 ```
-- Если тесты падают — верни developer'у
 
-### Шаг 7. Ревью — ДЕЛЕГИРОВАТЬ агенту reviewer
+---
+
+## Шаги пайплайна
+
+### [1] Анализ требований (M, L)
+
+**Перед вызовом analyst:**
+1. Прочитай tasks.json — извлеки задачу (description, acceptance_criteria, pmi_scenarios, risks)
+2. Прочитай `dev-infra/tests/acceptance/` — найди конкретные метрики для AC
+3. Прочитай `dev-infra/memory/tech-debt.md` — найди связанные TD-записи
+4. Прочитай `dev-infra/memory/decisions.md` — найди связанные ADR
+
 ```
-Agent(subagent_type="reviewer", prompt="Проверь код в [файлы]. Критерии: [AC IDs].")
+Agent(subagent_type="analyst", prompt="
+Проанализируй задачу [ID].
+Описание: [description]
+AC: [AC-X.X-XX — полная метрика, не только ID]
+PMI: [pmi-XX — описание]
+Риски: [R-XXX — описание, приоритет]
+Tech-debt: [TD-NNN — если связан]
+Решения: [ADR-NNN — если связан]
+")
 ```
-- Если CRITICAL/HIGH — верни developer'у
 
-### Шаг 8. Документация — ДЕЛЕГИРОВАТЬ агенту doc-writer
+**Обработка verdict:**
+- `COMPLETE` -> показать результат пользователю, перейти к следующему шагу
+- `NEEDS_DISCOVERY` -> показать вопросы пользователю, дождаться ответа, зафиксировать в decisions.md, повторить analyst
+
+Checkpoint: `steps.analysis = {status: done, verdict: ..., key_findings: [...]}`
+
+### Discovery (если NEEDS_DISCOVERY)
+
+1. Покажи вопросы из analyst в формате:
+   ```
+   Вопрос 1: [текст]
+   Варианты:
+   a) [вариант] — [trade-off]
+   b) [вариант] — [trade-off]
+   ```
+2. Дождись ответа пользователя
+3. Зафиксируй решение в `dev-infra/memory/decisions.md` (формат ADR)
+4. Повторно вызови analyst с дополненным контекстом
+
+### [2] Архитектура + ревью плана (L)
+
+Запусти параллельно:
+
 ```
-Agent(subagent_type="doc-writer", prompt="Создай документацию для задачи [ID].")
+Agent(subagent_type="architect", prompt="
+Спроектируй [модуль]. Требования от аналитика: [результат analyst].
+Верни: структуру файлов, API-контракты, модели, стратегию контроля доступа.
+Раздели на features для per-feature loop (с порядком по зависимостям).
+")
+
+Agent(subagent_type="reviewer", prompt="
+mode: plan_review
+Проверь план архитектора на полноту.
+Требования: [результат analyst].
+AC: [полные метрики]
+Риски: [R-XXX с описанием]
+")
 ```
 
-### Шаг 9. Завершение
-- Покажи итог: что сделано, результат тестов, ревью
-- Предложи: `/complete-task`
+**Обработка verdict (комбинация):**
+- architect(READY) + reviewer(APPROVE) -> показать пользователю, ждать подтверждения
+- architect(READY) + reviewer(REQUEST_CHANGES) -> architect исправляет -> повторить оба
+- architect(NEEDS_INPUT) -> запросить данные -> повторить
+
+Checkpoint: `steps.architecture = {status: done, plan_summary: "...", files: [...]}`
+
+### [3] Reality Check (L)
+
+```
+Agent(subagent_type="skeptic", prompt="
+Проверь спецификацию на миражи: [план от architect].
+Кодовая база: <%= srcDir %>
+")
+```
+
+**Обработка verdict:**
+- `PASS` -> продолжить
+- `PASS_WITH_WARNINGS` -> передать warnings developer'у в prompt
+- `FAIL` -> вернуть architect, показать issues
+
+Checkpoint: `steps.skeptic = {status: done, verdict: ..., warnings: [...]}`
+
+### [4] TDD — failing тесты, RED (M, L)
+
+Для M-задач — один вызов. Для L — per-feature.
+
+```
+Agent(subagent_type="tester", prompt="
+mode: tdd
+Создай failing тесты для [фича/задача].
+TDD-якоря: [tdd_anchors из tasks.json]
+Директория тестов: <%= testDir %>
+Фреймворк: <%= testFramework %>
+Тесты должны FAIL (код ещё не написан).
+")
+```
+
+Проверь: тесты действительно fail. Если pass — значит якоря некорректны.
+
+```bash
+<%= testCommand %>
+```
+
+Checkpoint: `steps.tdd = {status: done, failing_tests: [...]}`
+
+### [5] Реализация + тесты (per-feature)
+
+**Для S-задач:** один цикл developer -> tester -> inspector.
+**Для M-задач:** developer -> tester(GREEN) -> inspector.
+**Для L-задач:** per-feature loop из плана architect.
+
+Per-feature loop (L):
+
+```
+features = план architect -> details.features (упорядочены по зависимостям)
+
+for feature in features:
+    # 1. Developer реализует
+    Agent(subagent_type="developer", prompt="
+    Реализуй [feature]. План: [план].
+    Warnings от skeptic: [если есть].
+    TDD: сделай failing тесты GREEN.
+    Failing тесты: [список из шага TDD].
+    Запусти: <%= testCommand %>
+    ")
+
+    # Проверка verdict developer
+    if developer.verdict == BLOCKED:
+        -> показать пользователю, разобрать блокировку
+
+    # 2. Tester проверяет
+    Agent(subagent_type="tester", prompt="
+    level: unit
+    Проверь [конкретные файлы feature].
+    Убедись: failing тесты теперь GREEN.
+    Добавь edge cases сверх TDD-якорей.
+    Покрытие >=80%.
+    Фреймворк: <%= testFramework %>
+    Запусти: <%= testCommand %>
+    ")
+
+    # Проверка verdict tester
+    if tester.verdict == FAIL:
+        -> передать developer для исправления -> повторить tester
+
+    # 3. Inspector проверяет качество тестов
+    Agent(subagent_type="inspector", prompt="
+    Проверь качество тестов для [feature].
+    Файлы: [тестовые файлы от tester].
+    ")
+
+    # Проверка verdict inspector
+    if inspector.verdict == REQUEST_CHANGES:
+        -> передать tester для исправления -> повторить inspector
+
+    Checkpoint: steps.developer.features_done += 1
+```
+
+Checkpoint: `steps.developer = {status: done, files_changed: [...], features_done: N, features_total: N}`
+
+### [6] Ревью (S. quick, M/L. full)
+
+**S-задачи (quick review):**
+```
+Agent(subagent_type="reviewer", prompt="
+mode: quick
+Проверь: [файлы от developer].
+Только: security, контроль доступа, критические баги.
+1 раунд, MEDIUM/LOW -> tech-debt.
+")
+```
+
+**M/L-задачи (full review):**
+```
+Agent(subagent_type="reviewer", prompt="
+Проверь код: [файлы от developer].
+AC: [полные метрики из tasks.json — НЕ только ID]
+Риски: [R-XXX с описанием]
+Раунд: 1/3.
+")
+```
+
+**Обработка verdict:**
+- `APPROVE` -> перейти к tech-debt
+- `REQUEST_CHANGES` (раунд 1-2) -> developer исправляет -> reviewer повторяет (раунд N+1)
+- `ESCALATE` (раунд 3) -> показать пользователю все findings -> 3 варианта:
+  - (a) Принять как tech-debt -> TD-NNN
+  - (b) Исправить вручную -> повторить ревью
+  - (c) Отменить задачу -> rollback
+
+Checkpoint: `steps.review = {status: done, round: N, verdict: ..., findings_count: N}`
+
+### [7] Tech-debt проверка (ВСЕ размеры)
+
+Team Lead проверяет 3 источника:
+
+1. **Reviewer findings** — MEDIUM/LOW не исправленные в этой задаче
+2. **Implementation deviations** — ищи в коде: mock, simplified, workaround, deferred, TODO, FIXME, HACK
+3. **Skeptic warnings** (L) — не адресованные в коде
+
+Если найдено -> добавить TD-NNN в `dev-infra/memory/tech-debt.md`.
+Если нет -> `tech_debt: none` в checkpoint.
+
+### [8] Фиксация
+
+1. Покажи пользователю итог: что сделано, файлы, тесты, ревью, tech-debt
+2. Обнови tasks.json: status -> done, updated -> сегодня
+3. Обнови progress.md: пересчитать прогресс milestone
+4. Обнови active-context.md: убрать задачу, добавить результат
+5. Очисти checkpoint: `active: false`
+6. Предложи коммит