Przejdź do treści
Biblioteka skilli
Programowanie · Planowanie

architect

/architect

Kształtuje architekturę projektu i zapisuje decyzje, w tym wybór stosu technologicznego, jako rekordy ADR w katalogu docs/adr.

Repozytorium
kataster ↗
Licencja
MIT
Ostatnia zmiana repozytorium
07.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
3
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

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

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Kształtuje architekturę projektu i zapisuje decyzje, w tym wybór stosu technologicznego, jako rekordy ADR w katalogu docs/adr.

Oryginalny opis (EN)

Build and sharpen the project's architecture and record decisions as ADRs in docs/adr/ (incl. the tech stack decision). Use when discussing architectural shape, integration between bounded contexts, technology choices, or when recording or editing an ADR.

Jak działa

  1. File structure
  2. During the session
Sekcje z nagłówków SKILL.md, w oryginale · 66 linii, 542 słów
Podgląd SKILL.md
---
name: architect
description: Build and sharpen the project's architecture and record decisions as ADRs in docs/adr/ (incl. the tech stack decision). Use when discussing architectural shape, integration between bounded contexts, technology choices, or when recording or editing an ADR.
---

# Architecture

Actively build and sharpen the architecture as you design. This is the *active* discipline: challenging decisions, inventing scenarios that stress them, and writing decisions down the moment they crystallise. (Merely *reading* ADRs for context is not this skill. This skill is for when you're changing the architecture, not just consuming it.)

Domain language (the glossary in `CONTEXT.md`), bounded contexts, aggregates and the logical data model belong to the `domain-model` skill. Architecture builds on them: the domain comes first, technology follows.

## File structure

```
/
├── CONTEXT.md                  ← glossary (domain-model skill)
└── docs/
    ├── adr/                    ← architecture decisions (this skill)
    │   ├── 0001-tech-stack.md
    │   └── 0002-...
    ├── architecture/
    │   └── data-model.md       ← logical data model (domain-model skill)
    └── domain/
        ├── context-map.md        ← target map
        ├── context-map.as-is.md  ← as-is snapshot, written only by /adopt
        ├── gap-register.md       ← as-is ↔ target gaps (generated rows + decisions)
        └── events.yaml
```

`docs/domain/context-map.md` is the target; `context-map.as-is.md` is the snapshot recovered by `/adopt`. Do not
write the as-is map from an architecture session – a target decision belongs in the target map.

Once code exists and contexts live in separate modules, context-specific decisions may move next to the code (`src/<context>/docs/adr/`); system-wide decisions stay in `docs/adr/`.

## During the session

### Challenge against existing decisions

When a proposal conflicts with an accepted ADR, call it out immediately: "ADR 0002 says reports work offline, but this assumes a live connection. Do we supersede 0002?" Accepted ADRs are never edited; they are superseded by a new one.

### Trace every decision back to a requirement

Architecture follows documented needs, not taste. Every decision cites its driving requirement with a path (`docs/product/vision.md`, `docs/domain/events.yaml`, a story, a hotspot). No documented requirement → no extra complexity. If the requirement is missing, it's a question for the user or a hotspot, not an assumption.

### Discuss concrete scenarios

Stress-test decisions with specific scenarios: "A field worker is in a basement without connectivity and wants to record a result – what happens?" "Two people close the same case at the same time." Force precision about the boundaries where the architecture could break.

### Cross-reference with docs and code

When the user states how something works, check `docs/` (and the code, once it exists) for agreement. Surface contradictions: "The data model has one owner per item, but you just said items can be lent with a second owner. Which is right?"

### Prefer the simplest architecture

The simplest architecture that meets the documented requirements is the default. Distributed systems, separate apps or microservices each need a concrete, documented requirement as justification.

### Offer ADRs sparingly

Only offer to create an ADR when all three are true:

1. **Hard to reverse**: the cost of changing your mind later is meaningful
2. **Surprising without context**: a future reader will wonder "why did they do it this way?"
3. **The result of a real trade-off**: there were genuine alternatives and you picked one for specific reasons

If any of the three is missing, skip the ADR. Use the format in [ADR-FORMAT.md](./ADR-FORMAT.md). New ADRs always start as `proposed`; **only the user sets `accepted`**.

### The tech stack decision

Decide only after the event storming and a rough domain model exist; before that the facts are missing. Follow [TECH-STACK.md](./TECH-STACK.md).
Pliki w paczce (3)
  • ADR-FORMAT.md 4 KB
  • SKILL.md 4 KB
  • TECH-STACK.md 2 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · hemi1986/kataster100MIT
Aghasi-Sargsyan/architect-skill100MIT
RIJUDEVx/agent-skills100MIT
wonsukchoi/domain-experts100MIT
chhoumann/t3-pstack100MIT
kriscard/Skills100MIT
arjitj2/open-pstack100MIT
backnotprop/pstack100MIT
painhardcore/pstack100MIT

Migawka bazy z 13.11.2026 · wersja paczki 9518c37d7791 (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

  • 100adr
    Czyta i zapisuje rekordy decyzji w docs/adr, gdy zapadają decyzje albo przed zmianami w obszarach objętych ADR.
  • 100decisions
    Zapisuje decyzje architektoniczne jako krótkie ADR w docs/adr i prowadzi słownik pojęć projektu w GLOSSARY.md.
  • 100adr
    Tworzy, przegląda i zarządza rekordami decyzji architektonicznych (ADR): automatyczna numeracja, wykrywanie szablonu, kontrola jakości i utrzymanie indeksu.
  • 84adr
    Tworzy i prowadzi rekordy decyzji architektonicznych, czyli ADR, gdy trzeba zapisać decyzję lub przygotować obsługę ADR w projekcie.
  • 87adr
    Zapisuje decyzje architektoniczne z bieżącej rozmowy jako rekordy ADR, gdy użytkownik chce je zarejestrować, zalogować lub zapisać.
  • 86adr
    Zapisuje decyzję architektoniczną jako krótki ADR w docs/adr i dodaje ją do indeksu architektury.

Uwagi i zgłoszenia

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