керівництво зі архітектури програмного забезпечення
Що це робить
Застосовуйте контекстні рекомендації з архітектури програмного забезпечення при аналізі меж системи, вимог до якості, комунікації, стилів, рішень, ризиків або еволюції.
Встановлення відкриє цей запис у вашому настільному додатку AgentsRoom. Якщо додаток ще не встановлено, вас перенаправить на сторінку завантаження.
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).
8 вкладених файлів
- agents/openai.yaml1 kB
- references/evaluation-cases.json8 kB
- references/glossary.md2 kB
- references/method-and-validation.md4 kB
- references/rulebook.md44 kB
- references/rules.json56 kB
- references/source-map.json19 kB
- references/style-selection.md11 kB
Корисні матеріали
Claude Ads: навичка Claude Code, що перевіряє ваші рекламні акаунти
Claude Ads : це навичка з відкритим кодом для Claude Code: понад 250 перевірок на Google, Meta, LinkedIn, TikTok або Amazon Ads, оцінка зі 100 балів і пріоритетний план дій, приблизно за десять хвилин. Встановлення, команди, обмеження та як оркеструвати це в AgentsRoom.
AGENTS.md: Один файл контексту для кожного агента кодування (Codex, Antigravity, Claude)
AGENTS.md - це портативний файл інструкцій, який ваші AI агенти кодування читають перед тим, як торкнутися вашого коду. Що в нього включити, чим він відрізняється від CLAUDE.md та як зберегти один контекст для Codex, Antigravity і Claude.
Завантажити AgentsRoom
Запускайте всіх своїх AI-агентів на всіх своїх проєктах з одного вікна.
Додаток-компаньйон: контролюйте своїх агентів на ходу
Використовуйте свого: Claude, Codex, Antigravity CLI або іншого AI-провайдера.
Надсилайте баги та запити прямо у свій публічний беклог.