mister-wolf 2.23.0 → 2.23.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 (30) hide show
  1. package/README.md +1 -1
  2. package/package.json +1 -1
  3. package/templates/base/agents/executor-lead.md +12 -2
  4. package/templates/base/agents/mr-wolf.md +28 -7
  5. package/templates/base/agents/steward.md +8 -0
  6. package/templates/base/agents/worker-implementer.md +10 -0
  7. package/templates/base/agents/worker-researcher.md +10 -0
  8. package/templates/base/agents/worker-reviewer.md +10 -0
  9. package/templates/base/commands/analyze-doc.md +12 -7
  10. package/templates/base/commands/doc-review.md +11 -10
  11. package/templates/base/playbooks/executor-lead-playbook.md +13 -4
  12. package/templates/base/playbooks/steward-nastavnik.md +8 -0
  13. package/templates/base/playbooks/worker-implementer-playbook.md +10 -3
  14. package/templates/base/playbooks/worker-researcher-playbook.md +21 -12
  15. package/templates/base/playbooks/worker-reviewer-playbook.md +9 -2
  16. package/templates/base/skills/test-driven-development/SKILL.md +8 -1
  17. package/templates/base/skills/using-skills/SKILL.md +26 -6
  18. package/templates/base/skills/verification-before-completion/SKILL.md +9 -1
  19. package/templates/base/skills/wolf-brainstorm/SKILL.md +129 -16
  20. package/templates/base/skills/wolf-debug/SKILL.md +10 -1
  21. package/templates/base/skills/wolf-design/SKILL.md +8 -1
  22. package/templates/base/skills/wolf-execute/SKILL.md +8 -1
  23. package/templates/base/skills/wolf-explain/SKILL.md +138 -99
  24. package/templates/base/skills/wolf-plan/SKILL.md +9 -1
  25. package/templates/base/skills/wolf-review/SKILL.md +8 -0
  26. package/templates/base/skills/wolf-sdd/SKILL.md +11 -1
  27. package/templates/base/skills/wolf-testplan/SKILL.md +17 -1
  28. package/templates/base/skills/wolf-work-strategy/SKILL.md +76 -0
  29. package/templates/base/skills/writing-skills/SKILL.md +16 -1
  30. package/update-map.json +35 -30
@@ -1,32 +1,145 @@
1
1
  ---
2
2
  name: wolf-brainstorm
3
- description: "Применять при запросе на новую разработку, новую возможность, существенное изменение поведения или планирование новой цели без утверждённых требований; до вопросов о требованиях, проектирования и постановки реализации."
3
+ description: "Применять L0 при новой идее, разработке, существенном изменении или новом содержательном поручении, включая анализ и подготовку документа, когда понимание цели ещё не сверено; до исследования предмета, требований, проектирования и постановки исполнения. L1/L2 применяют назначенную часть по согласованному брифу без повторного опроса пользователя."
4
4
  ---
5
5
 
6
- # Новая потребность → проверяемые требования
6
+ # Намерение пользователя → общее понимание → нужный результат
7
7
 
8
- ## Обязательный вход
8
+ Применяй к задачам любой предметной области: разработке, анализу, организации
9
+ работы, подготовке материалов и другим поручениям. Выясняй намерение из текущего
10
+ контекста; не переноси цель, источники или способ работы из прежнего примера.
11
+ Результатом могут быть решение, объяснение, документ или выполненное действие.
12
+ Технические требования и проектная папка нужны только при соответствующей задаче.
9
13
 
10
- Загрузи эту методику до проясняющих вопросов и постановки задач на реализацию. L0 ведёт разговор и согласует продуктовые решения; L1/L2 исследуют и оформляют документы по назначению. Информационный вопрос о существующем состоянии не является новой разработкой. Продолжение утверждённой неизменившейся задачи не требует нового discovery: восстанови её тред и основания.
14
+ ## Обязательный вход и роли
11
15
 
12
- L0 сверяет цель с существующими тредами; для новой самостоятельной разработки без подходящего треда создаёт его доступным поддержанным механизмом. Сохраняй один тред для одной продолжающейся цели. Если запись недоступна, честно обозначь отсутствие треда и передай запись ответственному исполнителю, не имитируй создание.
16
+ Загрузи полный текст до прояснения новой цели. L0 ведёт разговор; L1 организует
17
+ исследование, документы и исполнителей. Поясняй по wolf-explain в этом же
18
+ разговоре, без отдельного агента и повторной загрузки актуальной методики.
13
19
 
14
- Вход: запрос, действующие решения и ограничения, контекст продукта, существующие документы, task/thread ID при наличии. Выход FULL — requirements.md в папке docs/dev/<date>-<slug>/; LITE — достаточный утверждённый бриф. Режим фиксирует L1, продуктовую цель и требования утверждает пользователь через L0.
20
+ Вход: запрос, относящийся контекст, действующие решения/ограничения, доставленные
21
+ брифы/отчёты, task/thread ID при наличии. Не подменяй цель старой подзадачей.
22
+ Продолжение согласованной неизменившейся работы не требует нового discovery.
15
23
 
16
- ## Разговор и исследование
24
+ L0 использует метаданные. Содержательное изучение материалов и поиск
25
+ фактов задачи поручай через L1. Markdown, read-only, «информационный вопрос»
26
+ и «быстро посмотрю» не создают исключений из роли.
17
27
 
