wytyczne-architektury-oprogramowania

SKILL.md

---
name: wytyczne-architektury-oprogramowania
description: Stosuj kontekstowe wytyczne dotyczące architektury oprogramowania podczas analizy granic systemu, wymagań jakościowych, komunikacji, stylów, decyzji, ryzyk lub ewolucji.
---

# Wytyczne dotyczące architektury oprogramowania

Użyj tego przenośnego szkicu, aby wspierać prace architektoniczne w różnych dziedzinach oprogramowania. Nie jest on instalowany globalnie. Książka dostarcza koncepcji i kompromisów; ten przewodnik operacjonalizuje je jako warunkowe kontrole. Nie są to polecenia projektowe ani substytuty intencji użytkownika, lokalnego zarządzania czy znanych dowodów systemowych.

## Przebieg pracy

1. **Ustal kontekst i uprawnienia.** Zidentyfikuj domenę, granicę systemu, cele biznesowe, ograniczenia wdrożeniowe i danych, możliwości zespołu, znane dowody, niewiadome oraz uprawnienia decyzyjne. Szanuj już delegowane uprawnienia. Pytaj tylko o brakujące fakty, które mogą zmienić wynik; w przeciwnym razie podaj warunkową rekomendację.
2. **Uszereguj czynniki napędowe.** Przetłumacz wyniki interesariuszy na cechy architektoniczne. Przetestuj każdy kandydat względem trzyczęściowej definicji, rozłóż cechy złożone i ustal priorytet niewielkiego zestawu.
3. **Zmapuj granice i dane.** Zidentyfikuj odpowiedzialności funkcjonalne, zależności, transakcje, własność danych, statyczne powiązania, wywołania w czasie działania oraz cechy na każdej istotnej granicy.
4. **Porównaj proporcjonalnie.** Przy istotnym wyborze porównaj co najmniej dwie realne opcje względem określonych priorytetów, kosztów, ryzyk i dowodów. Nie wymuszaj formalnego porównania dla małej, odwracalnej zmiany.
5. **Podejmij decyzję z uzasadnieniem.** Podaj rekomendację lub status, dlaczego pasuje, zaakceptowane koszty, założenia oraz jakie dowody spowodowałyby ponowne rozważenie. Postępuj zgodnie z delegowanymi uprawnieniami; nie wymyślaj bramek zatwierdzeń.
6. **Określ kontrole.** Wybierz miary lub funkcje dopasowania proporcjonalne do ryzyka. Nazwij ich zakres, sygnał, ograniczenia i reakcję.

## Zasady podstawowe

- Opieraj rekomendacje na kontekście ([zasady kontekstu i priorytetów](references/rulebook.md#context-priorities): F01) i szanuj delegowane uprawnienia ([zasady decyzji, ryzyka i ewolucji](references/rulebook.md#decisions-risk-evolution): D03).
- Wyprowadzaj i uszereguj cechy na podstawie mierzalnych wyników interesariuszy ([zasady kontekstu i priorytetów](references/rulebook.md#context-priorities): F05, F06, F07, F08, F18).
- Zachowuj spójność odpowiedzialności i uczciwość granic względem zależności i powiązań ([zasady granic](references/rulebook.md#boundaries-coupling-data): F11–F17, S03, S08; [słownik](references/glossary.md)).
- Wybierz komunikację odpowiednią do pracy; rozróżniaj żądanie, polecenie i zdarzenie oraz projektuj na wypadek awarii ([zasady komunikacji](references/rulebook.md#communication-reliability): S06, S09–S13, S15, D08).
- Traktuj style architektury jako opcje warunkowe i porównuj ich koszty ([zasady stylu](references/rulebook.md#style-choice): S01, S16, D06; [przewodnik po stylach](references/style-selection.md)).
- Zapisuj, dlaczego istnieją istotne decyzje i co by je zmieniło ([kompromisy](references/rulebook.md#context-priorities): F02; [zapisy decyzji](references/rulebook.md#decisions-risk-evolution): F03).
- Ujawniaj ryzyko, niepewność i zgodność implementacji ([zasady ryzyka i ewolucji](references/rulebook.md#decisions-risk-evolution): D10, D11, D12, D13).
- Zarządzaj ważnymi ograniczeniami za pomocą zrozumiałych kontroli ([zasady zarządzania](references/rulebook.md#decisions-risk-evolution): F09, F10).
- Zachowaj wybór zespołu w ramach faktycznych uprawnień i ograniczeń ([zasady zespołu i komunikacji](references/rulebook.md#communication-teams): S04, D16, D17, D18).
- Stosuj wskazówki specyficzne dla dostawcy tylko gdy projekt obejmuje dostawcę modelu ([D15 w rules.json](references/rules.json)).

## Kontrakt wyjściowy

Zwróć: kontekst i niewiadome; rekomendację i status; alternatywy i koszty; implikacje granic, danych i komunikacji; dowody i kontrole; oraz wyzwalacz ponownego rozważenia. Skaluj szczegółowość do konsekwencji wyboru.

## Odniesienia

Dla zadania ładuj tylko odpowiednią kategorię w [rules.json](references/rules.json) lub czytaj jej sekcję w [rulebook.md](references/rulebook.md), nie oba ani cały pakiet. Ładuj [style-selection.md](references/style-selection.md) dla dziewięciu stylów, [glossary.md](references/glossary.md) dla terminów źródłowych oraz [source-map.json](references/source-map.json) do lokalizacji cytowanych rozdziałów. Syntetyczne prompt-y ewaluacyjne są w [evaluation-cases.json](references/evaluation-cases.json); nie były uruchamiane. Metoda i ograniczenia są w [method-and-validation.md](references/method-and-validation.md).