mister-wolf 2.23.3 → 2.25.0

package/templates/base/skills/using-skills/references/context-and-memory.md

@@ -0,0 +1,77 @@
+# Адресный контекст и рабочая память
+
+Загружает владелец состояния при handoff, восстановлении или сохранении значимого результата.
+
+## Контекст по ответственности
+
+L0 хранит весь контекст цели/критериев и принимает; L1 руководит ограниченной
+поставкой, решениями, параллельными ready-задачами и интеграцией; L2 быстро
+исполняет один конечный мандат и возвращается. Ответственность не передаётся
+вниз вместе со сложностью; сложную работу L1 разрезает до назначений L2. TASK связывает цель владельца одной
+строкой, вклад подзадачи и результат. Методики организации/приёмки L0/L1 не
+назначай L2 по умолчанию. Воркер получает полную методику своего действия,
+относящиеся нормы/исключения, TASK/RESULT/EVIDENCE и нужные инструменты;
+ACCEPTANCE и весь контекст проекта оставь ответственному уровню. Автоматически
+доставленный полный текст повторно не копируй. Обязательную норму не сжимай
+до утраты смысла; дай точный источник и возможность дочитать зависимость.
+
+Отдельное исследование требует вопроса, связи с критерием/решением/риском
+и условия остановки. Не ищи «что ещё улучшить» вне поручения. L2 передаёт
+неожиданную сложность/вопрос о полномочиях L1, не выбирает дальнейший поиск.
+Сначала решение L1/контекст/готовое средство, затем при необходимости один
+адресный эксперт. Консилиум — лишь сложное существенно блокирующее решение,
+когда меньшего средства недостаточно и польза оправдывает цену. Дефект правила
+W1–W4 идёт через триаж Стюарду. Совет/мутация не меняют цель и права.
+
+
+## Рабочая память между агентами и сессиями
+
+Короткий RESULT L2 — сообщение. Сохраняй в Wolf только состояние/результат,
+нужные следующему агенту, контрольной точке или приёмке; не каждый шаг/вывод тула.
+Владелец записи L0/L1, один на задачу. L2 без прав записи передаёт ему содержимое.
+Память — основной маршрут обмена; рабочий файл вне docs — fallback при её
+недоступности либо для patch/бинарных данных. Записи создаются штатными командами,
+не ручными файлами в .wolf; скрипт хранится как файл/tool, не как простыня note.
+
+- note + context: текущий мандат, исследуемый вопрос, гипотеза, входы и следующий шаг.
+- note + history: RESULT, checkpoint, сводка проверок/ревью и принятый handoff.
+- note + metric: измерения, когда они действительно нужны для сравнения.
+- thread: многошаговая цель; blocked/waiting_answer — реальная зависимость/вопрос
+  треда, не обязательный статус из-за возврата любого L2.
+- decision: фактически выбранный уполномоченным уровнем вариант. Частный выбор
+  команды/гипотеза остаются в рабочей note, не создают проектного решения.
+- lesson: доказанный переносимый урок с границами применимости и триггером.
+- complaint: доказанный дефект правила W1–W4 с about/rule/evidence/proposal.
+  Не используй lesson/complaint для обычного статуса, бага или трения инструмента.
+
+Для рабочих note явно сохраняй memory_class=working, truth_role=proposed_knowledge,
+lifetime=short_term, review_state=proposed, status=active. Для строго одноразового
+контекста допустим lifetime=session. review_state здесь не поручение Стюарду:
+это рабочая запись, а не предложенный урок/правило. history-note с accepted может
+попасть в общий brief; не делай частный результат принятой общей памятью.
+Эти поля не обеспечивают TTL, приватность или гарантированное скрытие из поиска.
+Не используй facet=proposal без настоящего структурированного предложения.
+
+В теле: task/thread ID, владелец, цель/границы, revision, что сделано/неизвестно,
+evidence, вопрос/следующий шаг. tags — для адресного поиска. Свяжи note с реальным
+thread через related_to; передай получателю точные ID и краткий релевантный фрагмент,
+не весь brief/архив. Не добавляй несуществующие поля task_id/expires_at/thread к note
+через --set. Учитывай scope ворктрии; прямое get/brief не является изоляцией доступа.
+Пример поддержанного пути (ID/тело — реальные, не буквальные плейсхолдеры):
+
+```bash
+wolf add --type note --facet history --title "TASK: контрольная точка" \
+  --body "task/thread, revision, результат, evidence, остаток" \
+  --tags "working-state" --created-by agent:executor-lead \
+  --set memory_class=working --set truth_role=proposed_knowledge \
+  --set lifetime=short_term --set review_state=proposed --set status=active
+wolf relation add <note-id> related_to <thread-id>
+```
+
+После подтверждённой передачи/завершения L1 архивирует только свои/закреплённые
+ненужные рабочие note текущей задачи, не чужое состояние или требуемый аудит,
+сохраняя ссылки и требуемый приёмочный след; lifetime сам ничего не удаляет.
+Смысловая замена checkpoint — новая note + supersede, не дубли копий для каждого
+исполнителя. Урок/жалоба выделяются отдельно только при наличии их оснований;
+новая карточка ссылается на исходное evidence, исходная note не переименовывается
+в lesson/complaint. Стюард не превращает рабочий архив в очередь агрегации.