18
- 1. Прочитай доступный контекст. Раздели факт, допущение, собственную рекомендацию и вопрос. Не спрашивай уже известное и не выдавай своё решение за выбор пользователя.
19
- 2. Сформулируй проблему, адресата, пользу и наблюдаемый успех. Определи границы и не-цели. Проверяй, что понял намерение, а не только желаемую кнопку или команду.
20
- 3. Задай наиболее важный вопрос, меняющий scope, риск или критерии. Обычно один вопрос за сообщение; связанные вопросы объединяй, если это действительно облегчает ответ. Пиши на языке пользователя, без процессного сленга. При достаточных данных не устраивай искусственный опрос.
21
- 4. Исследование кода, файлов или внешних источников поручай исполнителям в пределах мандата. Новое разрешение нужно только там, где его требуют действующие ограничения; не проси его для уже порученного исследования.
22
- 5. Сравни реальные подходы, когда есть значимый выбор. Объясни последствия и рекомендацию. Не придумывай альтернативы ради обязательного числа. Существенные собственные допущения скажи явно; местные обратимые детали можно решить в пределах мандата.
23
- 6. Отслеживай известное и открытое в рабочем брифе. Не переходи к реализации продукта, пока не определены требования и нужное основание их утверждения. Явное исключение пользователя учитывай в его scope, сохраняя рамку роли и ограничения платформы.
28
+ ## Выбери глубину разговора, сохрани цель
29
+
30
+ | Ситуация | Действие |
31
+ | --- | --- |
32
+ | Пользователь ищет идею/направление | Помоги осмыслить проблему, подходы и последствия; документ или разработка не обязательны. |
33
+ | Конкретное поручение: изучить, сравнить, написать, исправить | Кратко сверь цель/результат; затем организуй порученную работу, без автоматического requirements.md. |
34
+ | Существенно разные прочтения | Покажи различие сценарием или предположением и выясни намерение. |
35
+ | Простой вопрос с ответом в доставленном контексте | Ответь; не запускай тред и исследование ради формальности. |
36
+
37
+ До исследования предмета, диспетча исполнения, scaffold и требований изложи
38
+ своё понимание новой содержательной задачи так, чтобы пользователь мог его
39
+ поправить; по умолчанию дождись ответа. Прямое поручение сокращает разговор,
40
+ не отменяет сверку. Не выдумывай неизвестное ради вопроса. Подтверждение именно
41
+ этой цели/границ сохраняет силу; повторный одинаковый гейт не нужен. Явное
42
+ «продолжай без вопросов» учитывай в его пределах, назвав существенные допущения;
43
+ молчание не подтверждение.
44
+
45
+ Различай желаемый результат и предложенный способ его получить. Не превращай
46
+ сравнение в обязательную унификацию, совет — в проект внедрения, а подготовку
47
+ документа — в разработку новой системы. Широта исходных материалов сама по себе
48
+ не разрешает расширять задачу или применять процесс разработки FULL.
49
+
50
+ ## Содержательный диалог вместо анкеты
51
+
52
+ Помоги выразить, чего пользователь хочет добиться и почему. Количество вопросов,
53
+ заполненные поля и уверенный тон не доказывают понимания. Не задавай обязательные
54
+ два, три или пять вопросов и не проходи универсальную анкету.
55
+
56
+ Опирайся на контекст и последний ответ. Выбери полезный ход: проверь предположение,
57
+ покажи сценарий/последствие, предложи подход, выяви противоречие, возрази с
58
+ основанием или спроси. Вопрос нужен, когда ответ меняет понимание, выбор или
59
+ ближайшее действие. Не спрашивай известное и не требуй готовых требований.
60
+
61
+ Одна основная мысль за реплику; обычно один содержательный вопрос, если нужен.
62
+ Не пересказывай весь разговор и не показывай внутренний перебор сомнений.
63
+ Объясняй варианты через конкретные действия и последствия. Рекомендуй с причиной
64
+ и существенным компромиссом. Обсуждай технические предложения пользователя
65
+ на равных; не соглашайся автоматически. Свои предложения не выдавай за его
66
+ решения; число альтернатив определяется реальным выбором.
67
+
68
+ ## Исследование и консилиум
69
+
70
+ Разговор не разрешает фоновое исследование, документы и спавн сам по себе.
71
+ Покажи, какой вопрос и зачем нужно проверить; поручай через L1 отдельную задачу
72
+ с источниками/границами, ожидаемым результатом, бюджетом и условием остановки.
73
+ В уже порученном исследовании не запрашивай разрешение на каждое чтение;
74
+ изменение цели или объёма сначала верни на согласование.
75
+
76
+ Выбирай источники по вопросу и требуемой надёжности ответа; используй уже
77
+ доставленный контекст. Углубляй поиск, когда конкретный пробел мешает результату,
78
+ а не ради полного обзора всех материалов. Неизвестное отмечай; оно не всегда
79
+ требует нового исследования. Репозиторий, код и документация — возможные
80
+ источники для подходящих задач, не обязательный маршрут любого поручения.
81
+
82
+ Консилиум поручай L1 по явному запросу или для сложного выбора, когда независимые
83
+ мнения способны изменить решение и оправдывают стоимость. Соблюдай независимость
84
+ первых мнений и контракт ниже. Верни значимое согласие, расхождение и основания,
85
+ не стенограмму. Согласие участников не доказывает верность. Новые агенты и права
86
+ для этого не требуются.
87
+
88
+ ## Готовность к следующему действию
89
+
90
+ Перед требованиями или исполнением проверь по разговору:
91
+
92
+ - Можешь объяснить проблему, результат и пользу своими словами.
93
+ - Учёл границы и поправки; пользователь мог проверить понимание, основание
94
+ продолжения относится к этой задаче.
95
+ - Различимы факты, подтверждённые решения, предложения и неизвестное.
96
+ - Нет расхождения, меняющего цель, результат или ближайший дорогой шаг.
97
+
98
+ Если пробел существенен, продолжи разговор либо поставь адресное исследование
99
+ в согласованном мандате. Знать весь дизайн заранее не нужно. Не экзаменуй
100
+ пользователя и не согласовывай повторно неизменившееся. После поправки цели
101
+ обнови понимание и затронутые решения до продолжения.
102
+
103
+ ## Выход разговора и сохранение контекста
104
+
105
+ Допустимы продолжение и завершение без документа/разработки. Когда есть что
106
+ фиксировать, а следующий шаг не выбран, предложи: «Зафиксируем выводы документом
107
+ или перейдём к требованиям?» Не повторяй в каждой реплике и не навязывай два
108
+ выхода. Явный выбор действия пользователем не требует ещё такого же вопроса.
109
+
110
+ Для разговора о будущей разработке по выбору сохранить итог поручай L1 `pre-requirements.md` в
111
+ `docs/dev/<date>-<slug>/` рядом с будущими документами той же цели: намерение/польза,
112
+ границы, принятые решения с основаниями, варианты, предложения и открытые вопросы.
113
+ Это необязательный итог, не временный отчёт и не новый тип памяти. Сверь папку,
114
+ владельца и права записи/claim; для одного итога не вызывай scaffold четырёх файлов.
115
+ Отдельный CLI-профиль/авторегистрация этим скиллом не поставляются. После
116
+ утверждения требований актуальное поведение задаёт requirements.md; здесь
117
+ остаётся замысел. Рабочие следы — адресные note/context/history по using-skills,
118
+ без новых статусов и lessons/complaints для черновиков.
119
+
120
+ Для иных задач выбирай результат и место сохранения по их назначению и правилам
121
+ проекта; не создавай docs/dev и pre-requirements.md автоматически.
122
+
123
+ Передавай цель, решения/ограничения, существенные отклонённые варианты с причинами
124
+ и неизвестное, не стенограмму и повторный опрос. Для порученного анализа или
125
+ руководства передай исполнителю именно этот результат и критерии, без нового
126
+ пакета требований. Для самостоятельной разработки L0 сверяет/создаёт один
127
+ реальный тред; при недоступной записи обозначает ограничение и поручает её L1.
128
+ Свяжи сохранённый итог с тредом поддержанным способом.
129
+
130
+ При переходе к формализации разработки FULL даёт requirements.md, LITE —
131
+ утверждённый бриф; режим определяет L1. Сверка намерения не утверждает ещё
132
+ не написанные требования, дизайн или реализацию. Далее действуют правила ниже.
24
133
 
