Przejdź do treści
Biblioteka skilli
Programowanie · Pisanie

domain-modeling

/domain-modeling

Buduje model domeny projektu, gdy zmienia się terminologia, albo przy GLOSSARY.md i zapisie decyzji ADR.

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

Brak sygnałów. Repozytorium zmienione 10.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

Buduje model domeny projektu, gdy zmienia się terminologia, albo przy GLOSSARY.md i zapisie decyzji ADR.

Oryginalny opis (EN)

Build and sharpen a project's domain model. Use when discussing project terminology, writing or editing GLOSSARY.md, or recording or editing an ADR.

Jak działa

  1. File structure
  2. During the session
Sekcje z nagłówków SKILL.md, w oryginale · 71 linii, 452 słów
Podgląd SKILL.md
---
name: domain-modeling
description: Build and sharpen a project's domain model. Use when discussing project terminology, writing or editing GLOSSARY.md, or recording or editing an ADR.
---

# Domain Modeling

Actively build and sharpen the project's domain model while you design. This is the _active_ discipline: challenging terms, inventing edge-case scenarios, and writing the glossary and the decisions down the moment they crystallise. (Merely _reading_ `GLOSSARY.md` for vocabulary is not this skill: any skill does that in one line. This skill is for changing the model, not consuming it.)

## File structure

Most projects have a single context:

```
/
├── GLOSSARY.md
├── docs/
│   └── adr/
│       ├── 0001-event-sourced-orders.md
│       └── 0002-postgres-for-write-model.md
└── src/
```

If a `GLOSSARY-MAP.md` exists at the root, the project has several contexts, and the map points to where each one lives:

```
/
├── GLOSSARY-MAP.md
├── docs/
│   └── adr/                          ← system-wide decisions
├── src/
│   ├── ordering/
│   │   ├── GLOSSARY.md
│   │   └── docs/adr/                 ← context-specific decisions
│   └── billing/
│       ├── GLOSSARY.md
│       └── docs/adr/
```

Create files lazily, only when you have something to write: a `GLOSSARY.md` when the first term is resolved, `docs/adr/` when the first ADR is needed.

## During the session

### Challenge against the glossary

When the user uses a term that conflicts with the existing language in `GLOSSARY.md`, call it out immediately: "Your glossary defines 'cancellation' as X, but you seem to mean Y. Which is it?"

### Sharpen fuzzy language

When the user uses a vague or overloaded term, propose a precise canonical one: "You're saying 'account': do you mean the Customer or the User? Those are different things."

### Discuss concrete scenarios

When domain relationships are being discussed, stress-test them with specific scenarios. Invent scenarios that probe edge cases and force precision about the boundaries between concepts.

### Cross-reference with code

When the user states how something works, check whether the code agrees (`search_code`, `find_symbol`). Surface a contradiction: "Your code cancels entire Orders, but you just said partial cancellation is possible. Which is right?"

### Update GLOSSARY.md inline

When a term is resolved, update `GLOSSARY.md` right there with `edit_file` (or `write_file` for the first term). Capture terms as they happen; don't batch them. Use the format in [GLOSSARY-FORMAT.md](GLOSSARY-FORMAT.md) (in this skill's directory).

`GLOSSARY.md` holds no implementation details. It is not a spec, a scratch pad or a store of implementation decisions: it is a glossary and nothing else.

### Offer ADRs sparingly

Offer an ADR only when all three are true:

1. **Hard to reverse**: changing your mind later has a meaningful cost.
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 one was picked for specific reasons.

If any of the three is missing, skip the ADR. Use the format in [ADR-FORMAT.md](ADR-FORMAT.md).
Pliki w paczce (4)
  • ADR-FORMAT.md 3 KB
  • ATTRIBUTION.md 1 KB
  • GLOSSARY-FORMAT.md 2 KB
  • SKILL.md 3 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · gilzamir18/GilzaBots100MIT
matteocodogno/wellforge100MIT
hootener/brain100MIT
zenobi-us/dotfiles100MIT
JamalLyons/Agent-Skills100MIT
FrancoStino/opencode-skills-collection100MIT
yuan88964/RelayStudio100MIT
Aysnc-Labs/skills100MIT
askgina/plugins100Apache-2.0

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

Pobrania w ostatnich 30 dniach: 1 · ranking

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

Podobne skille

  • 95workflow-domain-modeling
    Buduje i wyostrza model dziedziny projektu: pilnuje terminologii w GLOSSARY.md i zapisuje decyzje architektoniczne w ADR.
  • 100s-domain-modeling
    Buduje i doprecyzowuje model domeny projektu: słownik pojęć w GLOSSARY.md oraz zapisy ADR przy zmianach terminów i reguł.
  • 100matt-domain-modeling
    Buduje i wyostrza glosariusz oraz model domeny projektu w pliku CLAUDE.md, a decyzje zapisuje jako ADR w docs/patterns.
  • 100ra-domain-modeling
    Buduje model domeny projektu: wspólny słownik, niezmienne reguły architektury i decyzje ADR, gdy terminy są niejednoznaczne.
  • 100domain-model
    Buduje i doszlifowuje model domeny projektu: język wszechobecny w CONTEXT.md, konteksty, agregaty, niezmienniki i model danych.
  • 100docs-domain-modeling
    Buduje model domenowy projektu: glosariusz CONTEXT.md i język ubikwitarny, gdy trzeba ustalić terminologię lub agent używa niewłaściwych słów.

Uwagi i zgłoszenia

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