AGENT SKILL

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. Без исхода архитектуру не начинают.
  • Понимание горизонта: этот спринт или несколько лет.

Процедура

  1. Назвать один слой. Если человек просит все три, сделать три подписанных раздела, а не одну схему.
  2. Бизнес-слой: список способностей и не-целей. Без классов и библиотек.
  3. Энтерпрайз-слой: владелец данных и граница команды. Дорогой выбор записать ADR.
  4. Слой решения: интерфейсы, данные, отказы. Поведение в Sysl, состав в CALM, оба через check.
  5. Остановить смешение правилом 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