Przejdź do treści
Biblioteka skilli
Programowanie · Przegląd i audyt

domain-modeling

/domain-modeling

Pilnuje, by słownictwo i rekordy decyzji projektu były rzetelne: sprawdza przeciążone terminy w kodzie i zapisuje kanoniczne nazwy.

Repozytorium
claude-toolkit ↗
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
3
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
1
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

Pilnuje, by słownictwo i rekordy decyzji projektu były rzetelne: sprawdza przeciążone terminy w kodzie i zapisuje kanoniczne nazwy.

Oryginalny opis (EN)

Keeps a project's vocabulary and decision records honest by challenging overloaded terms against the code and recording canonical terms and hard-to-reverse decisions where the repo already keeps them. Use when a term, status, or field means two things, when naming a new concept or state, or when editing a glossary, GLOSSARY.md, or ADR. Do NOT use to interview the user about a plan (use grill-me) or to write a design doc.

Jak działa

  1. 1. Find the home (REQUIRED)
  2. 2. Sharpen the language
  3. 3. Record
  4. Notes
Sekcje z nagłówków SKILL.md, w oryginale · 39 linii, 328 słów
Podgląd SKILL.md
---
name: domain-modeling
description: Keeps a project's vocabulary and decision records honest by challenging overloaded terms against the code and recording canonical terms and hard-to-reverse decisions where the repo already keeps them. Use when a term, status, or field means two things, when naming a new concept or state, or when editing a glossary, GLOSSARY.md, or ADR. Do NOT use to interview the user about a plan (use grill-me) or to write a design doc.
---

# domain-modeling

Give each term one meaning, check that meaning against the code, and record it in the repo's existing home.

## 1. Find the home (REQUIRED)

1. Read the repo's agent guide (`AGENTS.md`, `CLAUDE.md`) for where docs live.
2. Search for an existing glossary and decision record:
   ```bash
   rg -n -i '^#+ .*(glossary|vocabulary|terminology)' -g '*.md'
   fd -H 'GLOSSARY(-MAP)?\.md|^adr$'
   ```
   Numbered decisions in design docs (`D1.`, `**D3.**`) are a decision record too.
3. Use the home you found, in its format. Create `GLOSSARY.md` or `docs/adr/` only when none exists: lazily, in the docs location the guide names.

Done when you can name the one place each new term and decision goes.

## 2. Sharpen the language

- **Probe each suspect term:** ask what it means to each reader (the code that writes it, each code path that reads it, the user). Two answers mean two concepts: propose a name for each.
- **Check the code:** when someone states how a term behaves, find the `path:line` that agrees or contradicts, and surface a contradiction at once.
- **Test the boundary** with one concrete scenario: "a `failed` row that later becomes `deleted`: is `failed` terminal?"
- **Ask naming choices as decisions.** When the canonical name is the user's call, ask it in a grill-me round.
- **Record each term when it resolves.** Do not batch them.

Done when every term the current decision uses has one recorded meaning, with its aliases under `_Avoid_`.

## 3. Record

- **Terms:** [GLOSSARY-FORMAT.md](GLOSSARY-FORMAT.md) for a new glossary. An existing glossary keeps its format.
- **Decisions:** only when hard to reverse, surprising without context, and a real tradeoff. Use [ADR-FORMAT.md](ADR-FORMAT.md), or the repo's own decision format.
- A status value is a term: define the one fact it records. If two writers set it for different reasons, it names two concepts.

## Notes

- A glossary holds terms, not specs, status, or plans.
- Ported from [mattpocock/skills](https://github.com/mattpocock/skills) (MIT), adapted to this repo's conventions and voice.
Pliki w paczce (3)
  • ADR-FORMAT.md 1 KB
  • GLOSSARY-FORMAT.md 2 KB
  • SKILL.md 2 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · wilbeibi/claude-toolkit100MIT
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 4e97ededbfad (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

  • 95workflow-domain-modeling
    Buduje i wyostrza model dziedziny projektu: pilnuje terminologii w GLOSSARY.md i zapisuje decyzje architektoniczne w ADR.
  • 100decisions
    Zapisuje decyzje architektoniczne jako krótkie ADR w docs/adr i prowadzi słownik pojęć projektu w GLOSSARY.md.
  • 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.
  • 100setting-up-domain-model
    Zakłada konwencje repozytorium bez CONTEXT.md: słownik pojęć, rozstrzyganie terminów używanych na dwa sposoby i zapis trudnych do odwrócenia decyzji, na przykład jako ADR.
  • 100glossary
    Prowadzi kanoniczne rejestry słownictwa repozytorium: .glossary/TERMS.md dla rzeczowników domeny i .glossary/LANGUAGE.md dla słownictwa 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.