| name | madspec-gate-orchestrator |
| description | Операционный навык для слоя контрольных проверок в MADSpec. Использовать, когда нужно показать статус через `madspec gate status`, объяснить блокировку перехода, выполнить аудируемую проверку или управлять предложениями на исключения через `madspec gate ...`. |
madspec-gate-orchestrator
Когда использовать
Используй этот навык, когда пользователь просит:
- объяснить, почему переход стадии или шага блокируется
- проверить готовность перед
register-step, start-step, checkpoint-step, complete-step
- посмотреть статус
review или security
- предложить или применить исключение для допускающей исключение проверки
- понять активные исключения и историю запусков общего вычислителя проверок
Язык и стиль
- В русскоязычных ответах не смешивай русский и английский без явной необходимости.
- Английский используй только для имен команд, путей, файлов, API и других точных идентификаторов.
- Перед завершением обязательно перечитай ответ и убери неуместные англицизмы, кальки и смешанные конструкции.
Канонический порядок работы
- Сначала прочитай текущее состояние через
madspec gate status --toon-output или madspec gate explain --toon-output, если результат будет читать агент; --json-output оставляй только для машинной интеграции.
- Для конкретного перехода используй
madspec gate run --stage ... --operation ... --json-output.
- Если нужно исключение, сначала создай предложение через
madspec gate propose-waiver.
- Покажи пользователю предварительное представление предложения и дождись явного подтверждения.
- Применяй исключение только через
madspec gate apply-waiver.
Источник истины
.madspec/<BRANCH>/gates/state.json.madspec/<BRANCH>/gates/proposals.jsonl.madspec/<BRANCH>/gates/history.jsonl
В state.json хранится только состояние примененных исключений и ревизия. Снимки состояния контрольных проверок всегда вычисляются из памяти, progress, рабочего состояния, записей контрольных точек и правил проекта.
Ограничения E4
- Исключение привязано к ветке и не имеет срока действия в E4 v1
- Исключение не меняет память, код, правила проекта и не завершает переход автоматически
- Ошибки целостности, битые зависимости шагов и встроенные TDD-инварианты нельзя ослаблять через исключение
review status и security status — это только алиасы для чтения над общим вычислителем проверок
Полезные команды
madspec gate status --stage mvp.implement --operation complete-step --toon-output
madspec gate run --stage review --operation validate --json-output
madspec gate explain --stage feature.plan --operation register-step --step-id step-02-auth --toon-output
madspec gate propose-waiver --stage review --gate-id <GATE_ID> --reason "..." --json-output
madspec gate apply-waiver --proposal-id <PROPOSAL_ID> --json-output
madspec review status --toon-output
madspec security status --toon-output