package/templates/base/skills/using-skills/references/contracts.md

@@ -0,0 +1,93 @@
+# Поручение и доказательства
+
+Загружает L1 перед составлением TASK; L2 получает применимые нормы в поручении.
+
+execution в TASK задаёт model/variant/mode и бюджет существующим способом
+запуска, не новой конфигурационной схемой. Иерархия ролей не шкала reasoning.
+Рутинное исполнение — execute, узкий нерешённый вопрос — solve; solve не расширяет мандат. Используй достаточный
+доступный режим; не повышай его сам и не считай просьбу в тексте подтверждением
+фактической настройки. У каждого вызова конечный лимит; без него — возврат
+не позднее 8 инструментальных обращений (дефолт пилота). Два шага без продвижения
+для L2 означают возврат L1, смену способа выбирает L1. Новый вывод, контрпример и обнаруженная ошибка
+прежней проверки — основания пересмотра, даже если исходные данные те же.
+
+Плотность density standard|draft — отдельная ось того же блока execution,
+отличная от execute|solve, FULL/LITE/FIX, роли, model и variant: выбирает
+L1 или пользователь, отсутствие поля — standard, не новая конфигурационная схема.
+В draft исполнитель сокращает видимую служебную запись — повторные пересказы,
+дублирующие сводки, действия без конкретного основания, — сохраняя основания
+решений; существенная неопределённость расширяет адресное исследование/проверку
+или даёт запрос L1, а не короткий необоснованный ответ. Обязательные проверки,
+права, независимость приёмки и безопасность не отменяются; FULL/LITE/FIX и
+execute/solve не зависят от плотности. RESULT фиксирует фактическую плотность;
+приёмка сверяет наблюдаемые действия, evidence и результат, а не ярлык draft.
+
+Инструментальный сбой не автоматически продуктовый баг и не запускает полный
+wolf-debug: один осмысленный обход в scope, затем FRICTION/ограничение и L1.
+Повторный запуск чтения/проверки обосновывается изменёнными входами, новым
+свидетельством или конкретным обязательным непокрытым критерием.
+
+
+## Контракты передачи
+
+### Ядро TASK
+
+Ядро обязательно для любого поручения; каждый пункт — проверяемое предписание,
+а не перечисление через запятую. Профиль (ниже) добавляет к ядру, не заменяет его.
+
+- `task_id` — идентификатор подзадачи, отличный от id сеанса; по нему сверяются отчёт
+  и evidence.
+- Цель/ожидаемый результат — что должно быть на выходе, одной проверяемой формулировкой.
+- AC — приёмочные критерии, по каждому из которых можно сказать «подтверждено» или нет.
+- Scope и полномочия — что входит в работу, что запрещено (запись, спавн, коммиты),
+  где вести рабочие материалы.
+- Входы и назначенная методика — какие нормы и файлы читать и каким процессом
+  исполнять; недостающий обязательный вход запрашивается, не додумывается.
+- Проверка — точные команды или процедуры и ожидаемый результат; запускает исполнитель.
+- Конечный бюджет и stop/return — лимит работы и условия немедленного возврата L1.
+- Ожидаемый RESULT — форма отчёта по роли, включая допустимые статусы и вердикты.
+
+Инварианты ядра: применимое ядерное поле нельзя опустить; неизвестный обязательный
+вход явно запрашивается (`NEEDS_CONTEXT`), не заполняется заглушкой. Опускание
+неприменимого профильного поля — не дефект поручения.
+
+### Профили поручения
+
+Профиль `implement | review | research` добавляет поля к ядру. Неприменимое поле
+опускается, а не заполняется заглушкой; поручение без такого поля корректно.
+
+- `implement` добавляет: repo/workspace, `base_sha`, allowlist записи, разрешённые
+  области чтения, зависимости, ссылки на design/test-plan. Из ядра не опускает ничего.
+  RESULT: `DONE | DONE_WITH_CONCERNS | NEEDS_CONTEXT | BLOCKED`.
+- `review` добавляет: revision проверяемого артефакта, назначенную линзу, норму
+  и evidence-набор. Не требует `base_sha`, allowlist записи, worktree.
+  RESULT: `SUMMARY/VERDICT/FINDINGS/SCOPE/LIMITS/EVIDENCE`; вердикты
+  `APPROVED | CHANGES_REQUIRED | INCONCLUSIVE`.
+- `research` добавляет: проверяемый вопрос, критерий ответа, revision документа или
+  источника, границы поиска и условие остановки. Не требует `base_sha`, allowlist записи.
+  RESULT: `FINDINGS/CONFIDENCE/GAPS` с разделением источника, факта, вывода и гипотезы.
+
+Формат передачи по умолчанию — сообщение; точные разрешённые выходные файлы, если они
+нужны, и место временной работы вне документации указывает L1. Ответственность
+за общий план и покрытие остаётся у L1.
+
+### Словарь контрактов
+
+Термины определены статически; определения не описывают поведение механизмов
+и не ссылаются на команды или поля, которых нет. Ниже таблицы — действующие формы
+`RESULT`/`EVIDENCE`/`ACCEPTANCE`: они подробны, таблица даёт только смысл термина.
+
+| Термин | Значение |
+| --- | --- |
+| TASK | Поручение исполнителю: ядро из восьми элементов плюс поля применимого профиля. |
+| RESULT | Отчёт исполнителя по форме своей роли: статус или вердикт, изменения, границы. |
+| EVIDENCE | Подтверждение claim/AC: команда или процедура, cwd, revision, exit, результат. |
+| ACCEPTANCE | Сверка каждого AC с evidence и итоговый verdict приёмки у L0. |
+| SCOPE | Границы задачи: что входит и что запрещено. В отчёте worker-reviewer `SCOPE` — покрытие ревью, не границы задачи. |
+| LIMITS/GAPS | Что не проверено, где нет данных или остался риск; отсутствие данных не равно нулю или успеху. |
+
+RESULT: task_id, DONE | DONE_WITH_CONCERNS | NEEDS_CONTEXT | BLOCKED, изменения, проверки и evidence, отклонения, оставшиеся риски. DONE означает готовность к ревью, а не приёмку.
+EVIDENCE: claim/AC, command или процедура, cwd, revision, dirty-state digest при наличии, существенное окружение, время, exit/status, результат и ссылка на имеющееся подтверждение (лог, вывод инструмента, CI-артефакт). Отдельный файл лога не обязателен. Не выдумывай отсутствующие поля.
+ACCEPTANCE: по каждому AC подтверждение/не подтверждено, актуальные evidence, независимое ревью, ограничения; финальный verdict L0: ACCEPTED | PARTIAL | REJECTED | INCONCLUSIVE.
+
+Контракты веди сообщениями и адресными note Wolf; файловый fallback — по правилам рабочей памяти выше. Не добавляй команды или типы Wolf без отдельной реализации. Следы жалоб и вердиктов сохраняй разрешённым каналом; при недоступной записи передай L1.

