Przejdź do treści
Biblioteka skilli
Programowanie · Planowanie

design-code-architecture

/design-code-architecture

Projektuje lub przegląda architekturę kodu przez model domeny, granice modułów, publiczne kontrakty i małe kroki wdrożenia przed większą funkcją.

Repozytorium
Ai-Stack ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
03.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
6
Skrypty
2
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 03.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

Co sprawdzić przed instalacją
  • 2 skrypty w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: scripts/architecture_evidence.py, scripts/test_architecture_evidence.py

Co robi i kiedy

Projektuje lub przegląda architekturę kodu przez model domeny, granice modułów, publiczne kontrakty i małe kroki wdrożenia przed większą funkcją.

Oryginalny opis (EN)

Projektuje lub recenzuje architekturę kodu przez model domeny, granice modułów, publiczne kontrakty i małe pionowe kroki wdrożenia. Użyj przed większą funkcją, przebudową odpowiedzialności, podziałem monolitu albo gdy zmiana przecina wiele modułów.

Jak działa

  1. Procedura
  2. Twarde zasady
  3. Weryfikacja dowodowa architektury (architectureevidence.py)
Sekcje z nagłówków SKILL.md, w oryginale · 56 linii, 446 słów
Podgląd SKILL.md
---
name: design-code-architecture
description: "Projektuje lub recenzuje architekturę kodu przez model domeny, granice modułów, publiczne kontrakty i małe pionowe kroki wdrożenia. Użyj przed większą funkcją, przebudową odpowiedzialności, podziałem monolitu albo gdy zmiana przecina wiele modułów."
---

# Design code architecture

Nie zaczynaj od katalogów i klas. Najpierw ustal język domeny, odpowiedzialności, przepływ danych i miejsce, w którym wymagana zmiana powinna być izolowana.

Przed edycją zrób zwięzłą mapę wpływu, gdy zmiana istotnie usuwa albo przenosi moduł,
zmienia jego nazwę na granicy modułów lub zmienia publiczny kontrakt. Uwzględnij callerów
przychodzących, zależności wychodzące, przepływ danych, konsumentów i dotknięte sprawdzenia
regresji. Mała lokalna zmiana bez naruszenia tych granic nie wymaga osobnego artefaktu
architektonicznego; szczegóły i przykłady są w `references/architecture-contract.md` oraz
`references/trigger-cases.json`.

## Procedura

1. Zmapuj aktualny system: wejścia, wyjścia, dane trwałe, zależności, publiczne API i właścicieli modułów.
2. Nazwij pojęcia domenowe oraz niezmienniki. Oddziel reguły biznesowe od transportu, frameworka i storage.
3. Wskaż `fixed diff point`: najmniejszą stabilną granicę, za którą przyszłe warianty nie wymagają rozlewania zmian po systemie.
4. Porównaj 2-3 warianty. Dla każdego podaj koszt migracji, ryzyko operacyjne, testowalność, coupling i sposób wycofania.
5. Wybierz najmniejszą wystarczającą architekturę. Abstrakcja musi usuwać realną złożoność albo odpowiadać istniejącemu wzorcowi repozytorium.
6. Rozbij wdrożenie na pionowe, obserwowalne kroki, z testem publicznego zachowania po każdym kroku.
7. Po implementacji sprawdź, czy nowa granica faktycznie zawiera zmianę i nie stworzyła równoległego źródła prawdy.

## Twarde zasady

- Nie rób refaktoru „przy okazji”.
- Nie twórz generycznego frameworka dla jednego przypadku.
- Nie testuj prywatnej implementacji, jeśli można przetestować publiczne zachowanie.
- Migracje danych, API i uprawnień muszą mieć kompatybilność wsteczną albo jawny plan przejścia.
- Dla pracy produkcyjnej połącz ten skill z `new-task`, `test-first-engineering` i właściwym QA.

## Weryfikacja dowodowa architektury (architecture_evidence.py)

Dla istotnych granic modułów i publicznych kontraktów generuj weryfikowalne diagramy Mermaid oparte na dowodach w kodzie (`scripts/architecture_evidence.py`):
1. **Przypięty commit Git**: dowody weryfikowane są przez `git show <commit>:<sciezka>` w ukrytym podprocesie (`CREATE_NO_WINDOW`), nigdy na mutowalnym drzewie roboczym.
2. **Ścisłe cytowania**: deklaruj bezpieczne ścieżki repo-relative, ograniczone 1-indeksowane zakresy linii (maks. 500) i dokładne cytaty.
3. **Deterministyczny Mermaid z ucieczką etykiet**: znaki specjalne (`"`, `<`, `>`, `[`, `]`, `(`, `)`) są encjowane, a relacje znakowane statusem `[review req]`.
4. **Atomowa publikacja**: diagram `.mmd` publikowany jest dopiero po przejściu 100% walidacji; wcześniejszy poprawny plik przetrwa błąd walidacji.

Polecenia CLI:
```bash
# Walidacja manifestu JSON względem repozytorium Git
python -B scripts/architecture_evidence.py validate manifest.json --repo . --diagnostics diag.json

# Walidacja i atomowe wygenerowanie diagramu Mermaid
python -B scripts/architecture_evidence.py render manifest.json --output arch.mmd --repo .
```

### Granica zapewnień (Assurance Boundary)
- Walidacja kodu potwierdza wyłącznie, że wskazany plik, zakres linii i cytat istnieją w niezmiennym obiekcie commita Git.
- Walidacja NIE stanowi dowodu semantycznego: nie poświadcza prawdziwości asercji relacyjnych, logiki biznesowej ani braku pominiętych zależności.
- Wszelkie asercje relacji semantycznych pozostają jawnie `REVIEW_REQUIRED` (wymagają przeglądu architekta).

Szablon decyzji znajduje się w `references/architecture-contract.md`, granice
aktywacji w `references/trigger-cases.json`, a format dowodów Mermaid w
`../creating-mermaid-diagrams/reference/code-evidence.md`.
Pliki w paczce (6)
  • SKILL.md 4 KB
  • agents/openai.yaml 1 KB
  • references/architecture-contract.md 1 KB
  • references/trigger-cases.json 1 KB
  • scripts/architecture_evidence.py 25 KB
  • scripts/test_architecture_evidence.py 26 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · PapeMati98/Ai-Stack100Apache-2.0
wondelai/skills87MIT

Migawka bazy z 13.11.2026 · wersja paczki 71e70ce85ee0 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100software-architecture
    Projektuje, rozwija i przegląda architekturę oprogramowania: granice modułów, modele domeny, kontrakty i odpowiedzialność za dane.
  • 100architecture
    Projektuje architekturę złożonych funkcji przed implementacją i pomaga przy decyzjach systemowych obejmujących wiele modułów.
  • 90review-architecture
    Ocenia strukturalną jakość kodu w diffie, granice nowych modułów i architekturę całej bazy kodu.
  • 100go-architecture-review
    Recenzuje architekturę projektu Go: struktura pakietów, kierunek zależności, warstwy, podział odpowiedzialności, modelowanie domeny i granice modułów, w tym rozbijanie monolitów.
  • 100api-and-interface-design
    Wskazuje, jak projektować stabilne API, granice modułów i publiczne interfejsy: endpointy REST i GraphQL, kontrakty typów oraz podział frontend i backend.
  • 100arch-review
    Przegląda architekturę istniejącego kodu Java lub Spring Boot: granice architektury czystej i heksagonalnej, granice modułów, kierunek zależności, wyciek domeny, granice transakcji i logikę biznesową w kontrolerach.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.