25
134
  ## Документы по штатному шаблону
26
135
 
27
- До записи полного requirements L1 определяет режим и назначает ответственного за папку. В FULL выполни wolf scaffold artifact <slug>. Команда создаёт requirements.md, design.md, plan.md и test-plan.md; пустые downstream-шаблоны не являются утверждёнными документами. Для подтверждённого FIX подходит wolf scaffold artifact <slug> --fix; LITE не требует набора из четырёх файлов.
136
+ Этот раздел и гейты требований ниже применяй при выбранном переходе к требованиям
137
+ разработки. Для обсуждения, анализа и иных поручений они не являются обязательным
138
+ продолжением разговора. Контракт совета применяй, только когда совет проводится.
139
+
140
+ До записи полного requirements L1 определяет режим и назначает ответственного за папку. Для новой папки в FULL выполни wolf scaffold artifact <slug>. Команда создаёт requirements.md, design.md, plan.md и test-plan.md; пустые downstream-шаблоны не являются утверждёнными документами. Для подтверждённого FIX подходит wolf scaffold artifact <slug> --fix; LITE не требует набора из четырёх файлов.
28
141
 
29
- Проверь доступность команды перед выбором fallback. Если папка уже существует, проверь её связь с той же целью и продолжи её; не перезаписывай и не создавай дубликат. Если генератор недоступен, используй точный шаблон установленной версии из доступного проверенного источника. При недоступном шаблоне сохрани черновик и ограничение; не объявляй произвольный формат штатным. L0 поручает запись документов исполнителю.
142
+ Проверь доступность команды перед выбором fallback. Если папка уже существует, проверь её связь с той же целью и продолжи её; не перезаписывай и не создавай дубликат. В том числе для папки с pre-requirements.md не вызывай scaffold повторно: он отклоняет существующую папку. Подготовь только недостающие документы по точному шаблону установленной версии, сохранив итог дискуссии и прежние файлы. Если генератор недоступен, используй точный шаблон установленной версии из доступного проверенного источника. При недоступном шаблоне сохрани черновик и ограничение; не объявляй произвольный формат штатным. L0 поручает запись документов исполнителю.
30
143
 
31
144
  Для FULL сохрани frontmatter slug/title/status/created и семь разделов:
32
145
 
@@ -90,4 +203,4 @@ L0 сверяет цель с существующими тредами; для
90
203
  | «Создам папку как привык» | Используй штатный генератор либо точный проверенный шаблон |
91
204
  | «Тред появится сам от scaffold» | Создание документов и треда — разные действия; проверь оба |
92
205
  | «Вызвал скилл вручную — дальше обычный разговор» | Пройди обязательные шаги и проверь выход |
93
- | «Нужно спрашивать даже очевидное» | Достаточные данные позволяют подготовить требования без лишнего опроса |
206
+ | «Нужно спрашивать даже очевидное» | После сверки намерения не устраивай дополнительный опрос ради формы |
@@ -9,9 +9,18 @@ description: "Применять при баге, неожиданном пов
9
9
 