package/templates/base/skills/using-skills/references/project-rules.md

@@ -0,0 +1,48 @@
+# Документы и устройство работы проекта
+
+Загружает L0/L1 при выборе места, режима и документного профиля.
+
+## Состав документации этапа
+
+В FULL папка docs/dev/<date>-<feat>/ содержит основные requirements.md, design.md,
+plan.md и test-plan.md. Это документация для следующих этапов, не рабочий каталог.
+Выводы подзадач L1 встраивает в нужный документ: решения — в ADR design.md,
+состояние/проверки — в plan.md/test-plan.md; значимую память ведёт штатным каналом.
+L2 по умолчанию возвращает RESULT/findings/review сообщением. Право создать файл
+должно содержать точный путь и назначение; разрешения на каталог недостаточно.
+Явное задание обновить основной документ допустимо в назначенном разделе.
+Опциональный итог разговора по wolf-brainstorm — pre-requirements.md в папке той же
+цели: он не входит в эти четыре документа, не запускает scaffold и не означает
+утверждённые требования.
+
+Дополнения — единичные самостоятельные документы с пользой после этапа, например
+необходимый migration-guide или итоговое исследование. L1 до создания указывает
+в существующем plan/брифе путь, читателя/назначение, причину отдельного документа
+и владельца актуальности. Сначала проверь, достаточно ли существующего раздела.
+Новый файл не требуется на каждый TASK/раунд. Ресурс документа, например схема,
+допустим при явной необходимости и точном пути в TASK. Согласованные состав и форматы
+сохраняй; меняющий scope вопрос передай L0. Отдельный реестр файлов не создавай.
+
+Частные report-*, decisions-*, checkpoint, черновики, логи и исполняемые скрипты
+в docs/dev не размещай, в том числе в подпапке tmp/reports. Рабочие файлы — только
+в назначенной разрешённой области вне документации; временные эксперименты — tmp.
+Постоянные скрипты/тесты — в штатных scripts/tests или библиотеке средств по
+профилю проекта. До очистки/передачи сохрани нужные evidence и незавершённое
+состояние в доступном долговечном месте вне документации. Одна ссылка на tmp
+не является сохранённым evidence. Не удаляй чужие/прежние файлы автоматически.
+
+
+## Новая цель и рабочий тред
+
+При запросе на реальную разработку или изменение продукта L0 сверяет существующие треды и цель. Продолжение той же цели сохраняет тред. Для новой самостоятельной цели без подходящего треда создай его поддержанным механизмом памяти, например wolf thread add с title и goal; запомни фактический ID. Не создавай тред на каждое уточнение, приветствие или вопрос о текущем состоянии.
+
+Передай L1 ID треда, цель, известные ограничения и назначенную методику. L1 фиксирует FULL/LITE/FIX до выбора документного профиля. До согласованного перехода к формализации не создавай requirements.md и downstream-шаблоны. По выбору пользователя допустим отдельный итог pre-requirements.md в папке той же цели по wolf-brainstorm; он не запускает scaffold и не означает утверждение требований.
+
+В FULL исполнитель использует wolf scaffold artifact <slug>; сохраняет четыре шаблонных файла в docs/dev/<date>-<slug>/. FIX — профиль --fix, когда он подходит задаче; LITE — достаточный бриф. Ссылки на документы и принятые решения связывай с тредом существующим поддержанным способом, не придумывай поля схемы. Если инструменты памяти недоступны, обозначь ограничение и передай запись исполнителю; разговор можно продолжить, нельзя утверждать, что тред создан.
+
+
+## Масштаб и профиль проекта
+
+FULL — несколько компонентов, новые контракты, миграции или существенные риски. LITE — локальное обратимое изменение без новых контрактов. FIX — подтверждённый дефект с воспроизведением и проверкой. Режим фиксирует L1. Соблюдай протокол ошибки масштаба: если в LITE/FIX обнаружились новые контракты, второй компонент или неочевидная причина — останови затронутое исполнение и передай L1 для пересмотра; режим меняет только L1. Сам не расширяй scope. Одобренную работу повторно не согласовывай без изменения существенных условий.
+
+Из AGENTS.md, конфигурации, lockfile и CI определи base branch, package manager, setup, targeted/full checks, worktree policy и права на commit/push/merge. Не предполагай npm, Vitest или main. При конфликте проверь фактический CI и запроси только недостающее решение. Не создавай новую конфигурационную схему автоматически.

