Skip to content

v3.1 — упрощение обвязки и честный валидатор

Latest

Choose a tag to compare

@kravcovtech kravcovtech released this 04 Sep 12:42

Упрощение обвязки и честный валидатор — по итогам прогонов 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.