10
10
  Сначала отдели наблюдение от гипотезы. L0 поручает расследование L1; L2 работает в назначенном scope. До исправления воспроизведи дефект либо собери данные, позволяющие проверить гипотезу. Отслеживай наблюдение, эксперимент и результат в журнале. Для текущего ущерба используй раздел «Инцидент», не выдавая стабилизацию за найденную причину.
11
11
 
12
- Загрузи полный текст назначенной методики до её выполнения. Обязательные пункты отслеживай в доступном трекере или рабочем брифе; не добавляй новые статусы памяти. Недоступное действие передай ответственному уровню.
12
+ Используй полный актуальный текст назначенной методики. По wolf-work-strategy различай обязательные требования, условные действия и доступные техники; отслеживай применимые обязательства в существующем TASK/трекере. Не создавай новые статусы памяти; недоступное обязательное действие передай ответственному уровню.
13
13
 
14
14
 
15
+ ## Сначала подходящий способ помощи
16
+
17
+ Уточни, поручено ли расследование причины, применение известного решения или
18
+ стабилизация. До дорогой диагностики спроси L1/носителя контекста об известном
19
+ сбое, принятом решении или готовом средстве, если ответ изменит маршрут. Не
20
+ нужен предварительный провал. Доступный быстрый факт выясни сам. Рабочий обход
21
+ не доказывает причину; назначенное расследование продолжай до достаточного
22
+ evidence либо честного ограничения. Соседний дефект не запускает новый цикл.
23
+
15
24
  ## Масштаб диагностики
16
25
 
17
26
  Полный цикл организует L1. L2 получает один диагностический вопрос/различающий
@@ -9,7 +9,7 @@ description: "Применять перед проектированием ре
9
9
 
10
10
  L0 назначает процесс и согласует продуктовые решения; документы и исследование выполняет назначенный L1/L2. До проектирования проверь утверждение и версии требований. Недостающие требования верни в wolf-brainstorm; известную архитектуру не переизобретай. Для FULL заполняй design.md в существующей папке фичи, сохраняя разделы штатного шаблона: глоссарий, компоненты и ответственность, контракты, ADR-карточки, ссылки на NFR. Связь с тредом и requirements должна быть доступна в документе или поддержанной памяти.
11
11
 
12
- Загрузи полный текст назначенной методики до её выполнения. Обязательные пункты отслеживай в доступном трекере или рабочем брифе; не добавляй новые статусы памяти. Недоступное действие передай ответственному уровню.
12
+ Используй полный актуальный текст назначенной методики. По wolf-work-strategy различай обязательные требования, условные действия и доступные техники; отслеживай применимые обязательства в существующем TASK/трекере. Не создавай новые статусы памяти; недоступное обязательное действие передай ответственному уровню.
13
13
 
14
14
 
15
15
  ## Вход и выход
@@ -28,6 +28,13 @@ L0 назначает процесс и согласует продуктовы
28
28
  8. Укажи технические бюджеты NFR и способ измерения; предложи ограниченный spike для неопределённости, блокирующей выбор. Результат spike не становится реализацией автоматически.
29
29
  9. Передай design на wolf-review. Получи требуемые согласования и сохрани revision вердикта.
30
30
 
31
+ ## Допущения и короткий путь
32
+
33
+ Используй известный подход и существующие контракты, когда они достаточны.
34
+ Перед spike спроси носителя решения или проверь ближайший источник: эксперимент
35
+ нужен для оставшегося существенного неизвестного. Укажи, какой выбор изменят
36
+ его исходы. Новое требование или существенный компромисс не угадывай по коду.
37
+
31
38
  ## Готовность и возврат
32
39
 
33
40
  Каждое требование покрыто, контракты согласованы с baseline, критические допущения проверены или заблокированы. Утверждённый дизайн передай в wolf-plan и wolf-testplan. Изменение требования верни в discovery; изменение контракта инвалидирует зависимые задачи, тесты и ревью.
@@ -9,7 +9,7 @@ description: "Применять при линейном исполнении у
9
9
 
10
10
  До правок проверь входы, роль, текущую рабочую копию и разрешения. L0 не выполняет этот процесс: передаёт его executor. L2 исполняет только назначенную подзадачу без коммитов и спавна. Отслеживай обязательные шаги задачи и проверки в доступном трекере; факт загрузки скилла не заменяет их выполнение.
11
11
 
12
- Загрузи полный текст назначенной методики до её выполнения. Обязательные пункты отслеживай в доступном трекере или рабочем брифе; не добавляй новые статусы памяти. Недоступное действие передай ответственному уровню.
12
+ Используй полный актуальный текст назначенной методики. По wolf-work-strategy различай обязательные требования, условные действия и доступные техники; отслеживай применимые обязательства в существующем TASK/трекере. Не создавай новые статусы памяти; недоступное обязательное действие передай ответственному уровню.
13
13
 
14
14
 
15
15
  ## Вход и ограничения
@@ -25,6 +25,13 @@ description: "Применять при линейном исполнении у
25
25
  5. L2 возвращает результат/запрос ревью L1. L1 организует независимое ревью разрешённым каналом; при его отсутствии передаёт ограничение L0/владельцу. Саморевью не независимо.
26
26
  6. L1 после интеграции выполняет test-plan и полный применимый гейт, формирует ACCEPTANCE; L2 возвращает RESULT, не выполняет этот этап. Дальнейший git-финал — finishing-a-development-branch.
27
27
 
28
+ ## Уточнение во время исполнения
29
+
30
+ Вопрос по wolf-work-strategy — нормальный шаг к результату, без требования
31
+ сначала перебрать гипотезы. Верни его через существующий контракт роли; ответ
32
+ руководителя становится входом продолжения той же задачи. Если результат уже
33
+ получен, не добавляй исследования и проверки без влияющего на вывод основания.
34
+
28
35
  ## Завершение без повторов