package/templates/base/skills/using-skills/references/project-tools.md

@@ -0,0 +1,49 @@
+# Средства проекта и карточки Wolf
+
+Загружает L1 при создании/сохранении/обновлении инструмента; L2 получает
+относящиеся нормы и точный контракт, а не весь каталог.
+
+## Размещение и регистрация
+
+Используй принятый постоянный каталог вспомогательных средств проекта.
+Если его нет, L1 выбирает и создаёт подходящее место; при существенной
+неоднозначности L0 уточняет у пользователя. Путь фиксируется в памяти и не
+согласуется заново. Каталог отделим от функциональности продукта; зависимости
+обслуживающих процедур явны. Компоненты продукта остаются в его структуре.
+
+Средство может включать один/несколько файлов, ресурсы и зависимости на удобном
+проекту языке. Исходники живут в Git проекта. Карточка Wolf — назначение,
+когда применять, относительная точка входа, запуск/cwd, вход/выход, среда,
+побочные действия и основание проверки. wolf tool register хранит ссылку,
+не вторую копию; старый файл в .wolf/tools допустимо оставить по его пути.
+Обновляй известную карточку штатным способом, сохраняя ID; не создавай дубликат
+и не используй --force вместо поиска аналога. Новую команду/поле сначала проверь
+в текущем CLI/help.
+
+## Что сохранять
+
+tmp допустим для одноразовой пробы. Скрипт, необходимый для повторного
+использования, воспроизведения результата или продолжения, сохраняется и
+регистрируется до завершения задачи. Имя «временный» не отменяет зависимости.
+Одной ссылки на tmp недостаточно. Разовая команда без дальнейшей ценности
+не требует упаковки или карточки.
+
+Если скрипты создавались, L2 возвращает кратко назначение/путь/проверку/нужность.
+L1 обеспечивает сохранность и регистрацию до приёмки; Git diff не видит все
+созданные в tmp средства. Оформление уже разрешённого средства — часть завершения,
+не новое согласование. Существенное расширение автоматизации — решение владельца.
+
+## Поиск, качество и запуск
+
+Перед повторяемой работой используй доставленное средство или адресный
+wolf tool list --status active, затем контракт выбранного объекта. Не ищи
+весь каталог на каждую команду. Проверь применимость, версию значимых файлов,
+cwd/ресурсы и права. Изменение несвязанных файлов не отменяет все evidence.
+Отсутствующий путь или устаревшая карточка — ограничение, не повод создавать
+другую копию. Сохраняй исходник при ошибке регистрации.
+
+Средство должно быть лёгким, понятным и по возможности переиспользуемым:
+достаточные зависимости, параметры известных повторов, ясные результаты/ошибки,
+проверка назначения и существенных рисков. Не создавай универсальный продукт
+из каждой пробы. wolf tool use — учёт, не запуск и не доказательство успеха;
+реальный запуск разрешённым способом возвращает отдельный исход/evidence.

package/templates/base/skills/using-skills/references/routes-capabilities.md

