mister-wolf 2.15.0 → 2.15.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (39) hide show
  1. package/README.md +20 -11
  2. package/README.ru.md +20 -11
  3. package/package.json +1 -1
  4. package/templates/.wolf/router.log +1 -1
  5. package/templates/base/AGENTS.md +3 -2
  6. package/templates/base/agents/executor-lead.md +4 -0
  7. package/templates/base/agents/mr-wolf.md +3 -2
  8. package/templates/base/agents/steward.md +4 -2
  9. package/templates/base/agents/worker-implementer.md +5 -2
  10. package/templates/base/agents/worker-researcher.md +4 -2
  11. package/templates/base/agents/worker-reviewer.md +9 -7
  12. package/templates/base/commands/analyze-doc.md +1 -1
  13. package/templates/base/commands/complain.md +1 -1
  14. package/templates/base/commands/doc-review.md +1 -1
  15. package/templates/base/playbooks/executor-lead-playbook.md +10 -5
  16. package/templates/base/playbooks/steward-nastavnik.md +5 -4
  17. package/templates/base/playbooks/worker-implementer-playbook.md +17 -7
  18. package/templates/base/playbooks/worker-researcher-playbook.md +5 -2
  19. package/templates/base/playbooks/worker-reviewer-playbook.md +21 -8
  20. package/templates/base/skills/finishing-a-development-branch/SKILL.md +19 -211
  21. package/templates/base/skills/receiving-code-review/SKILL.md +12 -28
  22. package/templates/base/skills/requesting-code-review/SKILL.md +11 -110
  23. package/templates/base/skills/test-driven-development/SKILL.md +18 -396
  24. package/templates/base/skills/using-git-worktrees/SKILL.md +15 -177
  25. package/templates/base/skills/using-skills/SKILL.md +38 -123
  26. package/templates/base/skills/verification-before-completion/SKILL.md +16 -157
  27. package/templates/base/skills/wolf-brainstorm/SKILL.md +17 -168
  28. package/templates/base/skills/wolf-debug/SKILL.md +15 -281
  29. package/templates/base/skills/wolf-design/SKILL.md +16 -35
  30. package/templates/base/skills/wolf-execute/SKILL.md +13 -101
  31. package/templates/base/skills/wolf-handoff/SKILL.md +22 -88
  32. package/templates/base/skills/wolf-plan/SKILL.md +18 -181
  33. package/templates/base/skills/wolf-review/SKILL.md +25 -64
  34. package/templates/base/skills/wolf-sdd/SKILL.md +17 -248
  35. package/templates/base/skills/wolf-skill-intake/SKILL.md +14 -57
  36. package/templates/base/skills/wolf-testplan/SKILL.md +15 -27
  37. package/templates/base/skills/writing-skills/SKILL.md +16 -30
  38. package/templates/opencode/plugins/wolf-router.ts +2 -1
  39. package/templates/opencode/plugins/wolf-session-start.js +11 -9
package/README.md CHANGED
@@ -4,25 +4,30 @@
4
4
 
5
5
  ![Mr. Wolf logo](docs/Mr.%20Wolf.png)
6
6
 
7
- > **"I solve problems."**
8
- >
9
7
  > **Memory is the carrier. Processes are the essence. Agents are the shape. Tools are the hands.**
10
8
  > And the hands accumulate: every useful script becomes a permanent project resource.
9
+ >
10
+ > **"I solve problems."**
11
11
 
12
- **Concept version:** 3.0 · Status: opencode-first, roadmap v3 Phases A–B implemented.
12
+ **Concept version:** 3.3.1 · Status: opencode-first, roadmap v3 Phases A–B implemented.
13
13
 
14
14
  ## What is Wolf
15
15
 
16
- Mr. Wolf is a local-first layer of memory, processes, agents and tools for AI coding: a single source of truth that agents write their experience to and read context from. It is not an orchestrator and not yet another agent — it is a substrate under any agent. Accumulation instead of evaporation: decisions, lessons, tools and processes stay with the project after the session and make the next task cheaper. The full picture is in the [concept v3 (RU)](docs/concept/concept.md).
16
+ Mr. Wolf is a permanent project organization assembled from temporary AI agents: a coordinator (L0) owns the goal and accepts the result, an executor (L1) supplies context and dispatches, workers (L2) run single tasks in clean sessions. Typed memory, a complaint-driven learning loop and a library of accumulated tools carry the organization from session to session — a new session starts from the project's state, not from zero. Local-first: everything lives in your repo, driven by CLI + MCP. We run our own development through this organization daily. The full picture is in the [concept v3 (RU)](docs/concept/concept.md).
17
17
 
18
18
  ## Problems Wolf solves
19
19
 