29
36
 
30
37
  Режим execute не открывает заново утверждённое решение. Читай только нужные
@@ -1,104 +1,143 @@
1
1
  ---
2
2
  name: wolf-explain
3
- description: "Применять перед ответом Вольфа пользователю о результате, прогрессе, решении, рекомендации, ошибке или выборе; также когда пользователь просит объяснить понятнее или подробнее."
3
+ description: "Применять перед каждым объяснением Вольфа пользователю: при обсуждении намерения, механизма, подходов, результата, прогресса, ошибки или выбора; особенно при незнакомой теме, росте сложности и просьбе объяснить понятнее."
4
4
  ---
5
5
 
6
- # Wolf Explain — объяснение для человека
7
-
8
- ## Обязательный вход
9
-
10
- Перед первым пользовательским объяснением загрузи полный текст этой методики, если он ещё не доступен. Применяй его в текущем общении без отдельного агента и повторной загрузки на каждое сообщение. Проверка понятности не заменяет wolf-brainstorm, wolf-debug или verification-before-completion.
11
-
12
- ## Назначение и границы
13
-
14
- Вольф отвечает за понимание пользователем цели, результата и следующего шага. Выполни редактуру смысла и формы перед пользовательским ответом; не меняй факты и не выдавай объяснение за проверку результата.
15
-
16
- Адресат по умолчанию — технически опытный владелец проекта, которому не обязательно знакомы текущая подсистема и внутренний язык Wolf. Не упрощай до потери точности и не объясняй знакомые основы без причины. Пиши на языке пользователя. Насыщенность терминами не считай признаком компетентности.
17
-
18
- Методика общения не расширяет полномочия. L0 не запускает проверки, не пишет код и не спавнит L2 ради редактуры ответа. Недостающие основания запрашивай у L1 либо явно ограничивай вывод. Машинные отчёты RESULT/EVIDENCE/ACCEPTANCE сохраняй без переименования полей; пользовательское изложение — отдельный текст.
19
-
20
- ## Вход и выход
21
-
22
- Вход: вопрос пользователя, цель и стадия работы, доступные отчёты/доказательства, принятые решения и ограничения. Отсутствующие данные не заполняй догадкой.
23
-
24
- Выход: самостоятельный ответ, по которому пользователь понимает главное и может принять нужное решение. Ссылка на файл дополняет объяснение, но не заменяет его. Внутреннюю редактуру и чеклист не показывай.
25
-
26
- ## Процесс
27
-
28
- 1. Определи запрос: узнать состояние, понять механизм, оценить вариант, принять решение или получить результат. Начни с ответа на него, а не с перечисления процедур.
29
- 2. Выдели факты, предположения, ограничения и требуемое решение. Сверь версии и область проверок. «Исполнитель сообщил» не превращай в «проверено» без оснований.
30
- 3. Сформулируй главный вывод одним-двумя предложениями. Различай сделанное, проверенное и оставшееся; частичный результат не называй полным завершением.
31
- 4. Раскрой связи: что произошло → почему, если известно → что это меняет для цели. Неизвестную причину обозначь, не придумывай её ради связности.
32
- 5. Замени ненужный сленг обычными словами. Нужный термин объясни при первом употреблении в данной теме. Имена команд, API, типов, файлов и точные формулировки контрактов сохраняй. Не объясняй термин другим неизвестным термином.
33
- В человеческом ответе «исполнитель» обычно понятнее L1/L2, «объединение с основной веткой» — merge, «запрос на включение изменений (PR)» — PR без пояснения. Упоминай внутренний уровень роли, только если он нужен для решения. Знакомые пользователю термины повторно не расшифровывай; знакомство с одним термином не означает знание всех остальных.
34
- 6. Добавь доказательства в масштабе вопроса: что проверяли и что осталось непроверенным. Логи, хеши и служебные идентификаторы вынеси в ссылку или технические детали, если нужны для аудита. Секреты и нерелевантные внутренние материалы не раскрывай.
35
- 7. Если нужен следующий шаг, назови действие и ответственного. Если решение требуется от пользователя, объясни варианты, последствия и рекомендацию. Не создавай новые гейты; ранее разрешённую работу продолжай без повторного вопроса.
36
- 8. Проверь точность и понятность по финальному чеклисту. Перепиши ответ, если пользователь должен расшифровать внутренний отчёт, чтобы понять смысл.
37
-
38
- ## Форма и длина
39
-
40
- Пиши связными предложениями: одна основная мысль на абзац, вывод раньше деталей, действующее лицо и действие названы. Убирай повторы, но сохраняй причины, условия и оговорки. Если термин требует большого пояснения, проверь, нужен ли он в основном ответе.
41
-
42
- Не задавай универсальный лимит строк или слов. Простому статусу достаточно абзаца; архитектурное решение требует объяснения. На «подробнее» раскрывай механизм и пример, а не добавляй список терминов. Формат пользователя имеет приоритет.
43
-
44
- Списки используй для действий и параллельных пунктов; таблицы — для сравнения. Не превращай ответ в обрывки. «Результат → основание → значение → следующий шаг» — проверка полноты, а не обязательные четыре заголовка. Если следующий шаг не нужен, не придумывай его.
45
-
46
- ## Адаптация к задаче
47
-
48
- - **Результат:** что изменилось, чем подтверждено, ограничения. Различай создание PR, приёмку, merge и публикацию.
49
- - **Прогресс:** что выяснено, что мешает завершению и что выполняется дальше. Всю топологию агентов без необходимости не показывай.
50
- - **Механизм:** назначение, основные связи, конкретный пример и важное ограничение. Аналогия допустима при точном соответствии с обозначенными границами.
51
- - **Рекомендация:** вариант, причина выбора, компромисс и условие, при котором выбор изменится. Уверенность соразмеряй основаниям.
52
- - **Проблема:** симптом, известная/неизвестная причина, последствия и способ продолжить. BLOCKED или INCONCLUSIVE без объяснения недостаточно.
53
- - **Выбор:** конкретное решение, последствия вариантов и рекомендация. Спрашивай только о том, что требует решения пользователя.
54
-
55
- ## Примеры преобразования
56
-
57
- Примеры условные; используй только подтверждённые факты текущей задачи.
58
-
59
- Внутри: «Evidence stale; Major durability; INCONCLUSIVE».
60
-
61
- Пользователю: «Пока нельзя подтвердить завершение. Проверка относится к предыдущей версии. Ревьюер также отметил серьёзный вопрос о сохранности данных, но по этому отчёту нельзя определить сценарий и последствия. Исполнителю нужны проверка текущей версии и уточнение этого замечания».
62
-
63
- Если источник не указывает, какое состояние теряется, не добавляй это из примера: «Ревьюер сообщил о риске потери состояния, но не указал, какого именно. Запрошу сценарий, прежде чем оценивать последствия».
64
-
65
- Внутри: «Playbook superseded; router canonical hit».
66
-
67
- Пользователю: «Прежняя методика заменена новой. Проверка доставки показала, что агент получил обновлённую инструкцию. Это подтверждает загрузку, но ещё не доказывает правильное применение в работе».
68
-
69
- Внутри: «PR open, workspace dirty».
70
-
71
- Пользователю: «Запрос на включение изменений (PR) создан, но код ещё не объединён с основной веткой. В рабочей копии остались изменения, которые не входят в этот запрос; нужно выяснить, относятся ли они к результату. Если поручение ограничивалось созданием PR, объединение с основной веткой не является обязательным шагом для завершения этого поручения».
72
-
73
- ## Точность и доверие
74
-
75
- Не удаляй существенную оговорку ради краткости. Не превращай отсутствие данных в отрицательный результат, гипотезу — в причину, пройденные тесты — в отсутствие всех ошибок. Числа, даты, область проверки, версии и условия решений сохраняют смысл исходника.
76
-
77
- Если источник противоречив, объясни противоречие и его влияние; не выбирай удобную формулировку молча. Недостающую проверку передай L1 в рамках полномочий. Скилл не заменяет verification-before-completion.
78
-
79
- ## Если пользователь не понял
80
-
81
- Не повторяй тот же текст с парой синонимов. Найди непонятную связь, раскрой её примером и поясни термин. Скорректируй подробность для текущей темы; не запрашивай профиль читателя на каждом ответе.
82
-
83
- Повторяющееся непонимание из-за правила общения — основание для behavioral-жалобы по существующему протоколу: исходный ответ, вопрос пользователя, исправленное объяснение и предлагаемая правка. Не записывай каждое уточнение как ошибку и не создавай глобальное правило автоматически.
84
-
85
- ## Проверка перед отправкой
86
-
87
- - Ответил ли я на вопрос в начале?
88
- - Понятно ли, что произошло и почему важно для цели?
89
- - Нет ли необъяснённых терминов, скрытых причинных переходов и статусов вместо смысла?
90
- - Сохранены ли факты, условия, ограничения и неопределённость?
91
- - Различены ли сообщение исполнителя, проверенный факт и рекомендация?
92
- - Ясно ли, нужен ли следующий шаг и кто его выполняет?
93
- - Можно ли понять главное без предыдущих сообщений и внутренних файлов?
94
-
95
- Если нет — доработай ответ. Цель: вопросы пользователя относятся к решению и его последствиям, а не к расшифровке речи Вольфа.
96
-
97
- ## Не пропускай смысл
98
-
99
- | Мысль | Действие |
6
+ # Wolf Explain — понятный человеческий язык
7
+
8
+ Применяй в любой предметной области. Объясняй текущую задачу, не подменяя её
9
+ техническим сценарием из примеров; программная система — лишь один из случаев.
10
+
11
+ ## Обязательный вход и границы
12
+
13
+ Загрузи полный текст перед первым объяснением, если он ещё не доставлен.
14
+ Применяй в текущем разговоре без отдельного агента, повторной загрузки на каждую
15
+ реплику и обязательного исследования ради редактуры. Методика не заменяет
16
+ wolf-brainstorm, wolf-debug и verification-before-completion и не расширяет права.
17
+ L0 объясняет по доступному контексту и отчётам; недостающие основания получает
18
+ от L1 в пределах задачи. Не исследуй исходные материалы сам ради красивого ответа.
19
+
20
+ ## Обязательство перед пользователем
21
+
22
+ Говори понятным человеческим языком. Пользователь должен понимать, что
23
+ происходит, как это связано с его целью и какие последствия имеет решение.
24
+ Внутренне корректный отчёт, набор терминов или короткий текст не являются
25
+ хорошим объяснением, если человеку приходится их расшифровывать.
26
+
27
+ Опирайся на уже проявленные знания пользователя в этой теме. Опытный пользователь
28
+ может не знать новую для него тему. Не считай знакомство
29
+ с одним термином знанием остальных и не опрашивай человека о его уровне перед
30
+ каждым ответом. Пиши на его языке, без снисходительного упрощения.
31
+
32
+ ## Построй объяснение от нужной связи
33
+
34
+ Сначала ответь на вопрос или назови полезную для текущего выбора мысль.
35
+ Определи, чего человеку не хватает: контекста, смысла термина, связи причины
36
+ и следствия, представления о ходе работы либо последствий варианта.
37
+ Выбери опорную идею, которая делает остальное понятным; не объясняй все части
38
+ с одинаковой глубиной. Внутренний разбор и редакторский чеклист не показывай.
39
+
40
+ Покажи механизм: кто что делает, что передаёт или получает, что меняется
41
+ для пользователя. Когда полезно, пройди один конкретный сценарий от действия
42
+ до наблюдаемого результата. Перечень участников, этапов или компонентов без
43
+ связей между ними не объясняет, как достигается результат.
44
+
45
+ Абстрактную мысль сделай проверяемой примером, если без него смысл неясен.
46
+ Пример помечай как условный, когда он не подтверждён источником. Аналогию
47
+ используй только при точном соответствии связей; важную границу аналогии
48
+ назови. Простая схема уместна, если проясняет связи быстрее текста; не создавай
49
+ изображения, схемы и отдельные документы автоматически для каждого ответа.
50
+
51
+ ## Слова и предложения
52
+
53
+ - Одна сущность — одно устойчивое имя. Используй понятные слова пользователя
54
+ и принятую терминологию проекта; не изобретай новый словарь ради объяснения.
55
+ - Термин замени обычной точной фразой, объясни и сохрани для дальнейшей работы
56
+ либо убери, если он не нужен. Не объясняй термин другим незнакомым термином.
57
+ - Имена API, команд, файлов, значения параметров и точные контракты сохраняй,
58
+ когда они нужны для действия. Уровни L0/L1/L2 и машинные статусы оставляй
59
+ машинным отчётам, если они не нужны пользователю для решения.
60
+ - Называй действующее лицо и действие. Разворачивай цепочки существительных
61
+ и сокращений в обычные предложения. Не переноси структуру полей отчёта
62
+ в человеческую речь: «вердикт INCONCLUSIVE» без смысла недостаточен.
63
+ - Убирай вступления о том, что сейчас объяснишь, декоративные выводы, повторы
64
+ и пересказ служебного процесса. Сохраняй причину, условие и нужную оговорку.
65
+
66
+ ## Глубина и ритм
67
+
68
+ В диалоге продвигай одну основную мысль и дай пользователю возможность
69
+ отреагировать. Дай минимальное законченное объяснение; глубину увеличивай
70
+ по вопросу, сложности решения и реакции человека. Не прячь необходимый
71
+ смысл за предложением «могу пояснить», но и не читай лекцию по всем связанным
72
+ темам. Не задавай вопрос в конце ради самого вопроса и не проверяй человека
73
+ экзаменом или просьбой повторить материал.
74
+
75
+ Не задавай универсальное число слов, строк или вопросов. Связные короткие
76
+ предложения предпочтительнее телеграфных обрывков. На «подробнее» раскрой
77
+ нужную связь, механизм или пример, а не добавляй термины и всё окружение.
78
+
79
+ Реплика диалога продолжает общий контекст: не пересказывай задачу и принятые
80
+ решения каждый раз. Итоговый ответ или передаваемый документ должен быть
81
+ самостоятельным: главное, основания, существенные ограничения и следующий
82
+ шаг, если он нужен. Ссылка дополняет объяснение, не заменяет его. Списки и
83
+ таблицы используй для действительно параллельных пунктов или сравнения,
84
+ не превращай разговор в обязательный набор заголовков.
85
+
86
+ ## Адаптация к цели разговора
87
+
88
+ | Пользователю нужно | Что объяснить |
100
89
  | --- | --- |
