Упрощение обвязки и честный валидатор — по итогам прогонов v3 на реальных проектах.
Что изменилось
- Скрипты собраны в одну директорию.
scripts/lib/*.awk→scripts/*.awk,archive.awkрастворён вsdd.sh: четыре файла вместо пяти, на уровень вложенности меньше. - Коды возврата переосмыслены. Ненулевой код теперь означает сбой самого скрипта (нет аргумента, файла, шаблонов), а вердикт живёт в тексте вывода. Раньше
checkиvalidateвозвращали 1 на находках, и обёртка не отличала «нашлись предупреждения» от «скрипт не запустился». - Свежий
initбольше не шумит. Валидатор распознаёт нетронутый шаблон PLAN и пропускает проверки содержания с одним предупреждением вместо десятка находок по заглушкам. - Задача без номера
<этап>.<N>— ошибка, а не предупреждение. Без номера нечем сверить закрытие с WORKLOG, то есть главная проверка отключается молча. archive-tasksпредупреждает о незакрытых задачах в переносимом этапе.- Поиск скилла ограничен глубиной (
find … -maxdepth 6) и закавычен — на больших домашних директориях команда из SKILL.md выполнялась минутами.
Что уточнено в скилле
- Раздел «Состав скилла»: какой файл когда нужен и какие читать не надо вовсе.
- Развилка «документации нет вовсе»: скилл дисциплинирует работу по доке; строить план не на чём — либо пользователь приносит ТЗ, либо требования фиксируются хотя бы страницей.
- Ручной путь ставит якорь вручную — без строки
<!-- sdd-power -->в CLAUDE.md проект не подхватится в следующей сессии. - Нет git — нет тега
stage/<ID>: шаг пропускается, но отмечается в саммари. - Приоритет LESSONS над докой сужен до правил, описывающих уже доказанное расхождение.
Установка и обновление — обычный git clone / git pull в ~/.claude/skills/sdd-power. Полный журнал — CHANGELOG.md.