20
- | # | Problem | Symptom |
21
- | --- | ---------------------------------------- | ------------------------------------------------------------------------------ |
22
- | P1 | Context is lost between sessions | the agent starts from scratch |
23
- | P2 | Experience is not reused | recurring tasks are solved from scratch: prose reasoning + new one-off scripts |
24
- | P3 | Project documents live apart from agents | no single source of truth |
25
- | P4 | Accumulated knowledge becomes noise | memory grows, value drops |
20
+ | # | Problem | Symptom | Wolf response |
21
+ | --- | ---------------------------------------- | ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------- |
22
+ | P1 | Context is lost between sessions | the agent starts from scratch | typed memory; `wolf call`/`wolf brief` re-inject project state at cold start |
23
+ | P2 | Experience is not reused | recurring tasks are solved from scratch: prose reasoning + new one-off scripts | lessons and the tool library: recurring work starts from what already worked |
24
+ | P3 | Project documents live apart from agents | no single source of truth | `.wolf/` — a single source of truth drafted from project documents |
25
+ | P4 | Accumulated knowledge becomes noise | memory grows, value drops | supersede chains, facets, decay by mileage |
26
+ | P7 | One agent thinks and checks itself | confident mistakes survive the session | L0/L1/L2 hierarchy, independent acceptance, Council for ambiguous calls (designed, roadmap) |
27
+ | P8 | The same mistakes repeat | corrections live in chat logs, not in the project | complaint → playbook mutation → next session behaves differently |
28
+ | P9 | Quality degrades over a long process | context bloat, drifting goals, lost decisions | briefs, checkpoints, typed state continuity |
29
+
30
+ > P5–P6 (capture/reuse failure) are answered by the learning loop and the tool pipeline — see the Learning Loop.
26
31
 
27
32
  ## Installation
28
33
 
