architecture
Не даёт смешать способности, владение системами и контракт спринта в один рисунок.
- License 许可
- MIT
- 最近更新
- 2026-10-23
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- architecture
- description
- Не даёт смешать способности, владение системами и контракт спринта в один рисунок.
03 SKILL.md 正文
Три слоя архитектуры
Три вопроса задают три роли. Бизнес-архитектор говорит, какие способности есть и чего система не делает. Энтерпрайз-архитектор говорит, какая система чем владеет и какое решение живёт годы. Архитектор решения пишет контракт, по которому другие команды строят этот спринт. Председатель только выбирает, кто говорит.
Ответственность
Владелец: Architecture chair.
Код, который проверяет результат: src/mazu_method/sdd.py.
Если вопрос принадлежит другой роли, этот скилл останавливается и называет её. Он не закрывает чужой гейт и не подменяет чужое решение.
Когда открывать
- Просьба «нарисуй архитектуру» без указания, какой из трёх вопросов задан.
- Один документ одновременно содержит способности, границы компаний и классы.
Когда не открывать
- Вопрос уже узкий: только вызовы. Это Sysl. Только коробки. Это CALM. Только выбор. Это ADR.
Входы, без которых процедуру не начинают
- Исход от PO. Без исхода архитектуру не начинают.
- Понимание горизонта: этот спринт или несколько лет.
Процедура
- Назвать один слой. Если человек просит все три, сделать три подписанных раздела, а не одну схему.
- Бизнес-слой: список способностей и не-целей. Без классов и библиотек.
- Энтерпрайз-слой: владелец данных и граница команды. Дорогой выбор записать ADR.
- Слой решения: интерфейсы, данные, отказы. Поведение в Sysl, состав в CALM, оба через
check. - Остановить смешение правилом BOUND-2. Команда guard используется, если действие формулируется как «объединить слои».
Гейты и гардрейлы
- Нет исхода — нет рисунка. Сначала product-ideas.
- Смешение слоёв без явной просьбы на обзорный лист — остановка.
- Даже обзорный лист подписывает три слоя отдельно.
Ненулевой код выхода — это отказ. Агент не пишет, что шаг пройден, пока в stdout нет PASS.
Делать
- Звать ровно одну роль-автора на проход.
- Требовать ADR на одностороннюю дверь.
Не делать
- Не выбирать библиотеку в бизнес-слое.
- Не проектировать внутренности сервиса в энтерпрайз-слое.
- Не подменять разработчика контрактом: контракт открывает историю, а не пишет её код.
Контроль качества
- В ответе назван один слой и одна следующая роль.
- Изменённые Sysl и CALM прошли check.
Как выглядит провал
- Один рисунок, где capability и class стоят вперемешку.
- Контракт без отказа: не сказано, что видит вызывающий при ошибке.
- Новая связь без ADR, хотя откатить её дорого.
Передача
Контракт, который можно нарезать, уходит в create-epics-and-stories. Код уходит к dev только после ready.
Пример команд
python3 cli/mazu.py check sysl diagrams/sysl/backlog.sysl
python3 cli/mazu.py check calm diagrams/calm/backlog.calm.json
python3 cli/mazu.py guide architecture
Применение инструментов
Каждая команда выше — это python3 cli/mazu.py ... из корня набора. Схему вызова для модели берут из tools/openai.json или tools/gigachat.json и не выдумывают имя функции. Результат известен только после stdout.
Политика и контракт модели
Прочитай файл целиком до первой команды. Политика набора — standards/POLICY.md, и она сильнее этого скилла, если они спорят.
Сделай только раздел «Процедура». Разделы «Когда не открывать» и «Не делать» — запрет, не совет.
Команда с ненулевым кодом — стоп. Покажи её stdout. Не называй это частичным успехом.
Доказательство — строка PASS или id, который команда напечатала. Пока stdout нет, факта нет.
Дальше работает только роль из раздела «Передача». Не делай её шаги в этой же сессии.
04 同仓库更多 Skills
bmad
Provides the canonical BMad entrypoint. Use when the root BMad skill needs validation.
bmad-review-verification-gap
Deprecated — forwards to bmad-review
bmad-review-edge-case-hunter
Deprecated — forwards to bmad-review
bmad-review-adversarial-general
Deprecated — forwards to bmad-review
bmad-editorial-review
Deprecated — forwards to bmad-review
bmad-editorial-review-structure
Deprecated — forwards to bmad-review