@@ -0,0 +1,13 @@
+# Развитие возможностей
+
+| Когда | Как применить | Результат |
+| --- | --- | --- |
+| Создание/изменение методики | writing-skills: сценарий, канон и проверка поведения | Проверенная методика и откат |
+| Подключение внешнего пакета | wolf-skill-intake: проверить источник/revision и scope | Проверенная доступная методика |
+| Повторяемая техническая операция | [Библиотека проекта](project-tools.md): найти аналог, создать при необходимости | Инструмент и карточка |
+| Дефект действующего правила | wolf-feedback: W1–W4, complaint, действующий триаж | Основание коррекции Стюардом |
+
+Новая помощь собирается L1 из L2, подходящего лица, скиллов и доступных средств.
+Скрипт обслуживает повторяемую механику, не является обязательной формой
+помощника. Рабочие записи не становятся автоматически уроками или жалобами.
+Локальная мутация Стюарда не становится глобальным шаблоном без своей проверки.

package/templates/base/skills/using-skills/references/routes-communication.md

@@ -0,0 +1,13 @@
+# Объяснение, визуальный диалог и документ
+
+| Когда | Как применить | Результат |
+| --- | --- | --- |
+| Нужно объяснить человеку | wolf-explain: восстановить недостающую связь, причины и последствия | Понятное объяснение |
+| Лучше увидеть вариант или механизм | wolf-visual-dialogue: показать, получить feedback, уточнить | Общее понимание либо выбранный вариант |
+| Запрошен самостоятельный документ | wolf-user-report: структурировать достаточный ответ в нужном формате | Читаемый документ с основаниями |
+
+Навыки могут создавать один результат без трёх агентов/файлов. L0 ведёт разговор,
+L1 поручает подготовку конечным L2 с нужными лицами и скиллами. HTML-документ —
+по запросу или согласованию; уже данное согласование сохраняется. Для ответа
+в чате и служебного RESULT report не обязателен. Выбор макета не утверждает
+ещё не показанные требования. Показывай графику по пользе, не ради украшения.

package/templates/base/skills/using-skills/references/routes-execution.md

@@ -0,0 +1,20 @@
+# Планирование и исполнение
+
+L1 до назначения читает [канон TASK](contracts.md). Не передавай L2 всю организацию.
+
+| Когда | Как применить | Результат |
+| --- | --- | --- |
+| Есть approved-входы, нужна декомпозиция | wolf-plan: L1 выделяет результаты, зависимости и проверки | Исполнимые конечные TASK |
+| Нужно определить проверки | wolf-testplan: связать критерии с независимым oracle | Сценарии и команды |
+| Начинается поставка | wolf-sdd: L1 выбирает лица/скиллы и назначает ready-задачи L2 | Проверенные и интегрированные результаты |
+| L2 выполняет назначенный мандат | wolf-execute: линейно выполнить только свою часть | RESULT/evidence либо конкретный вопрос L1 |
+| Реализуется поведение или исправление | test-driven-development: наблюдаемые RED/GREEN по применимости | Чувствительная проверка и реализация |
+| Готовится заявление о завершении | verification-before-completion: сверить claim с актуальным evidence | Обоснованное заявление, не автоматический ACCEPTED |
+
+Помощник — L2 с лицом, нужными скиллами и конечным TASK. Постоянный агент или новый
+скрипт для каждого вида помощи не нужен. Группируй однотипные малые изменения
+по одному проверяемому результату; не создавай воркера на команду.
+Независимые ready-задачи запускай параллельно с изоляцией; общие контракты сериализуй.
+Новый результат — fresh, исправление того же непринятого — допустимый continue.
+После приёмки сохраняй нужное и закрывай ненужный экземпляр без отдельного отчёта.
+Недоступность L2 — ограничение, а не разрешение L1 выполнить за него всю работу.

package/templates/base/skills/using-skills/references/routes-intent.md

@@ -0,0 +1,14 @@
+# Понимание и выбор решения
+
+| Когда | Как применить | Результат |
+| --- | --- | --- |
+| Новая цель или существенное разночтение | wolf-brainstorm: L0 сверяет намерение по контексту; адресное чтение поручает через L1 | Понятные цель, границы и выбранный следующий шаг |
+| Ясное поручение с достаточными входами | wolf-brainstorm: показать понимание и продолжить без ритуального вопроса | Исполнение в согласованном scope |
+| Нужен ответ исследованием | L1 назначает вопрос worker-researcher с лицом/скиллом, источниками и остановкой | FINDINGS/CONFIDENCE/GAPS |
+| Утверждены требования, нужен дизайн | wolf-design: контракты и решения по FULL/новым интерфейсам | Проверяемое решение без реализации |
+
+Продолжение неизменившейся цели не возвращай в discovery. Понимание цели не
+утверждает ещё не показанные requirements/design. Пользователь может выбирать
+разговор, объяснение или документ; полный пакет разработки не обязателен.
+Для наглядного обсуждения подключи wolf-visual-dialogue, для ясного языка —
+wolf-explain. Исследование и консилиум требуют собственного основания.

package/templates/base/skills/using-skills/references/routes-quality.md