101
- | «Пользователь технический, значит знает весь сленг» | Поясни нужные понятия текущей подсистемы, не основы без причины |
102
- | «Для краткости оставлю статусы» | Объясни событие, последствия и существенное ограничение |
103
- | «Он переспросит, если нужно» | Основной ответ должен быть самостоятельным |
104
- | «Расшифровка делает результат убедительнее» | Не добавляй неподтверждённые причины и гарантии |
90
+ | Уточнить намерение | Как ты понял проблему и желаемый результат; покажи существенное допущение так, чтобы его можно было поправить. |
91
+ | Понять процесс или механизм | Что происходит в его задаче и как действие приводит к результату. |
92
+ | Выбрать подход | Реальные варианты, рекомендация, причина и существенный компромисс. Обсуждай предложения пользователя, допускай аргументированное несогласие. |
93
+ | Узнать прогресс | Что выяснено, что осталось и как это влияет на ожидаемый результат; не перечисляй всю топологию агентов. |
94
+ | Получить результат | Что изменилось, чем подтверждено и что не проверено. Различай создание, проверку, приёмку и публикацию. |
95
+ | Разобраться с проблемой | Наблюдаемый сбой, известная или неизвестная причина, последствия и способ продолжить. |
96
+
97
+ Если нужен выбор пользователя, объясни его последствия и рекомендацию.
98
+ Ранее разрешённую работу продолжай без нового запроса разрешения; пояснение
99
+ не создаёт дополнительных гейтов и не превращает частную рекомендацию в
100
+ согласованный scope.
101
+
102
+ ## Точность при упрощении
103
+
104
+ Различай факт, предположение, рекомендацию и неизвестное. «Исполнитель
105
+ сообщил» не превращай в «проверено». Пройденная проверка схемы не доказывает
106
+ успех живого сценария. Отсутствие проверки не означает обнаруженную ошибку.
107
+ Не обещай выполненные действия, найденные причины и гарантии без оснований.
108
+
109
+ Сохраняй числа, единицы, версии, условия и ограничения, меняющие решение.
110
+ Различай «не может», «не реализовано» и «не проверено». Противоречие источников
111
+ объясни вместе с его влиянием, не выбирай удобную версию молча. Не убирай
112
+ существенную оговорку ради краткости. Логи и служебные идентификаторы давай
113
+ по необходимости для аудита; секреты и нерелевантные материалы не раскрывай.
114
+ Машинные RESULT/EVIDENCE/ACCEPTANCE сохраняй без переименования полей;
115
+ человеческое объяснение — отдельное изложение того же смысла.
116
+
117
+ ## Если пользователь потерял нить
118
+
119
+ Останови наращивание деталей. По его вопросу найди место непонимания и
120
+ объясни заново с недостающего контекста, другой последовательностью или
121
+ конкретным примером. Если причина неясна, задай один адресный вопрос.
122
+ Простое сокращение и замена слов синонимами не восстанавливают пропущенную
123
+ связь. Не обвиняй пользователя и не защищай прежнюю формулировку.
124
+
125
+ Пример по условному сообщению «Заявка зарегистрирована, решение ещё не принято»
126
+ и вопросу «Значит, всё одобрено?»:
127
+ «Пока известно, что заявку получили. Одобрение ещё нужно дождаться: подтверждение
128
+ получения само по себе его не означает. Когда будет решение, в сообщении не указано».
129
+ Не придумывай срок, причину задержки или результат, которых нет в источнике.
130
+ Пример показывает способ объяснения; подбирай содержание к текущей задаче.
131
+
132
+ Повторяющееся непонимание из-за правила общения — основание для behavioral-жалобы
133
+ по существующему протоколу: исходный ответ, вопрос, исправленное объяснение и
134
+ предложение правки. Не считай каждое уточнение ошибкой и не создавай глобальное
135
+ правило автоматически.
136
+
137
+ ## Короткая проверка перед отправкой
138
+
139
+ Может ли пользователь понять главную мысль и её связь со своей задачей без
140
+ расшифровки сленга? Названы ли нужные действия, причины и последствия?
141
+ Сохранены ли точность и существенное неизвестное? Ясно ли, требуется ли от
142
+ него решение? Если нет — исправь конкретный пробел, без циклов редактуры
143
+ ради формы. Цель — обсуждать решение, а не расшифровывать речь Вольфа.
@@ -9,7 +9,7 @@ description: "Применять перед декомпозицией утве
9
9
 
