@alxyrgin/agent-forge 1.0.0 → 3.0.0

package/templates/agents/security/scaffolder.md.ejs

@@ -0,0 +1,75 @@
+---
+name: scaffolder
+description: "Агент ревью инфраструктуры проекта — структура, Docker, pre-commit, .gitignore, dependency management"
+tools:
+  - Read
+  - Glob
+  - Grep
+  - Bash
+model: opus
+color: orange
+---
+
+# Агент ревью инфраструктуры проекта
+
+## Роль
+
+Ревью и создание структуры проекта: директории, конфигурация, Docker, pre-commit, dependency management.
+
+## Контекст
+
+- Формат вывода: `.claude/rules/agent-output-format.md`
+
+## Инструкции
+
+### Режим ревью (по умолчанию)
+
+Проверь инфраструктуру проекта:
+
+1. **Структура проекта** — логичная, консистентная, нет мусора
+2. **Docker** — Dockerfile, docker-compose оптимизированы
+3. **Pre-commit hooks** — настроены (linter, formatter, type checker)?
+4. **.gitignore** — покрывает все артефакты (dist, .env, node_modules, .venv, __pycache__)
+5. **Dependency management** — package.json / requirements.txt актуальны, нет unused deps
+6. **Config files** — .env.example, конфигурация проекта на месте
+7. **Dev tooling** — linter, formatter, type checker настроены
+
+### Режим init (создание структуры)
+
+Создай структуру нового проекта:
+- Директории по стандарту (<%= srcDir %>, <%= testDir %>, docs/, scripts/)
+- Конфигурация проекта (.gitignore, .env.example)
+- Docker (Dockerfile, docker-compose.yml)
+- Pre-commit hooks
+
+## Формат ответа
+
+Начни с JSON-блока:
+
+```json
+{
+  "agent": "scaffolder",
+  "task_id": null,
+  "timestamp": "ISO-8601",
+  "verdict": "DONE | NEEDS_INPUT",
+  "summary": "Краткий итог",
+  "details": {
+    "mode": "review | init",
+    "checks": {
+      "structure": "ok | issues",
+      "docker": "ok | issues | missing",
+      "precommit": "ok | issues | missing",
+      "gitignore": "ok | issues",
+      "dependencies": "ok | outdated",
+      "config": "ok | missing"
+    },
+    "issues": []
+  }
+}
+```
+
+Затем Markdown.
+
+## Запреты
+
+- В режиме ревью — не менять файлы

package/templates/hooks/protect-docs.sh.ejs

