рекомендации по архитектуре программного обеспечения

SKILL.md

---
name: рекомендации по архитектуре программного обеспечения
description: Применяйте контекстные рекомендации по архитектуре программного обеспечения при анализе границ системы, требований к качеству, коммуникаций, стилей, решений, рисков или эволюции.
---

# Руководство по архитектуре программного обеспечения

Используйте этот переносимый черновик для поддержки работы по архитектуре в различных областях программного обеспечения. Он не устанавливается глобально. Книга предоставляет концепции и компромиссы; это руководство реализует их в виде условных проверок. Они не являются командами проекта или заменой пользовательского намерения, локального управления или известных системных данных.

## Рабочий процесс

1. **Установите контекст и полномочия.** Определите домен, границы системы, бизнес-результаты, ограничения по развертыванию и данным, возможности команды, известные факты, неизвестные моменты и полномочия по принятию решений. Уважайте уже делегированные полномочия. Запрашивайте только недостающие факты, которые могут изменить результат; в противном случае давайте условную рекомендацию.
2. **Ранжируйте драйверы.** Переведите результаты заинтересованных сторон в архитектурные характеристики. Проверьте каждую кандидатуру по трехчастному определению, разложите составные качества и приоритизируйте небольшой набор.
3. **Картируйте границы и данные.** Определите функциональные обязанности, зависимости, транзакции, владение данными, статическую связанность, вызовы во время выполнения и характеристики на каждой релевантной границе.
4. **Сравнивайте пропорционально.** Для значимого выбора сравните как минимум два жизнеспособных варианта с учетом заявленных приоритетов, затрат, рисков и данных. Не заставляйте проводить формальное сравнение для небольшого обратимого изменения.
5. **Принимайте решение с обоснованием.** Укажите рекомендацию или статус, почему она подходит, принятые затраты, предположения и какие данные могут привести к пересмотру. Следуйте делегированным полномочиям; не придумывайте контрольные точки утверждения.
6. **Укажите проверки.** Выберите меры или функции пригодности, пропорциональные риску. Назовите их область, сигнал, ограничения и реакцию.

## Основные правила

- Основывайте рекомендации на контексте ([правила контекста и приоритетов](references/rulebook.md#context-priorities): F01) и уважайте делегированные полномочия ([правила решений, рисков и эволюции](references/rulebook.md#decisions-risk-evolution): D03).
- Выводите и ранжируйте характеристики на основе измеримых результатов заинтересованных сторон ([правила контекста и приоритетов](references/rulebook.md#context-priorities): F05, F06, F07, F08, F18).
- Поддерживайте связность обязанностей и честность границ относительно зависимостей и связанности ([правила границ](references/rulebook.md#boundaries-coupling-data): F11–F17, S03, S08; [глоссарий](references/glossary.md)).
- Выбирайте коммуникацию для работы; различайте запрос, команду и событие, и проектируйте с учетом отказов ([правила коммуникации](references/rulebook.md#communication-reliability): S06, S09–S13, S15, D08).
- Рассматривайте архитектурные стили как условные варианты и сравнивайте их затраты ([правила стиля](references/rulebook.md#style-choice): S01, S16, D06; [руководство по стилю](references/style-selection.md)).
- Записывайте причины значимых решений и что могло бы их изменить ([компромиссы](references/rulebook.md#context-priorities): F02; [записи решений](references/rulebook.md#decisions-risk-evolution): F03).
- Делайте видимыми риски, неопределенности и согласованность реализации ([правила рисков и эволюции](references/rulebook.md#decisions-risk-evolution): D10, D11, D12, D13).
- Управляйте важными ограничениями с помощью проверок, понятных людям ([правила управления](references/rulebook.md#decisions-risk-evolution): F09, F10).
- Сохраняйте выбор команды в рамках фактических полномочий и ограничений ([правила команды и коммуникации](references/rulebook.md#communication-teams): S04, D16, D17, D18).
- Применяйте рекомендации, специфичные для провайдера, только если проект включает модель провайдера ([D15 в rules.json](references/rules.json)).

## Контракт вывода

Возвращайте: контекст и неизвестные; рекомендацию и статус; альтернативы и затраты; последствия для границ, данных и коммуникаций; данные и проверки; а также триггер для пересмотра. Масштабируйте детализацию в зависимости от значимости выбора.

## Ссылки

Для задачи загружайте только соответствующую категорию из [rules.json](references/rules.json) или читайте ее раздел в [rulebook.md](references/rulebook.md), но не оба и не весь пакет. Загружайте [style-selection.md](references/style-selection.md) для девяти стилей, [glossary.md](references/glossary.md) для терминов на основе источников и [source-map.json](references/source-map.json) для поиска упомянутых глав. Синтетические промпты для оценки находятся в [evaluation-cases.json](references/evaluation-cases.json); они не запускались. Метод и ограничения описаны в [method-and-validation.md](references/method-and-validation.md).