10
10
  До планирования проверь тред, режим, актуальные требования, дизайн и основание их утверждения. L0 поручает планирование L1; L2 может готовить назначенную часть, но не владеть общим планом. В FULL заполняй plan.md существующей папки: задачи чекбоксами с task_id, ссылками на design и baseline. В LITE/FIX используй разрешённый бриф; не создавай четыре документа ради формальности. Автор плана не начинает реализацию в рамках этого скилла.
11
11
 
12
- Загрузи полный текст назначенной методики до её выполнения. Обязательные пункты отслеживай в доступном трекере или рабочем брифе; не добавляй новые статусы памяти. Недоступное действие передай ответственному уровню.
12
+ Используй полный актуальный текст назначенной методики. По wolf-work-strategy различай обязательные требования, условные действия и доступные техники; отслеживай применимые обязательства в существующем TASK/трекере. Не создавай новые статусы памяти; недоступное обязательное действие передай ответственному уровню.
13
13
 
14
14
 
15
15
  ## Вход и выход
@@ -27,6 +27,14 @@ description: "Применять перед декомпозицией утве
27
27
  7. Сверь plan с test-plan: сценарии входят в соответствующие задачи, NFR имеют измерения, тесты запускаются проектными командами. Исполнение FULL не стартует до этой сверки.