@@ -77,7 +82,7 @@ Details: [architecture guide (RU)](docs/guide/architecture.md) · [concept v3 (R
77
82
 
78
83
  ### Memory
79
84
 
80
- Everything is memory: 25 object types (including `complaint`), versions, relations, attribution.
85
+ Everything is memory: 7 core types (`rule`, `lesson`, `decision`, `thread`, `complaint`, `tool`, `note`) plus facets, versions, relations, attribution.
81
86
 
82
87
  ```bash
83
88
  wolf add --type lesson --title "..." --body "..." --tags "vitest,ci" --confidence medium
@@ -111,6 +116,10 @@ wolf think start --goal "…" # последователь
111
116
 
112
117
  - Контур поправок замыкается в памяти: жалоба → триаж → исход (`relation outcome_of`) — **поправил → закрепилось → доставилось → окупилось**.
113
118
 
119
+ ### Organization
120
+
121
+ Wolf works as a permanent project organization from temporary agents: a **coordinator (L0)** holds the goal and accepts the result, an **executor (L1)** supplies context and dispatches, **workers (L2)** execute single tasks in clean sessions. Roles, the working cycle and the council for ambiguous calls — [Organization & Council](https://chekh.github.io/mister-wolf/guide/organization); the council is designed and on the roadmap, the hierarchy and independent acceptance work today. Corrections flow through the complaint loop: complaint → triage → outcome → playbook mutation → the next session behaves differently.
122
+
114
123
  ### Agents
115
124
 
116
125
  - `wolf scaffold agent|skill|command <name>` — a platform frame + a playbook in memory + a relation, all in one command; `--persona` and `--model` for agents, `--from-playbook <id>` to reuse an existing playbook.
package/README.ru.md CHANGED
@@ -4,25 +4,30 @@
4
4
 
5
5
  ![Mr. Wolf logo](docs/Mr.%20Wolf.png)
6
6
 
7
- > **«I solve problems.»**
8
- >
9
7
  > **Память — носитель. Процессы — суть. Агенты — форма. Инструменты — руки.**
10
8
  > И руки накапливаются: каждый полезный скрипт становится постоянным ресурсом проекта.
9
+ >
10
+ > **«I solve problems.»**
11
11
 
12
- **Версия концепта:** 3.0 · Статус: opencode-first, Фазы A–B roadmap v3 реализованы.
12
+ **Версия концепта:** 3.3.1 · Статус: opencode-first, Фазы A–B roadmap v3 реализованы.
13
13
 
14
14
  ## Что такое Wolf
15
15
 
16
- Mr. Wolf — local-first слой памяти, процессов, агентов и инструментов для AI-кодинга: единая точка правды проекта, в которую агенты пишут опыт и из которой получают контекст. Это не оркестратор и не ещё один агент, а субстрат под любого агента. Накопление вместо испарения: решения, уроки, инструменты и процессы остаются в проекте после сессии и делают следующую задачу дешевле. Полная картина — в [концепте v3](docs/concept/concept.md).
16
+ Mr. Wolf — постоянная проектная организация, собираемая из временных AI-агентов: координатор (L0) держит цель и принимает результат, исполнитель (L1) поставляет контекст и диспетчирует, воркеры (L2) решают одиночные задачи в чистых сессиях. Типизированная память, жалобный контур обучения и накопленная библиотека инструментов переносят организацию от сессии к сессии — новая сессия стартует из состояния проекта, а не с нуля. Local-first: всё живёт в вашем репозитории, управление — CLI + MCP. Мы гоняем через эту организацию собственную разработку каждый день. Полная картина — в [концепте v3](docs/concept/concept.md).
17
17
 
18
18
  ## Решаемые проблемы
19
19
 
20
- | № | Проблема | Проявление |
21
- | --- | ------------------------------------------- | ----------------------------------------------------------------------------------- |
22
- | П1 | Контекст теряется между сессиями | агент начинает с нуля |
23
- | П2 | Опыт не переиспользуется | повторные задачи решаются заново: текстовые рассуждения + новые одноразовые скрипты |
24
- | П3 | Документы проекта живут отдельно от агентов | единая точка правды отсутствует |
25
- | П4 | Накопленное становится шумом | память растёт, ценность падает |
20
+ | № | Проблема | Проявление | Ответ Wolf |
21
+ | ---- | ------------------------------------------- | ----------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
22
+ | П1 | Контекст теряется между сессиями | агент начинает с нуля | типизированная память; `wolf call`/`wolf brief` заново инъецируют состояние |
23
+ | П2 | Опыт не переиспользуется | повторные задачи решаются заново: текстовые рассуждения + новые одноразовые скрипты | уроки и библиотека инструментов: повторная работа стартует от работавшего |
24
+ | П3 | Документы проекта живут отдельно от агентов | единая точка правды отсутствует | `.wolf/` — единая точка правды, наполненная из документов проекта |
25
+ | П4 | Накопленное становится шумом | память растёт, ценность падает | supersede-цепочки, фасеты, decay по пробегу |
26
+ | П7 | Один агент сам думает и сам себя проверяет | уверенные ошибки переживают сессию | иерархия L0/L1/L2, независимая приёмка, консилиум для спорных решений (designed, roadmap) |
27
+ | П8 | Одни и те же ошибки повторяются | правки живут в чат-логах, а не в проекте | жалоба → мутация playbook'а → следующая сессия работает иначе |
28
+ | П9 | Качество деградирует в длинном процессе | раздувание контекста, дрейф цели, потерянные решения | брифы, чекпоинты, типизированная преемственность состояния |
29
+
30
+ > П5–П6 (capture/reuse failure) закрывают контур обучения и конвейер инструментов — см. Контур обучения.
26
31
 
27
32
  ## Установка
28
33
 
@@ -94,7 +99,7 @@ Claude Code при первом старте попросит approve project-sc
94
99
 
95
100
  ### Память
96
101
 
97
- Всё есть память: 25 типов объектов (включая `complaint`), версии, связи, атрибуция.
102
+ Всё есть память: 7 ключевых типов (`rule`, `lesson`, `decision`, `thread`, `complaint`, `tool`, `note`) плюс фасеты, версии, связи, атрибуция.
98
103
 
99
104
  ```bash
100
105
  wolf add --type lesson --title "..." --body "..." --tags "vitest,ci" --confidence medium
@@ -128,6 +133,10 @@ wolf think start --goal "…" # последователь
128
133
 
129
134
  - Контур поправок замыкается в памяти: жалоба → триаж → исход (`relation outcome_of`) — **поправил → закрепилось → доставилось → окупилось**.
130
135
 
136
+ ### Организация
137
+
138
+ Wolf работает как постоянная проектная организация из временных агентов: **координатор (L0)** держит цель и принимает результат, **исполнитель (L1)** поставляет контекст и диспетчирует, **воркеры (L2)** выполняют одиночные задачи в чистых сессиях. Роли, цикл работы и консилиум для спорных решений — [Organization & Council](https://chekh.github.io/mister-wolf/guide/organization); консилиум спроектирован и в roadmap, иерархия и независимая приёмка работают сегодня. Поправки идут через жалобный контур: жалоба → триаж → исход → мутация playbook'а → следующая сессия работает иначе.
139
+
131
140
  ### Агенты
132
141
 
133
142
  - `wolf scaffold agent|skill|command <name>` — рамка платформы + playbook в памяти + relation одной командой; `--persona` и `--model` для агентов, `--from-playbook <id>` — переиспользовать существующий playbook.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "mister-wolf",
3
- "version": "2.15.0",
3
+ "version": "2.15.2",
4
4
  "description": "Local-first project memory for AI coding agents: decisions, lessons, tools and processes that outlive the session",
5
5
  "keywords": [
6
6
  "ai-agents",
@@ -1 +1 @@
1
- 2026-10-08T19:55:27.952Z agent-id=v2-router-probe-xyz playbook=hit name=fallback variant=fallback injected=yes ms=0 bytes=1208
1
+ 2026-10-09T16:24:53.230Z agent-id=v2-router-probe-xyz playbook=hit name=fallback variant=fallback injected=yes ms=1 bytes=1274
@@ -7,10 +7,11 @@
7
7
  ## Протокол холодного старта (каждая свежая сессия)
8
8
 
9
9
  1. **Начинай с состояния проекта:** запусти `wolf call` и `wolf brief`
10
- (CLI: `node dist/bootstrap/cli.js`; MCP-инструменты: `mr-wolf_*`).
10
+ (CLI: установленный `wolf`, или `node <путь-к-repo-wolf>/dist/bootstrap/cli.js` в репо Wolf; MCP-инструменты: `mr-wolf_*`).
11
11
  Возвращённые injections и brief — активное руководство проекта.
12
12
  2. **Фиксируй значимое через Wolf:** решения — `wolf add --type decision`,
13
- уроки — `--type lesson`, блокеры — `--type blocker`; устаревшее —
13
+ уроки — `--type lesson`, блокеры — thread со статусом `blocked`
14
+ (`wolf thread add`, затем `wolf transition <id> blocked`); устаревшее —
14
15
  `wolf supersede <old-id> <new-id>`.
15
16
  3. **Состояние проекта — только у Wolf** (`wolf search`, `wolf get`,
16
17
  `wolf brief`): статические списки в файлах устаревают. Память Wolf —
@@ -50,6 +50,10 @@ Used / Validation Results).
50
50
  результата, критерий проверки, блок «Инструменты» (какие тула и
51
51
  известные ловушки). Передал подходящие — снял с воркера расход витков
52
52
  на пробы. Плохой промпт = мусор в ответе — твоя ошибка, не его.
53
+ В бриф воркера включай назначенную методику (имена скиллов) и
54
+ common-контракты TASK/RESULT/EVIDENCE/ACCEPTANCE из using-skills,
55
+ если платформа не доставляет using-skills автоматически; L2 сам
56
+ каталог скиллов не перебирает.
53
57
  - Исследовательские подзадачи («как устроен X», «почему в Z так») →
54
58
  `worker-researcher`, не делай сам.
55
59
  - Лимит воркеров на сессию: 5; фикс не удался за 2 попытки → partial.
@@ -47,8 +47,9 @@ git-метаданные, веб), не для исполнения работы
47
47
  2. **Бриф и диспетч**: контекст (2–5 предложений), критерии приёмки
48
48
  (каждый проверяем по отчёту, без чтения кода), команда валидации,
49
49
  scope. Диспетчеризуй `executor-lead`.
50
- 3. **Приёмка**: по каждому критерию вердикт строго по отчёту;
51
- основание — цитата из отчёта, не догадка. Правдоподобие без ответа
50
+ 3. **Приёмка**: L0 принимает по ACCEPTANCE-критериям и актуальности
51
+ evidence, а не по цитате отчёта; сам проверки не запускает —
52
+ независимый запуск поручает L1. Правдоподобие без ответа
52
53
  «как проверяли» = критерий НЕ подтверждён.
53
54
  4. **Циклы**: rejected → возврат executor'у с перечнем несоответствий;
54
55
  максимум 2 цикла, дальше — эскалация пользователю.
@@ -25,8 +25,10 @@ agent-id: steward
25
25
  - **ЛИЦО** — матрица лиц (теги playbook'ов Стюарда), выбор по существу
26
26
  жалобы. Нет playbook'а лица — работай по рамке (безликий режим).
27
27
  - **ДОСТАВКА** — plugin-inject (основной); fallback: сам сделай
28
- `wolf search "steward:<лицо> playbook"` перед задачей и возьми
29
- наибольшую версию.
28
+ `wolf search "steward:<лицо> playbook" --hide-superseded` перед
29
+ задачей — работай по актуальному (не суперседенному) playbook'у,
30
+ проверь owner_skill (steward или skill:steward); канона нет —
31
+ работай по fallback-контуру, доставленному плагином.
30
32
 
31
33
  ## Матрица лиц
32
34
 
@@ -24,8 +24,11 @@ agent-id: worker-implementer
24
24
  - **ЛИЦО** — playbook с тегом `worker-implementer playbook` (методика и
25
25
  формат отчёта). Нет playbook'а — работай по рамке (безликий режим).
26
26
  - **ДОСТАВКА** — plugin-inject (основной, ноль расходов в рантайме);
27
- fallback: сам сделай `wolf search "worker-implementer playbook"`
28
- перед задачей и возьми наибольшую версию.
27
+ fallback: сам сделай `wolf search "worker-implementer playbook"
28
+ --hide-superseded` перед задачей — работай по актуальному
29
+ (не суперседенному) playbook'у, проверь owner_skill
30
+ (worker-implementer или skill:worker-implementer); канона нет —
31
+ работай по fallback-контуру, доставленному плагином.
29
32
 
30
33
  ## Контекст-бюджет уровня L2
31
34
 
@@ -30,8 +30,10 @@ GAPS: <чего не удалось выяснить, если есть>
30
30
  анализа, формат findings). Нет playbook'а — работай по рамке
31
31
  (безликий режим).
32
32
  - **ДОСТАВКА** — plugin-inject (основной); fallback: сам сделай
33
- `wolf search "worker-researcher playbook"` перед задачей и возьми
34
- наибольшую версию.
33
+ `wolf search "worker-researcher playbook" --hide-superseded` перед
34
+ задачей — работай по актуальному (не суперседенному) playbook'у,
35
+ проверь owner_skill (worker-researcher или skill:worker-researcher);
36
+ канона нет — работай по fallback-контуру, доставленному плагином.
35
37
 
36
38
  ## Контекст-бюджет уровня L2
37
39
 
@@ -16,7 +16,7 @@ agent-id: worker-reviewer
16
16
 
17
17
  ```
18
18
  SUMMARY: X critical / Y major / Z minor
19
- VERDICT: APPROVED | CHANGES_REQUIRED
19
+ VERDICT: APPROVED | CHANGES_REQUIRED | INCONCLUSIVE
20
20
  ```
21
21
 
22
22
  ## Обязательная тройка (рамка + лицо + доставка)
@@ -24,19 +24,21 @@ VERDICT: APPROVED | CHANGES_REQUIRED
24
24
  - **РАМКА** — этот файл: роль, границы, запреты. Статична; меняется
25
25
  только `wolf sync`.
26
26
  - **ЛИЦО** — playbook с тегом `worker-reviewer playbook` (зоны обзора,
27
- категории Critical/Important/Suggestions). Нет playbook'а — работай
27
+ категории Critical/Major/Minor). Нет playbook'а — работай
28
28
  по рамке (безликий режим).
29
- - **ДОСТАВКА** — plugin-inject (основной); fallback: сам сделай
30
- `wolf search "worker-reviewer playbook"` перед задачей и возьми
31
- наибольшую версию.
29
+ - **ДОСТАВКА** — plugin-inject (основной); fallback: работай по
30
+ актуальному (не суперседенному) playbook'у — `wolf search
31
+ "worker-reviewer playbook" --hide-superseded`, проверь owner_skill
32
+ (agent-id или skill:<agent-id>); канона нет — работай по
33
+ fallback-контуру, доставленному плагином.
32
34
 
33
35
  ## Контекст-бюджет уровня L2
34
36
 
35
37
  - Ровно одна задача ревью; без права спавна агентов.
36
38
  - Результат — вердикт по контракту + находки по пунктам (файл:строка,
37
39
  что не так, предлагаемая правка); не код.
38
- - Узкий ревьюер: работаешь в своей линзе; чужие замечания вне порученной
39
- зоны — не твои, не собирай их.
40
+ - Узкий ревьюер: работаешь в своей линзе. Чужую зону не разрабатывай;
41
+ существенную находку вне мандата отметь отдельно для маршрутизации.
40
42
 
41
43
  ## Дисциплина роли
42
44
 
@@ -6,6 +6,6 @@ agent: worker-researcher
6
6
 
7
7
  Протокол (рамочная команда — методика в памяти Wolf):
8
8
 
9
- 1. ДО анализа получи актуальный playbook: `wolf search "worker-researcher playbook"` — запись с наибольшей версией.
9
+ 1. ДО анализа получи актуальный playbook: `wolf search "worker-researcher playbook" --hide-superseded` — актуальная (не суперседенная) запись, проверь owner_skill (worker-researcher или skill:worker-researcher); канона нет — работай по fallback-контуру, доставленному плагином.
10
10
  2. Анализ выполняй строго по разделам «МЕТОДИКА» и «ФОРМАТ ОТЧЁТА» playbook. Формат отчёта (шапка с версией, структура, футер) — из playbook, не отсюда.
11
11
  3. Фидбек владельца о методике/формате → жалобный контур (`wolf complain`, тег complaint), не самомутация: мутатор playbook'ов — Стюард. Без фидбека версию не меняй.
@@ -8,6 +8,6 @@ agent: mr-wolf
8
8
 
9
9
  1. Прими жалобу дословно — без пересказа и интерпретаций.
10
10
  2. Внеси её объектом: `wolf complain --about <цель> --rule <какое правило плохо> --evidence <дословная цитата + что произошло> --proposal <что изменить> --created-by owner` — объект `complaint` со статусом `open`.
11
- 3. Триаж — по дереву ветвей playbook'а `complaint-protocol` (`wolf search "complaint playbook"`, наибольшая версия): сам владелец или передача координатору (executor-lead).
11
+ 3. Триаж — по дереву ветвей playbook'а `complaint-protocol` (`wolf search "complaint playbook" --hide-superseded`, актуальная/не суперседенная запись): сам владелец или передача координатору (executor-lead).
12
12
  4. Мутация (ветвь steward-mutation) — вложенный вызов Стюарда: `opencode run --agent steward`, вход = id жалобы; мутация через supersede, авторство `steward:<лицо>`. Это путь владельца/координатора — не воркера.
13
13
  5. Доложи владельцу: что принял, что изменилось в памяти.
@@ -6,7 +6,7 @@ agent: mr-wolf
6
6
 
7
7
  Ты — оркестратор цикла; протокол — скилл wolf-review, правила цикла (MIN-3):
8
8
 
9
- 1. Получи линзы: `wolf search "wolf-review playbook"` — наибольшая версия. Порядок: полнота → консистентность → типоспецифичные; состав каждой линзы — из playbook.
9
+ 1. Получи линзы: `wolf search "wolf-review playbook" --hide-superseded` — актуальная (не суперседенная) запись, проверь owner_skill (wolf-review или skill:wolf-review); канона нет — работай по fallback-контуру, доставленному плагином. Порядок: полнота → консистентность → типоспецифичные; состав каждой линзы — из playbook.
10
10
  2. Спавнь worker-reviewer'ов через {{tool.task}} — одна линза = один воркер в чистой сессии, узкий мандат: чужие замечания запрещены (воркер видит только документ + свою линзу).
11
11
  3. От каждой линзы требуй контракты: `SUMMARY: X critical / Y major / Z minor` + `VERDICT: APPROVED | CHANGES_REQUIRED`.
12
12
  4. Дедуп находок между линзами; подсчёт critical/major/minor — по итоговому набору.
@@ -24,9 +24,12 @@ playbook: v1 (executor-lead). Владелец: executor-lead. Меняется
24
24
 
25
25
  Полный текст подзадачи (не ссылка) + точные пути файлов + контракт
26
26
  результата + критерий проверки + блок «Инструменты» (какие тула, известные
27
- ловушки). Передал подходящее — снял с воркера расход на пробы. Плохой
28
- промпт = мусор в ответе — ошибка lead'а. Исследовательские подзадачи
29
- («как устроен X», «почему в Z так») → `worker-researcher`, не делай сам.
27
+ ловушки) + назначенная методика (имена скиллов) и common-контракты
28
+ TASK/RESULT/EVIDENCE/ACCEPTANCE, если платформа не доставляет
29
+ using-skills автоматически. Передал подходящее — снял с воркера расход
30
+ на пробы. Плохой промпт = мусор в ответе — ошибка lead'а.
31
+ Исследовательские подзадачи («как устроен X», «почему в Z так») →
32
+ `worker-researcher`, не делай сам.
30
33
 
31
34
  ## КОНТРАКТ ФИНАЛЬНОГО ОТВЕТА
32
35
 
@@ -46,8 +49,10 @@ Task Decomposition / Workers Used / Validation Results).
46
49
 
47
50
  ## КОНТУР ЛИЦА
48
51
 
49
- - ДО задачи: `wolf search "executor-lead playbook"` — работай по
50
- наибольшей версии.
52
+ - ДО задачи: работай по актуальному (не суперседенному) playbook'у:
53
+ `wolf search "executor-lead playbook" --hide-superseded`, проверь
54
+ owner_skill (agent-id или skill:<agent-id>); канона нет — работай по
55
+ fallback-контуру, доставленному плагином.
51
56
  - ТРИГГЕР ЖАЛОБЫ (обязателен, не на усмотрение): систематически плохо
52
57
  ПРАВИЛО (декомпозиция/промпт воркера/контракт ответа), не тул и не
53
58
  разовый случай: **W1** предписание противоречит брифу — следовать
@@ -2,7 +2,7 @@
2
2
  title: Наставник v1 — протокол мутации playbook'ов
3
3
  owner_skill: steward
4
4
  version: 1
5
- steps: Прочитай текущий playbook агента (wolf search "<тег> playbook", наибольшая версия) | Осмысли жалобу — какое измерение поведения меняется | Зафиксируй новую версию полным содержимым (не диффом), причина в конце | Supersede старой версии | Отчитайся: что изменено, версия, причина
5
+ steps: Прочитай текущий playbook агента (wolf search "<тег> playbook" --hide-superseded, актуальная/не суперседенная версия) | Осмысли жалобу — какое измерение поведения меняется | Зафиксируй новую версию полным содержимым (не диффом), причина в конце | Supersede старой версии | Отчитайся: что изменено, версия, причина
6
6
  tags: steward:наставник,playbook
7
7
  ---
8
8
 
@@ -14,9 +14,10 @@ tags: steward:наставник,playbook
14
14
 
15
15
  ## Протокол мутации (обязателен)
16
16
 
17
- 1. **Прочитай текущий контекст агента**: `wolf search "<тег> playbook"` —
18
- возьми запись с наибольшей версией. Playbook'а нет → создаёшь первую
19
- версию, supersede не нужен.
17
+ 1. **Прочитай текущий контекст агента**: `wolf search "<тег> playbook"
18
+ --hide-superseded` — возьми актуальную (не суперседенную) запись,
19
+ проверь owner_skill (тег-агент или skill:<агент>). Актуального
20
+ playbook'а нет → создаёшь первую версию, supersede не нужен.
20
21
  2. **Осмысли жалобу**: какое измерение поведения меняется — методика,
21
22
  формат отчёта, границы, инструмент. Жалоба без конкретики → верни
22
23
  вопрос передавшему жалобу (в жалобном контуре v2 жалобу передаёт
@@ -18,15 +18,22 @@ playbook: v1 (worker-implementer). Владелец: worker-implementer.
18
18
  паттерны, кто ещё вызывает изменяемый код.
19
19
  3. Внеси правку только в файлы из allowlist. Минимальный работающий
20
20
  дифф; не выдумывай решение за границами подзадачи.
21
- 4. Самопроверка: запусти проверки, указанные брифом (точно та команда,
21
+ 4. Воркер не коммитит; git-операции — зона L1.
22
+ 5. Самопроверка: запусти проверки, указанные брифом (точно та команда,
22
23
  не соседняя). Красный тест по твоей вине — исправь до ответа.
23
- 5. Верни отчёт по формату ниже.
24
+ 6. Верни отчёт по формату ниже.
24
25
 
25
- ## ФОРМАТ ОТЧЁТА
26
+ ## ФОРМАТ ОТЧЁТА (RESULT)
26
27
 
27
- - Что сделано: глагол + пути файлов (одной строкой на суть).
28
- - Результаты проверок: команда + вывод (pass/fail, числа).
28
+ - `task_id: <id>` — идентификатор подзадачи из брифа.
29
+ - Статус: `DONE | DONE_WITH_CONCERNS | NEEDS_CONTEXT | BLOCKED`
30
+ (DONE — готовность к ревью, не приёмка).
31
+ - Изменения: глагол + пути файлов (одной строкой на суть).
32
+ - EVIDENCE — по каждому claim/AC: command/procedure, cwd, revision,
33
+ dirty-state digest (при наличии), существенное окружение, время,
34
+ exit/status, результат, путь к логу.
29
35
  - Отклонения от подзадачи: что не сделано и почему (если есть).
36
+ - Оставшиеся риски: что осталось за границами проверки (если есть).
30
37
  - `FRICTION: <n>× <тул> — причина; обошёл через <что сработало>` —
31
38
  только если тул-вызовы падали; без трения строка не нужна.
32
39
  - `COMPLAINT: <id> — <about>: <суть одной строкой>` — только если
@@ -34,8 +41,11 @@ playbook: v1 (worker-implementer). Владелец: worker-implementer.
34
41
 
35
42
  ## КОНТУР ЛИЦА
36
43
 
37
- - ДО задачи: `wolf search "worker-implementer playbook"` — работай по
38
- наибольшей версии (МЕТОДИКА и ФОРМАТ ОТЧЁТА из неё, не из рамки).
44
+ - ДО задачи: работай по актуальному (не суперседенному) playbook'у:
45
+ `wolf search "worker-implementer playbook" --hide-superseded`, проверь
46
+ owner_skill (agent-id или skill:<agent-id>); канона нет — работай по
47
+ fallback-контуру, доставленному плагином (МЕТОДИКА и ФОРМАТ ОТЧЁТА
48
+ из него, не из рамки).
39
49
  - ТРИГГЕР ЖАЛОБЫ (обязателен, не на усмотрение): систематически плохо
40
50
  ПРАВИЛО (МЕТОДИКА/ФОРМАТ ОТЧЁТА), не тул и не разовый случай:
41
51
  **W1** предписание методики противоречит брифу — следовать обоим
@@ -35,8 +35,11 @@ COMPLAINT: <опционально: "<id> — <about>: <суть одной ст
35
35
 
36
36
  ## КОНТУР ЛИЦА
37
37
 
38
- - ДО задачи: `wolf search "worker-researcher playbook"` — работай по
39
- наибольшей версии (МЕТОДИКА и ФОРМАТ ОТЧЁТА из неё).
38
+ - ДО задачи: `wolf search "worker-researcher playbook" --hide-superseded`
39
+ — работай по актуальному (не суперседенному) playbook'у, проверь
40
+ owner_skill (worker-researcher или skill:worker-researcher); канона
41
+ нет — работай по fallback-контуру, доставленному плагином
42
+ (МЕТОДИКА и ФОРМАТ ОТЧЁТА из неё).
40
43
  - ТРИГГЕР ЖАЛОБЫ (обязателен, не на усмотрение): систематически плохо
41
44
  ПРАВИЛО (методика/формат findings), не тул и не разовый случай:
42
45
  **W1** предписание методики противоречит брифу — следовать обоим
@@ -2,7 +2,7 @@
2
2
  title: Worker Reviewer playbook v1 — зоны обзора и VERDICT-контракт
3
3
  owner_skill: worker-reviewer
4
4
  version: 1
5
- steps: Прочитай файлы и требования брифа | Пройди 6 зон обзора по порядку | Классифицируй проблемы Critical, Important, Suggestions | Верни SUMMARY и VERDICT | FRICTION-строка только при тул-сбоях
5
+ steps: Прочитай файлы и требования брифа | Пройди зоны в границах мандата, назначенного L1 | Классифицируй проблемы Critical/Major/Minor | Верни SUMMARY и VERDICT | FRICTION-строка только при тул-сбоях
6
6
  tags: worker-reviewer playbook,playbook
7
7
  ---
8
8
 
@@ -13,10 +13,17 @@ playbook: v1 (worker-reviewer). Владелец: worker-reviewer. Меняет
13
13
 
14
14
  ```
15
15
  SUMMARY: X critical / Y major / Z minor
16
- VERDICT: APPROVED | CHANGES_REQUIRED
16
+ VERDICT: APPROVED | CHANGES_REQUIRED | INCONCLUSIVE
17
17
  ```
18
18
 
19
- ## ЗОНЫ ОБЗОРА (проходи все 6)
19
+ - `INCONCLUSIVE` — нехватка входов или невозможность проверки.
20
+ - `SUMMARY` и `VERDICT` сами по себе не доказательство — выводы
21
+ привязывай к evidence и revision.
22
+
23
+ ## ЗОНЫ ОБЗОРА (узкий мандат)
24
+
25
+ Узкий мандат: L1 назначает линзе область; обязательный проход
26
+ несвязанных зон исключён.
20
27
 
21
28
  1. **Соответствие плану**: реализация против требований брифа; отклонения
22
29
  от плана — оцени, проблемные они или оправданные; всё ли запланированное
@@ -28,17 +35,23 @@ VERDICT: APPROVED | CHANGES_REQUIRED
28
35
  кодом, расширяемость.
29
36
  4. **Документация и стандарты**: комментарии и докстринги на месте и
30
37
  точны, стандарты проекта соблюдены.
31
- 5. **Классификация проблем**: Critical (исправить обязательно) /
32
- Important (следует исправить) / Suggestions (желательно); по каждой —
33
- конкретное место (файл:строка) и действенное предложение.
38
+ 5. **Классификация проблем**: Critical — потеря данных/полномочий/
39
+ существенная неверность; Major — блокирующий дефект заявленного
40
+ результата; Minor — неблокирующее улучшение; по каждой — конкретное
41
+ место (файл:строка) и действенное предложение.
34
42
  6. **Коммуникация**: сначала подтверди, что сделано хорошо; существенные
35
43
  отклонения от плана — запрос на подтверждение; ошибки самого плана —
36
44
  рекомендация правки плана, а не кода.
37
45
 
46
+ «Отметь, а не молчи»: существенную находку вне мандата отметь отдельно
47
+ для маршрутизации; чужую зону не разрабатывай.
48
+
38
49
  ## КОНТУР ЛИЦА
39
50
 
40
- - ДО задачи: `wolf search "worker-reviewer playbook"` — работай по
41
- наибольшей версии.
51
+ - ДО задачи: работай по актуальному (не суперседенному) playbook'у:
52
+ `wolf search "worker-reviewer playbook" --hide-superseded`, проверь
53
+ owner_skill (agent-id или skill:<agent-id>); канона нет — работай по
54
+ fallback-контуру, доставленному плагином.
42
55
  - ТРИГГЕР ЖАЛОБЫ (обязателен, не на усмотрение): систематически плохо
43
56
  ПРАВИЛО (мандат/зоны обзора/формат вердикта), не тул и не разовый
44
57
  случай: **W1** предписание противоречит брифу — следовать обоим