@@ -0,0 +1,14 @@
+# Проверка, диагностика и обратная связь
+
+| Когда | Как применить | Результат |
+| --- | --- | --- |
+| Назначен баг/неожиданное поведение | wolf-debug: локализовать причину адресными экспериментами | Evidence причины либо предел вывода |
+| Ревью документа | wolf-review: назначенная линза и критерии на revision | SUMMARY/VERDICT/FINDINGS/SCOPE/LIMITS/EVIDENCE |
+| Ревью реализации | requesting-code-review: независимому L2 передать материалы, нормы, evidence | Соответствие, затем качество |
+| Получены замечания | receiving-code-review: проверить основания и исправить относящееся | Решение по finding IDs и адресная перепроверка |
+| Вопрос, FRICTION, отклонение или W1–W4 | wolf-feedback: выбрать адресата, не расследовать всё | Вопрос, коррекция, жалоба либо назначенная диагностика |
+
+Первый reviewer не получает ожидаемый verdict и чужие findings. Повторный проход
+проверяет исправления и затронутые изменения; расширение требует основания.
+Не запускай аудит соседнего дефекта. Очевидный W1–W4 не требует повторов или
+диагностики всей сессии. Сбой инструмента не автоматически плохое правило.

package/templates/base/skills/using-skills/references/routes-state.md

@@ -0,0 +1,15 @@
+# Сохранение, Git и передача
+
+| Когда | Как применить | Результат |
+| --- | --- | --- |
+| Git-граница: вход, checkpoint, завершение | wolf-git: проверить baseline, сохранность и полномочия | Подтверждённое состояние Git |
+| Нужна изоляция записи | using-git-worktrees: назначить владельца и отдельное место | Рабочая копия по политике |
+| Смена сеанса/исполнителя или восстановление | wolf-handoff: передать состояние и решения адресно | Продолжение без повторной работы |
+| Готовы интеграция и уборка | finishing-a-development-branch: проверить сохранность и доступные действия | Разрешённое завершение |
+| Выбирается режим/место документа | [Правила проекта](project-rules.md): использовать существующее соглашение | FULL/LITE/FIX и правильные материалы |
+| Создан полезный скрипт | [Инструменты проекта](project-tools.md): сохранить и учесть карточкой | Средство для следующих задач |
+
+Рабочая память — по [адресному контракту](context-and-memory.md). Принятое на
+применимой revision не повторяется; незавершённое продолжается, устаревшее
+evidence проверяется адресно. Недоступное не превращай в «успешно». Грязная
+рабочая копия не чистится ради удобства; сначала сохраняется нужный результат.

package/templates/base/skills/wolf-brainstorm/SKILL.md

@@ -34,13 +34,13 @@ L0 использует метаданные. Содержательное из
 | Существенно разные прочтения | Покажи различие сценарием или предположением и выясни намерение. |
 | Простой вопрос с ответом в доставленном контексте | Ответь; не запускай тред и исследование ради формальности. |
 
-До исследования предмета, диспетча исполнения, scaffold и требований изложи
-своё понимание новой содержательной задачи так, чтобы пользователь мог его
-поправить; по умолчанию дождись ответа. Прямое поручение сокращает разговор,
-не отменяет сверку. Не выдумывай неизвестное ради вопроса. Подтверждение именно
-этой цели/границ сохраняет силу; повторный одинаковый гейт не нужен. Явное
-«продолжай без вопросов» учитывай в его пределах, назвав существенные допущения;
-молчание не подтверждение.
+До дорогого исследования, scaffold и требований покажи понимание новой цели
+так, чтобы пользователь мог поправить существенное. Используй доставленный
+контекст; при необходимости назначь через L1 короткое адресное ознакомление,
+не полный аудит. Если цель/результат/границы достаточны, продолжай порученное
+без ритуального ожидания ответа. Существенную развилку уточни до зависимой работы;
+молчание не подтверждает неизвестное. Гейты ещё не показанных requirements/design
+сохраняются. Продолжение той же цели не требует повторной сверки.
 
 Различай желаемый результат и предложенный способ его получить. Не превращай
 сравнение в обязательную унификацию, совет — в проект внедрения, а подготовку

package/templates/base/skills/wolf-debug/SKILL.md

@@ -87,3 +87,10 @@ L1 сначала решает сам/уточняет вход/использу
 | «Похоже на timeout, увеличу его» | Сначала различи причину и временное снижение ущерба. |
 | «Несколько правок ускорят поиск» | Эксперимент должен различать гипотезы. |
 | «Третья попытка точно сработает» | Проверь модель причины и запроси независимый разбор. |
+
+## Прикладные техники
+
+Если нужна конкретная техника, читай references/techniques.md: трассировка
+первопричины, диагностика границ, поиск загрязняющего теста и ожидание условия.
+Техника не расширяет диагностический вопрос и не является обязательным аудитом.
+Для вопроса, FRICTION или W1–W4 применяй wolf-feedback в пределах своей роли.

package/templates/base/skills/wolf-debug/references/techniques.md