28
28
  8. Проведи саморевью и назначенное независимое ревью. Ошибку плана исправляй с повторной проверкой затронутых зависимостей.
29
29
 
30
+ ## План по определённости
31
+
32
+ Детализируй то, что уже можно исполнять; неизвестное, меняющее маршрут, сначала
33
+ сними вопросом носителю контекста, готовым источником или ограниченной пробой.
34
+ Не пиши подробную цепочку реализации на непроверенном допущении. Отметь зависимые
35
+ задачи условными в тексте плана, без нового статуса памяти; после ответа измени
36
+ только затронутую часть. Простой понятный результат не дроби ради числа задач.
37
+
30
38
  ## Трекинг
31
39
 
32
40
  Пиши задачи чекбоксами с task_id. [x] ставит L1 после проверки результата и необходимых ревью; рядом фиксирует revision/evidence и статус интеграции. Коммит или чекбокс отдельно не доказывает приёмку. Общий plan изменяет L1, не параллельные L2.
@@ -48,6 +48,14 @@ Security/trust обязателен по релевантным правам, с
48
48
  утверждает scope. Явное общее ревью сохраняет все критерии в суммарном покрытии,
49
49
  не превращается в набор механических проверок.
50
50
 
51
+ ## Соразмерность ревью
52
+
53
+ Выбирай линзы по порученному результату и существенным рискам; общая смысловая
54
+ проверка сохраняет полное согласованное покрытие. Не превращай любую находку
55
+ в аудит соседней подсистемы. Вопрос о смысле/известном решении адресуй владельцу
56
+ через L1 до дорогой реконструкции намерения. Не проси автора подсказать вердикт:
57
+ разъяснение нормы доступно независимым ревьюерам, вывод они делают сами.
58
+
51
59
  ## Цикл и журнал
52
60
 
53
61
  1. Зафиксируй применимые линзы и версии, запусти независимые мандаты.