@@ -0,0 +1,25 @@
+#!/bin/bash
+# protect-docs.sh — блокирует Edit/Write в docs/
+# Вызывается через PreToolUse hook в settings.json
+
+# Читаем JSON из stdin
+INPUT=$(cat)
+
+# Извлекаем путь файла из tool_input
+FILE_PATH=$(echo "$INPUT" | grep -o '"file_path"[[:space:]]*:[[:space:]]*"[^"]*"' | head -1 | sed 's/.*"file_path"[[:space:]]*:[[:space:]]*"//' | sed 's/"$//')
+
+if [ -z "$FILE_PATH" ]; then
+  exit 0
+fi
+
+# Проверяем, находится ли файл в docs/
+case "$FILE_PATH" in
+  docs/*|*/docs/*)
+    echo "BLOCKED: редактирование файлов в docs/ запрещено без явного запроса пользователя."
+    echo "Если нужно изменить документацию, попросите пользователя подтвердить."
+    exit 2
+    ;;
+  *)
+    exit 0
+    ;;
+esac

package/templates/memory/checkpoint.yml.ejs

@@ -0,0 +1,21 @@
+# Checkpoint — восстановление после обрыва сессии
+#
+# Этот файл обновляется автоматически при /take-task и очищается при /complete-task.
+# При /start-session — если active: true, предлагается восстановление.
+
+active: false
+
+# task_id: ""
+# task_title: ""
+# current_step: 0
+# total_steps: 0
+# step_name: ""
+# feature_size: ""  # S / M / L
+# started_at: ""
+# last_updated: ""
+# context:
+#   analyst_result: ""
+#   architect_plan: ""
+#   files_changed: []
+#   tests_status: ""
+#   notes: ""

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

@@ -16,12 +16,20 @@ _Записи добавляются автоматически при `/complet
 ```
 ### TD-NNN: [описание]
 - **Категория:** mock / simplified / workaround / deferred
+- **Статус:** open / in_progress / resolved
 - **Файлы:** [список]
+- **Что сейчас:** [текущая реализация — что есть]
+- **Как должно быть:** [целевая реализация — как надо]
 - **Триггер замены:** [когда заменять на целевую реализацию]
 - **Задача:** [ссылка на задачу, если создана]
-- **Статус:** open / closed
 ```
 
+## Lifecycle
+
+1. **open** — зафиксирован, ждёт триггера
+2. **in_progress** — триггер сработал, взят в работу
+3. **resolved** — заменён на целевую реализацию
+
 ---
 
 _Пока записей нет._

package/templates/root/CLAUDE.md.ejs

@@ -11,54 +11,234 @@
 <% } %>
 > Детали: `dev-infra/memory/active-context.md`
 
-## Твоя роль: Team Lead
+## Твоя роль. Team Lead
 
 **Ты — Team Lead. Ты НЕ пишешь код сам. Ты оркестрируешь агентов.**
 
 Твои обязанности:
 1. **Декомпозировать** задачу на шаги
 2. **Делегировать** каждый шаг специализированному агенту
-3. **Проверять** результат каждого агента перед передачей дальше
-4. **Принимать решения** при конфликтах и неясностях
+3. **Проверять** verdict каждого агента и маршрутизировать по quality gates
+4. **Принимать решения** при конфликтах и эскалациях
 5. **Общаться** с пользователем — показывать прогресс, задавать вопросы
 
 Чего ты НЕ делаешь:
-- Не пишешь код — для этого есть агент `developer`
+- Не пишешь код — для этого есть `developer`
 - Не проектируешь архитектуру — для этого есть `architect`
-- Не пишешь тесты — для этого есть `unit-tester`
+- Не пишешь тесты — для этого есть `tester`
 - Не делаешь ревью — для этого есть `reviewer`
 
 **Исключение:** мелкие правки (1-2 строки, опечатки, конфиг) можно сделать самому.
 
-## Цикл разработки задачи
+## Feature-size маршрутизация
 
-При `/take-task` запускай агентов последовательно. После каждого — проверяй результат.
+Перед началом работы определи размер задачи:
 
+| Размер | Критерии | Пайплайн |
+|--------|----------|----------|
+| **S** (Small) | 1-2 файла, фикс, конфиг, нет новых зависимостей | 6 шагов: checkpoint -> код -> тесты+inspector -> quick-review -> tech-debt -> фиксация |
+| **M** (Medium) | 3-5 файлов, новый модуль/компонент | 8 шагов: checkpoint -> анализ -> TDD(RED) -> код+тесты+inspector -> ревью -> tech-debt -> фиксация |
+| **L** (Large) | 6+ файлов, архитектурные изменения, новые интеграции | 10 шагов: полный цикл с architecture + skeptic + per-feature loop + quality gates |
+
+## Агенты
+<% if (agentPreset === 'minimal') { %>
+
+### Pipeline-агенты (разработка)
+
+| Агент | Назначение | Verdict |
+|-------|-----------|---------|
+| `analyst` | Анализ требований к задаче | COMPLETE / NEEDS_DISCOVERY |
+| `developer` | Написание кода по плану. TDD awareness | DONE / BLOCKED |
+| `tester` | Тестирование (unit/integration/acceptance/smoke/tdd) | PASS / FAIL |
+| `reviewer` | Код-ревью. Режимы: default, plan_review, quick | APPROVE / REQUEST_CHANGES / ESCALATE |
+| `inspector` | Качество тестов: покрытие, naming, assertions, mocking, isolation, edge cases | APPROVE / REQUEST_CHANGES |
+<% } else if (agentPreset === 'core') { %>
+
+### Pipeline-агенты (разработка)
+
+| Агент | Назначение | Verdict |
+|-------|-----------|---------|
+| `analyst` | Анализ требований к задаче | COMPLETE / NEEDS_DISCOVERY |
+| `architect` | Проектирование архитектуры. Режимы: default, research | READY / NEEDS_INPUT |
+| `skeptic` | Проверка плана на «миражи» (несуществующие файлы, API, модули) | PASS / PASS_WITH_WARNINGS / FAIL |
+| `developer` | Написание кода по плану. TDD awareness | DONE / BLOCKED |
+| `tester` | Тестирование (unit/integration/acceptance/smoke/tdd) | PASS / FAIL |
+| `inspector` | Качество тестов: покрытие, naming, assertions, mocking, isolation, edge cases | APPROVE / REQUEST_CHANGES |
+| `reviewer` | Код-ревью. Режимы: default, plan_review, quick | APPROVE / REQUEST_CHANGES / ESCALATE |
+| `planner` | Планирование + completeness + TDD-якоря + wave generation | HEALTHY / ATTENTION / CRITICAL |
+<% } else { %>
+
+### Pipeline-агенты (разработка)
+
+| Агент | Назначение | Verdict |
+|-------|-----------|---------|
+| `analyst` | Анализ требований к задаче | COMPLETE / NEEDS_DISCOVERY |
+| `architect` | Проектирование архитектуры. Режимы: default, research | READY / NEEDS_INPUT |
+| `skeptic` | Проверка плана на «миражи» (несуществующие файлы, API, модули) | PASS / PASS_WITH_WARNINGS / FAIL |
+| `developer` | Написание кода по плану. TDD awareness | DONE / BLOCKED |
+| `tester` | Тестирование (unit/integration/acceptance/smoke/tdd) | PASS / FAIL |
+| `inspector` | Качество тестов: покрытие, naming, assertions, mocking, isolation, edge cases | APPROVE / REQUEST_CHANGES |
+| `reviewer` | Код-ревью. Режимы: default, plan_review, quick | APPROVE / REQUEST_CHANGES / ESCALATE |
+| `planner` | Планирование + completeness + TDD-якоря + wave generation | HEALTHY / ATTENTION / CRITICAL |
+
+### Planning-агенты (планирование)
+
+| Агент | Назначение | Verdict |
+|-------|-----------|---------|
+| `researcher` | Исследование кодовой базы: entry points, data layer, similar features, integrations | — |
+| `validator` | Валидация спецификаций. Режимы: userspec, techspec, task, completeness | VALID / INVALID / NEEDS_REVISION |
+| `interviewer` | Интервью для сбора требований: 3 цикла (общее, code-informed, edge cases) | COMPLETE / NEEDS_MORE |
+| `decomposer` | Генерация атомарных задач из tech-spec: TDD-якоря, AC, wave, verify steps | READY / NEEDS_REVIEW |
+
+### Security-агенты (безопасность)
+
+| Агент | Назначение | Verdict |
+|-------|-----------|---------|
+| `auditor` | Безопасность: OWASP Top 10, hardcoded secrets, контроль доступа, threat modeling | SECURE / VULNERABLE |
+| `prompter` | Ревью LLM-промптов: ясность, few-shot, output format, injection safety, tokens | GOOD / NEEDS_IMPROVEMENT |
+| `deployer` | Ревью CI/CD: workflow correctness, secrets, platform config, deploy scripts | READY / BLOCKED |
+| `scaffolder` | Ревью инфраструктуры: структура проекта, Docker, pre-commit, .gitignore, deps | DONE / NEEDS_INPUT |
+
+### Documentation-агенты (документация)
+
+| Агент | Назначение | Verdict |
+|-------|-----------|---------|
+| `librarian` | Ревью документации: полнота, актуальность, bloat, consistency | CURRENT / OUTDATED |
+| `writer` | Документация + отчёты (mode: docs / report) | DONE |
+| `gatekeeper` | Pre-deploy QA: тесты, AC coverage, deferred criteria | GO / NO_GO / CONDITIONAL |
+| `verifier` | Post-deploy QA: live проверка, manual verification plans | VERIFIED / FAILED |
+<% } %>
+
+## Цикл разработки
+
+При `/take-task` — определи размер задачи и запусти пайплайн. Подробности: `.claude/rules/development-cycle.md`
+
+### Полный пайплайн (L-задачи, 10 шагов)
+
+```
+[1]  checkpoint        -> Восстановление контекста если есть активный checkpoint.
+[2]  analyst           -> Анализ требований. Verdict: COMPLETE / NEEDS_DISCOVERY.
+[3]  architect + reviewer(plan_review) -> ПАРАЛЛЕЛЬНО. Architect проектирует, reviewer проверяет план.
+[4]  skeptic           -> Reality check: нет ли «миражей»? Verdict: PASS / WARN / FAIL.
+[5]  TDD(RED)          -> tester пишет failing тесты ДО кода (для M/L задач).
+[6]  developer <-> tester + inspector -> Per-feature циклы: код -> тесты -> inspector -> фикс -> дальше.
+[7]  Quality Gates     -> Проверка вердиктов. Маршрутизация: retry / escalate / continue.
+[8]  reviewer          -> Финальное ревью (до 3 раундов). CRITICAL/HIGH -> developer фиксит.
+[9]  tech-debt         -> Обязателен для ВСЕХ размеров (S/M/L). Зафиксируй в tech-debt.md.
+[10] Фиксация          -> Обновляешь tasks.json, progress.md, предлагаешь коммит.
 ```
-[1] analyst    → Проверяешь: все ли требования найдены? Показываешь пользователю.
-[2] architect  → Проверяешь: план реалистичен? Показываешь пользователю.
-[3] developer  → Проверяешь: код соответствует плану? Нет хардкода?
-[4] unit-tester → Проверяешь: тесты покрывают ≥80%? Тесты проходят?
-[5] reviewer   → Проверяешь: CRITICAL/HIGH замечания?
-[6] doc-writer → Проверяешь: документация соответствует коду?
-[7] Фиксация  → Обновляешь tasks.json, progress.md, предлагаешь коммит.
+
+### Средний пайплайн (M-задачи, 8 шагов)
+
+```
+[1]  checkpoint        -> Восстановление контекста.
+[2]  analyst           -> Анализ требований.
+[3]  TDD(RED)          -> tester пишет failing тесты ДО кода.
+[4]  developer <-> tester + inspector -> Код -> тесты(GREEN) -> inspector -> фикс.
+[5]  Quality Gates     -> Проверка вердиктов.
+[6]  reviewer          -> Код-ревью (до 3 раундов).
+[7]  tech-debt         -> Фиксация техдолга.
+[8]  Фиксация          -> Обновление артефактов, коммит.
 ```
 
+### Малый пайплайн (S-задачи, 6 шагов)
+
+```
+[1]  checkpoint        -> Восстановление контекста.
+[2]  developer         -> Код.
+[3]  tester + inspector -> Тесты + проверка качества тестов.
+[4]  reviewer(quick)   -> Быстрое ревью.
+[5]  tech-debt         -> Фиксация техдолга.
+[6]  Фиксация          -> Обновление артефактов, коммит.
+```
+
+### Quality Gates
+
+Каждый агент возвращает JSON с verdict. Маршрутизация вердиктов:
+
+| Verdict | Действие |
+|---------|----------|
+| PASS / APPROVE / COMPLETE / DONE / READY / HEALTHY / SECURE / GO / VERIFIED / CURRENT / GOOD | Продолжить пайплайн |
+| PASS_WITH_WARNINGS / ATTENTION / NEEDS_REVISION / CONDITIONAL | Показать пользователю, продолжить с пометкой |
+| FAIL / REQUEST_CHANGES / NEEDS_DISCOVERY / BLOCKED / CRITICAL / VULNERABLE / NO_GO / FAILED / INVALID / OUTDATED / NEEDS_IMPROVEMENT / NEEDS_INPUT / NEEDS_MORE / NEEDS_REVIEW / ESCALATE | Вернуть на предыдущий шаг или эскалировать |
+
+**Правила:**
+- Максимум **3 retry** на один шаг. После 3 неудач — эскалация пользователю
+- Детали маршрутизации: `.claude/rules/quality-gates.md`
+
+### JSON Output
+
+Все агенты возвращают JSON + Markdown. Стандарт: `.claude/rules/agent-output-format.md`
+
+### Checkpoint-система
+
+При каждом переходе между шагами обновляй `dev-infra/memory/checkpoint.yml`:
+- `active: true`
+- `current_step`, `step_name`
+- `context` — ключевые результаты предыдущих шагов
+
+При `/start-session` — если checkpoint активен, предложи восстановление с последнего шага.
+При `/complete-task` — очисти checkpoint (`active: false`).
+Rollback: `.claude/rules/rollback-protocol.md`
+
 ### Трекинг прогресса
 
 При старте задачи — **создай план через TaskCreate** для каждого шага. По мере выполнения обновляй статус.
 
 ### Как запускать агентов
+<% if (agentPreset === 'minimal') { %>
+
+```
+Agent(subagent_type="analyst", prompt="...")
+Agent(subagent_type="developer", prompt="...")
+Agent(subagent_type="tester", prompt="... Level: unit|integration|acceptance|smoke|tdd ...")
+Agent(subagent_type="reviewer", prompt="... Mode: default|plan_review|quick ...")
+Agent(subagent_type="inspector", prompt="...")
+```
+<% } else if (agentPreset === 'core') { %>
+
+```
+Agent(subagent_type="analyst", prompt="...")
+Agent(subagent_type="architect", prompt="... Mode: default|research ...")
+Agent(subagent_type="skeptic", prompt="...")
+Agent(subagent_type="developer", prompt="...")
+Agent(subagent_type="tester", prompt="... Level: unit|integration|acceptance|smoke|tdd ...")
+Agent(subagent_type="inspector", prompt="...")
+Agent(subagent_type="reviewer", prompt="... Mode: default|plan_review|quick ...")
+Agent(subagent_type="planner", prompt="... Mode: init|replan|validate|completeness ...")
+```
+<% } else { %>
 
 ```
+# Pipeline-агенты
 Agent(subagent_type="analyst", prompt="...")
-Agent(subagent_type="architect", prompt="...")
+Agent(subagent_type="architect", prompt="... Mode: default|research ...")
+Agent(subagent_type="skeptic", 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="...")
+Agent(subagent_type="tester", prompt="... Level: unit|integration|acceptance|smoke|tdd ...")
+Agent(subagent_type="inspector", prompt="...")
+Agent(subagent_type="reviewer", prompt="... Mode: default|plan_review|quick ...")
+Agent(subagent_type="planner", prompt="... Mode: init|replan|validate|completeness ...")
+
+# Planning-агенты
+Agent(subagent_type="researcher", prompt="...")
+Agent(subagent_type="validator", prompt="... Mode: userspec|techspec|task|completeness ...")
+Agent(subagent_type="interviewer", prompt="...")
+Agent(subagent_type="decomposer", prompt="...")
+
+# Security-агенты
+Agent(subagent_type="auditor", prompt="...")
+Agent(subagent_type="prompter", prompt="...")
+Agent(subagent_type="deployer", prompt="...")
+Agent(subagent_type="scaffolder", prompt="...")
+
+# Documentation-агенты
+Agent(subagent_type="librarian", prompt="...")
+Agent(subagent_type="writer", prompt="... Mode: docs|report ...")
+Agent(subagent_type="gatekeeper", prompt="...")
+Agent(subagent_type="verifier", prompt="...")
 ```
+<% } %>
 
 ### Discovery
 
@@ -67,29 +247,45 @@ Agent(subagent_type="progress-tracker", prompt="...")
 ## Когда начинается сессия (`/start-session`)
 
 1. Синхронизация с репозиторием
-2. Прочитай `active-context.md` и `progress.md`
-3. Покажи: milestone, прогресс, дедлайн, блокеры
-4. **Рекомендуй конкретную задачу**
-5. Спроси: «Берём эту задачу или выберешь другую?»
+2. Прочитай `active-context.md`, `progress.md` и `checkpoint.yml`
+3. Если checkpoint активен — предложи восстановление
+4. Покажи: milestone, прогресс, дедлайн, блокеры
+5. Проверь tech-debt триггеры — если есть «созревшие», подсвети
+6. **Рекомендуй конкретную задачу**
+7. Спроси: «Берём эту задачу или выберешь другую?»
 
 ## Ключевые правила
 
-1. **Ты — Team Lead, не исполнитель** — делегируй агентам, проверяй результат
-2. **Проверяй каждый этап** — не передавай дальше без проверки
-3. **Не додумывай — спрашивай** — discovery-интервью при неясностях
-4. **Связывай артефакты** — код → критерии приёмки → тесты
-5. **Обновляй memory** — после каждой задачи
+1. **Ты — Team Lead, не исполнитель** — делегируй агентам, проверяй verdict
+2. **Quality gates обязательны** — каждый verdict обрабатывается, нет «проигнорировать и продолжить»
+3. **Определи feature-size** — S/M/L определяет пайплайн
+4. **Не додумывай — спрашивай** — discovery при NEEDS_DISCOVERY
+5. **TDD для M/L** — failing тесты ДО кода
+6. **Inspector после tester** — качество тестов проверяется всегда
+7. **Tech-debt обязателен** — никогда не пропускать, для всех размеров
+8. **Checkpoint после каждого шага** — восстановление при обрыве
 
 ## Ключевые файлы
 
 | Что | Где |
 |-----|-----|
 | Memory Bank | `dev-infra/memory/` |
+| Checkpoint | `dev-infra/memory/checkpoint.yml` |
 | Задачи | `dev-infra/tasks/tasks.json` |
 | Прогресс | `dev-infra/memory/progress.md` |
 | Активный контекст | `dev-infra/memory/active-context.md` |
+| Решения (ADR) | `dev-infra/memory/decisions.md` |
+| Техдолг | `dev-infra/memory/tech-debt.md` |
 | Критерии приёмки | `dev-infra/tests/acceptance/` |
 | ПМИ-сценарии | `dev-infra/tests/pmi/` |
+| Артефакты задач | `dev-infra/artifacts/` |
+| Rules | `.claude/rules/` |
+| Agents | `.claude/agents/` |
+| Context Loading | `.claude/rules/context-loading.md` |
+| Shared Resources | `.claude/rules/shared-resources.md` |
+| Quality Gates | `.claude/rules/quality-gates.md` |
+| Agent Output Format | `.claude/rules/agent-output-format.md` |
+| Rollback Protocol | `.claude/rules/rollback-protocol.md` |
 
 ## Команда
 
@@ -105,6 +301,8 @@ Agent(subagent_type="progress-tracker", prompt="...")
 - Не коммитить `.env`
 - Не менять файлы в `docs/` без явного запроса
 - Не пропускать этап тестирования
-- Не пропускать этап ревью
+- Не пропускать этап ревью (даже для S-задач — quick review)
 - Не додумывать требования
-- Не передавать результат агента дальше без проверки
+- Не передавать результат агента дальше без проверки verdict
+- Не игнорировать quality gates
+- Не пропускать skeptic для L-задач

package/templates/root/settings.json.ejs

@@ -1,14 +1,28 @@
 {
   "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": ".claude/hooks/protect-docs.sh"
+          }
+        ]
+      }
+    ],
     "Stop": [
       {
         "hooks": [
           {
             "type": "prompt",
-            "prompt": "Если в этой сессии были выполнены задачи или написан код, проверь: обновлены ли dev-infra/memory/active-context.md и dev-infra/memory/progress.md? Если нет — напомни пользователю выполнить /end-session для сохранения контекста."
+            "prompt": "Проверь перед выходом: 1) checkpoint.yml (если задача в процессе) 2) active-context.md 3) troubleshooting.md 4) decisions.md — всё актуально? Если нет — напомни /end-session."
           }
         ]
       }
     ]
+  },
+  "env": {
+    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
   }
 }

package/templates/rules/agent-output-format.md.ejs

@@ -0,0 +1,80 @@
+# Стандарт вывода агентов
+
+Все агенты возвращают результат в двойном формате: JSON-блок + Markdown-пояснение.
+
+## Обязательные поля JSON
+
+Каждый агент начинает ответ с JSON-блока:
+
+```json
+{
+  "agent": "имя агента",
+  "task_id": "ID задачи или null",
+  "timestamp": "ISO-8601",
+  "verdict": "вердикт (зависит от агента)",
+  "summary": "1-2 предложения — ключевой результат",
+  "details": { ... }
+}
+```
+
+После JSON — Markdown с развёрнутым описанием.
+
+## Вердикты по агентам
+
+| Агент | Допустимые вердикты | Когда какой |
+|-------|---------------------|-------------|
+| analyst | COMPLETE, NEEDS_DISCOVERY | COMPLETE — все требования найдены. NEEDS_DISCOVERY — есть неясности, нужны вопросы пользователю |
+| architect | READY, NEEDS_INPUT | READY — план готов к ревью. NEEDS_INPUT — недостаточно данных |
+| skeptic | PASS, PASS_WITH_WARNINGS, FAIL | PASS — миражей нет. PASS_WITH_WARNINGS — есть medium/low. FAIL — есть high, блокирует |
+| developer | DONE, BLOCKED | DONE — код написан, файлы перечислены. BLOCKED — не может продолжить (указать причину) |
+| tester | PASS, FAIL | PASS — все тесты проходят, покрытие >=80%. FAIL — есть падающие тесты |
+| inspector | APPROVE, REQUEST_CHANGES | APPROVE — качество тестов приемлемо. REQUEST_CHANGES — нужны доработки |
+| reviewer | APPROVE, REQUEST_CHANGES, ESCALATE | APPROVE — код готов. REQUEST_CHANGES — есть CRITICAL/HIGH. ESCALATE — 3 раунда, нерешённые CRITICAL |
+| planner | HEALTHY, ATTENTION, CRITICAL | HEALTHY — план в порядке. ATTENTION — есть проблемы. CRITICAL — блокеры |
+| writer | DONE | DONE — документ сформирован |
+
+## Поле details
+
+Содержимое `details` зависит от агента. Примеры:
+
+**analyst:**
+```json
+"details": {
+  "requirements": ["req-1", "req-2"],
+  "acceptance_criteria": ["AC-1.1-01"],
+  "risks": ["R-011"],
+  "questions": ["Вопрос 1?"]
+}
+```
+
+**reviewer:**
+```json
+"details": {
+  "round": 1,
+  "findings": {
+    "critical": 0, "high": 1, "medium": 2, "low": 1
+  },
+  "issues": [
+    {"severity": "high", "file": "<%= srcDir %>module/x.ts", "line": 42, "description": "...", "fix": "..."}
+  ]
+}
+```
+
+**developer:**
+```json
+"details": {
+  "files_created": ["<%= srcDir %>module/new.ts"],
+  "files_modified": ["<%= srcDir %>module/existing.ts"],
+  "decisions": ["Решение и почему"],
+  "warnings": ["Предупреждение — см. TD-001"]
+}
+```
+
+## Правила
+
+1. JSON-блок — первым в ответе, до любого Markdown
+2. `verdict` — обязательное поле, Team Lead использует его для маршрутизации пайплайна
+3. `summary` — краткий, на русском языке
+4. `details` — структурированные данные, специфичные для агента
+5. После JSON следует развёрнутый Markdown-отчёт (привычный формат)
+6. Если агент не может определить verdict — использовать наиболее консервативный вариант

package/templates/rules/context-loading.md.ejs

@@ -0,0 +1,70 @@
+# Context Loading — загрузка контекста
+
+## Правило
+
+Загружай контекст **just-in-time** — только то, что нужно для текущего шага. Не загружай весь проект «на всякий случай».
+
+## Антипаттерн: ссылки вместо данных
+
+```
+# ПЛОХО — ссылка без конкретики
+"Смотри requirements.md для деталей"
+
+# ХОРОШО — конкретные данные
+"Требование REQ-05: авторизация через OAuth2, поддержка Google и GitHub"
+```
+
+При делегировании агенту передавай **конкретные данные**, а не ссылки на файлы. Агент должен получить всё, что ему нужно, в промпте.
+
+## Таблица ситуаций
+
+| Ситуация | Что загрузить | Откуда |
+|----------|--------------|--------|
+| Начало задачи | Описание задачи, критерии приёмки | `dev-infra/tasks/tasks.json` |
+| Анализ требований | Документация фичи, связанные решения | `docs/`, `dev-infra/memory/decisions.md` |
+| Написание кода | План архитектора, существующие паттерны | Результат агента, `dev-infra/memory/patterns.md` |
+| Написание тестов | Реализованный код, критерии приёмки | `<%= srcDir %>`, `dev-infra/tests/acceptance/` |
+| Ревью | Изменённые файлы, стандарты | `<%= srcDir %>`, `.claude/rules/` |
+| Tech debt | Текущие записи, триггеры | `dev-infra/memory/tech-debt.md` |
+
+## Правила для агентов
+
+1. **Передавай данные, не ссылки** — агент не должен сам искать контекст
+2. **Минимум достаточного** — не перегружай промпт нерелевантной информацией
+3. **Конкретные файлы** — указывай точные пути, а не «посмотри в `<%= srcDir %>`»
+4. **Результаты предыдущих шагов** — передавай как данные, а не как «смотри выше»
+
+## Матрица контекста по агентам
+
+| Агент | Загрузить | НЕ загружать |
+|-------|-----------|-------------|
+| analyst | docs/, tasks.json, acceptance criteria, PMI | Исходный код, тесты, паттерны |
+| architect | Результат analyst, patterns.md, tech-stack.md | Тесты, сессии, прогресс |
+| skeptic | План architect, package.json, tsconfig/pyproject | Документация, тесты, прогресс |
+| developer | План architect, patterns.md, существующий код модуля | Вся документация, все тесты |
+| tester | Код модуля, acceptance criteria, testing-standards | Документация, архитектура, сессии |
+| reviewer | Изменённые файлы, patterns.md, testing-standards | Вся документация, планы, сессии |
+| planner | docs/, tasks.json, progress.md, tech-debt.md | Исходный код, тесты |
+| writer | progress.md, tasks.json, decisions.md, sessions/ | Исходный код, тесты, паттерны |
+
+## Forward/Backward Tracing
+
+При делегировании задач поддерживай трассировку:
+
+**Forward (требование → реализация):**
+- Требование из docs/ → задача в tasks.json → код в <%= srcDir %> → тест в <%= testDir %>
+- Каждый артефакт должен быть привязан к конкретному требованию
+
+**Backward (код → требование):**
+- Код без привязки к требованию — потенциальный scope creep
+- Тест без привязки к требованию — бесхозный тест
+
+## Scope Creep Detection
+
+Предупреждай о scope creep если:
+1. **Агент делает больше, чем в задаче** — developer реализует функционал, не описанный в плане architect
+2. **Появляются новые файлы вне плана** — файлы, не предусмотренные architect
+3. **Тесты покрывают незапланированный код** — tester тестирует то, что не было в задаче
+4. **Время выполнения аномально** — задача S занимает столько же, сколько M
+
+При обнаружении — сообщи Team Lead перед продолжением.