Madspec Policy Engine

madspec-policy-engine

Когда использовать

Используй этот навык, когда пользователь просит:

• показать текущие проектные правила
• предложить или изменить правило проекта
• вывести устаревшее правило из действия
• объяснить, почему правило влияет на процесс
• проверить состояние ветки через madspec policy validate

Язык и стиль

• В русскоязычных ответах не смешивай русский и английский без явной необходимости.
• Английский используй только для имен команд, путей, файлов, API и других точных идентификаторов.
• Перед завершением обязательно перечитай ответ и убери неуместные англицизмы, кальки и смешанные конструкции.

Канонический порядок работы

1. Прочитай текущее состояние через madspec policy show --json-output.
2. Если нужно изменить правила, сначала создай предложение через madspec policy propose.
3. Покажи пользователю предварительное сравнение и предупреждения.
4. Применяй изменение только через madspec policy apply или madspec policy set.
5. После применения изменения при необходимости запускай madspec policy validate.

Источник истины

• .madspec/system/policy/state.json
• .madspec/system/policy/proposals.jsonl
• .madspec/system/policy/history.jsonl

policy.md и разделы с правилами внутри производных артефактов ветки — это производные представления.

Ограничения E1

• Слой правил общий для всего проекта и не поддерживает локальные переопределения на уровне ветки
• Принудительно проверяются только поддержанные инварианты процесса
• Неподдерживаемый ruleType автоматически нормализуется в рекомендацию с режимом guideline
• Системные правила являются read-only и не должны изменяться через пользовательский процесс

Полезные команды

madspec policy show --json-output
madspec policy propose --policy-id ... --title ... --description ...
madspec policy apply --proposal-id ...
madspec policy deprecate --policy-id ...
madspec policy validate --stage mvp.plan --toon-output
madspec policy explain --policy-id ... --json-output