@@ -0,0 +1,20 @@
+# Приёмы адресной диагностики
+
+Выбери технику под назначенный вопрос. Она не расширяет полномочия или scope.
+
+| Затруднение | Приём | Достаточный результат |
+| --- | --- | --- |
+| Ошибка проявилась глубже причины | Иди назад от неверного значения к месту его получения; на каждой границе сопоставляй вход, преобразование и выход | Первая граница, где нарушен известный контракт, с подтверждением |
+| Несколько компонентов | Поставь минимальную диагностику на подозреваемых границах, передавая корреляционный ID и метаданные без payload/секретов | Различена ошибка отправителя, передачи или получателя |
+| Тест падает только в наборе | Воспроизведи порядок, сузь предшествующий набор делением; проверь общий файл, env, cache, время и cleanup | Минимальная пара/последовательность и нарушенная изоляция |
+| Ожидается асинхронный результат | Жди наблюдаемое условие с конечным timeout и диагностикой последнего состояния | Условие выполнено либо timeout с evidence; увеличение sleep не доказательство исправления |
+
+Для поиска загрязняющего теста важен фактический порядок; бинарное деление
+не гарантирует результат при нескольких совместных причинах. Отрицательный
+эксперимент — полезный исход. Не запускай бесконечные прогоны; новый способ L2
+возвращает L1. Временную диагностику убери после сохранения evidence.
+
+Пример ожидания: процесс должен зарегистрировать событие с известным ID.
+Проверяй получение этого события до deadline; фиксируй отсутствие и последнее
+состояние. Не считай сам факт ожидания успешной проверкой. Если система не даёт
+наблюдаемого условия, уточни контракт или назначь ограниченную диагностику.

package/templates/base/skills/wolf-execute/SKILL.md

@@ -1,61 +1,56 @@
 ---
 name: wolf-execute
-description: "Применять при линейном исполнении утверждённого плана или разрешённого LITE/FIX-брифа исполнительской ролью, когда диспетчеризация не нужна либо недоступна."
+description: "Применять L2 при выполнении назначенной конечной подзадачи по утверждённому плану или разрешённому брифу; при продолжении того же результата."
 ---
 
-# Линейное исполнение
-
-## Обязательный вход
-
-До правок проверь входы, роль, текущую рабочую копию и разрешения. L0 не выполняет этот процесс: передаёт его executor. L2 исполняет только назначенную подзадачу без коммитов и спавна. Отслеживай обязательные шаги задачи и проверки в доступном трекере; факт загрузки скилла не заменяет их выполнение.
-
-Используй полный актуальный текст назначенной методики. По wolf-work-strategy различай обязательные требования, условные действия и доступные техники; отслеживай применимые обязательства в существующем TASK/трекере. Не создавай новые статусы памяти; недоступное обязательное действие передай ответственному уровню.
-
-
-## Вход и ограничения
-
-Применять только исполнительской роли. Этот маршрут применим, когда диспетчеризация недоступна или не нужна. Входы и TASK/RESULT/EVIDENCE — как в using-skills. Утверждённый FULL plan требует design и test-plan; LITE/FIX достаточно разрешённого брифа. Проверь workspace, профиль проекта, baseline и права на git. L0 передаёт работу executor, не использует fallback для обхода своей рамки.
-
-## Процесс
-
-1. Сверь входы с текущим кодом; обозначь несовместимость до правок. Зафиксируй зависимости и исходные падения проверок.
-2. L1 при недоступной/ненужной диспетчеризации выполняет разрешённую линейную работу; L2 — только один назначенный конечный мандат без интеграции поставки. Выполняй свои ready-шаги последовательно: прочитай затронутый код, пройди подходящую тестовую дисциплину, внеси allowlist-изменения, проверь результат и сохранённые инварианты.
-3. После каждой задачи запиши RESULT/evidence. Коммит выполняй только при разрешении роли и пользователя. L1 ставит отметку [x] после нужного ревью; до него сохрани состояние «готово к ревью» без выдуманного значения таксономии.
-4. L2 возвращает checkpoint по своему стоп-условию. L1 сохраняет checkpoint на завершённом компоненте, перед сменой этапа или сессии; default не более 3 небольших задач без сохранения состояния. В него включи baseline/current state, completed/remaining, evidence и dirty-state.
-5. L2 возвращает результат/запрос ревью L1. L1 организует независимое ревью разрешённым каналом; при его отсутствии передаёт ограничение L0/владельцу. Саморевью не независимо.
-6. L1 после интеграции выполняет test-plan и полный применимый гейт, формирует ACCEPTANCE; L2 возвращает RESULT, не выполняет этот этап. Дальнейший git-финал — finishing-a-development-branch.
-
-## Уточнение во время исполнения
-
-Вопрос по wolf-work-strategy — нормальный шаг к результату, без требования
-сначала перебрать гипотезы. Верни его через существующий контракт роли; ответ
-руководителя становится входом продолжения той же задачи. Если результат уже
-получен, не добавляй исследования и проверки без влияющего на вывод основания.
-
-## Завершение без повторов
-
-Режим execute не открывает заново утверждённое решение. Читай только нужные
-источники; повторяй проверку при изменении её входов, новой ошибке или явном
-требовании. L2 при неожиданной сложности/новом способе или двух шагах без
-продвижения возвращает результат и вопрос L1; сам исследование не выбирает.
-Конечный лимит обязателен, без заданного — возврат через 8 обращений. Сбой инструмента: один осмысленный обход, затем FRICTION и остаток,
-не отдельное исследование устройства среды. После назначенных проверок верни
-RESULT; не увеличивай объём работы ради более длинного отчёта.
-
-## Блокер и восстановление
-
-При недостатке контекста верни NEEDS_CONTEXT; при невозможности продолжения — BLOCKED с причиной, выполненным и безопасным следующим действием. Локальную очевидную ошибку исправь в лимите. Неизвестная причина/новый способ для L2 — возврат L1, а не самостоятельный запуск wolf-debug. L1 выбирает следующую диагностическую подзадачу без опроса владельца о локальных деталях. Изменение scope/контракта эскалируй.
-
-После прерывания сверяй план с фактическими файлами, git и evidence. Не повторяй миграции, публикации и внешние действия без проверки их исхода. По лимиту назначенных повторов (default 2) L1 пересматривает подход; L2 возвращается раньше по своему стоп-условию. Недоступную запись памяти передай ответственному уровню.
-
-## Гейт перехода
-
-L2 после самопроверки возвращает RESULT/evidence L1; DONE означает готовность к ревью. L1 организует предусмотренное ревью, интеграцию, ACCEPTANCE и согласованный git-финал. verification-before-completion применяет каждая роль к собственным утверждениям. Недоступный канал явно ограничивает результат, не расширяет роль.
-
-## Не пропускай процесс
-
-| Мысль | Действие |
-| --- | --- |
-| «Сам проверю и сам приму» | Саморевью не независимо; приёмка остаётся у назначенного уровня. |
-| «Нет агентов, значит L0 может писать код» | Недоступность инструмента не расширяет роль. |
-| «Продолжу после сбоя с того же действия» | Сначала проверь исход предыдущего действия и checkpoint. |
+# Исполнение конечного мандата L2
+
+Получай TASK, лицо, полный скилл действия и относящиеся ограничения от L1.
+TASK/RESULT/EVIDENCE — по using-skills/references/contracts.md. L0 не выполняет
+этот процесс. L1 организует через wolf-sdd, принимает и интегрирует; этот навык
+не разрешает ему заменять воркеров универсальным исполнением. Если диспетчеризация
+недоступна, L1 возвращает конкретное ограничение, не имитирует вызов.
+
+## Исполнение
+
+1. Сверь назначенные входы с фактической revision, allowlist и правами.
+   Недостающий обязательный вход — NEEDS_CONTEXT, не догадка. Не повторяй общий
+   bootstrap или поиск уже доставленной методики.
+2. Выполни только ready-шаги своего результата: нужное чтение, применимая
+   тестовая дисциплина, изменение и назначенная проверка. Не отменяй гейт
+   ради краткости; техники выбирай по пользе через wolf-work-strategy.
+3. Проверь результат, существенные инварианты и свой diff. Код-первый, неполная
+   проверка и pre-existing failure указываются честно. Саморевью не независимо.
+4. Верни RESULT по роли: статус/вердикт, изменения, evidence на проверенное
+   состояние, ограничения и адресный вопрос при необходимости. DONE — готовность
+   к независимой проверке, не ACCEPTED. Не коммить, не спавни и не интегрируй.
+5. Если созданы скрипты, верни назначение, пути, проверку и необходимость
+   сохранения. L1 обеспечивает постоянное место/карточку по
+   using-skills/references/project-tools.md. tmp не единственный источник
+   нужного следующему исполнителю средства.
+
+## Вопрос, блокер и остановка
+
+Вопрос руководителю — нормальное действие до провалов. Используй wolf-feedback
+для относящегося затруднения; сбой инструмента не запускает полный аудит.
+Локальную очевидную коррекцию выполни в лимите; неизвестную причину, новый способ,
+существенный выход за scope верни L1 с установленным и нужным входом.
+Без заданного лимита возврат не позднее 8 обращений; два шага без продвижения —
+раньше. Не повышай model/variant и не продлевай бюджет сам.
+
+После результата заверши вызов. Не добавляй соседних исследований и проверок
+без влияющего на вывод основания. При продолжении того же непринятого результата
+используй ответ L1 и сохранённое состояние; уже достаточное не повторяй.
+Новая независимая задача получает fresh по решению L1. После приёмки ненужный
+экземпляр закрывается без отдельной церемонии, с сохранением нужных материалов
+и окончанием записи; закрытие сессии не удаляет worktree/evidence.
+
+## Гейт
+
+Результат соответствует конечному TASK либо предел явно указан. L1 проверяет
+evidence, назначает независимое ревью, интегрирует и передаёт ACCEPTANCE L0.
+Служебный RESULT не требует отдельного файла или пользовательского отчёта.
+
+Для повторяемых технических операций при необходимости читай
+[контракты средств](references/technical-helpers.md). Они не заменяют L2
+и не создают дополнительную процедуру для каждой простой задачи.