Przejdź do treści
Biblioteka skilli
Programowanie · Pisanie

adr

/adr

Pisze, przegląda i zastępuje rekordy decyzji architektonicznych, a potem sprawdza je linterem i budowaniem indeksu.

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

Brak sygnałów. Repozytorium zmienione 12.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 sprawdzić przed instalacją
  • 2 skrypty w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: scripts/adr.mjs, scripts/lib.mjs

Co robi i kiedy

Pisze, przegląda i zastępuje rekordy decyzji architektonicznych, a potem sprawdza je linterem i budowaniem indeksu.

Oryginalny opis (EN)

Use to write, review, supersede or index Architecture Decision Records (ADRs) in a repository. Interviews for the context and real alternatives, drafts a short decision record with honest consequences, and runs a bundled linter and index builder so the decision log stays consistent.

Jak działa

  1. Ground rules
  2. When to write one
  3. Steps
  4. The lifecycle
  5. Tools
Sekcje z nagłówków SKILL.md, w oryginale · 49 linii, 596 słów
Podgląd SKILL.md
---
name: adr
description: Use to write, review, supersede or index Architecture Decision Records (ADRs) in a repository. Interviews for the context and real alternatives, drafts a short decision record with honest consequences, and runs a bundled linter and index builder so the decision log stays consistent.
---

# Architecture decision records

An ADR records one significant decision, why it was made, and what it costs. Done well, it saves the next engineer from re-arguing the decision or undoing it by accident. Done badly, it is a justification written after the fact. This skill produces the first kind, and a bundled script checks the structure so the log stays trustworthy.

Read this file first. Open the references only when a step tells you to.

## Ground rules

1. Record decisions, not designs. An ADR answers "why this and not that", not "how does it work".
2. Two real options at least. A decision with one option is an announcement. List the alternatives that were actually considered and the honest reason each was not chosen.
3. Consequences include the bad. Every decision has a cost. If you cannot name one, you have not understood the decision yet.
4. Facts in Context, judgement in Decision. Do not smuggle the conclusion into the background.
5. Accepted ADRs are not rewritten. Their status and links may change; their reasoning does not. To change a decision, supersede it with a new ADR.
6. Never invent facts, figures, dates or people. If the person has not told you the context or the numbers, ask, or leave the point out and say so.
7. Do not put secrets, personal data or customer names in an ADR. It will be committed.

## When to write one

Open [references/when-to-write.md](references/when-to-write.md). In short: write an ADR when a decision is hard to reverse, affects more than one team, changes cost, security or compliance, or when someone will ask "why did we do it this way" in a year.

## Steps

1. Find the decision log. Look for `docs/adr`, `doc/adr`, `adr`, `docs/decisions` or `decisions`. If there is none, ask before creating one and suggest `docs/adr`.
2. Read what exists. Run `node {{SCRIPTS}}/adr.mjs lint <dir>` and read the accepted ADRs that touch the same area. A new decision must not silently contradict an accepted one; if it does, it is a supersession.
3. Interview. Ask, one question at a time, for: the situation and what changed; the forces and constraints; the options actually considered; who decides; and when it should be revisited. Do not draft until you have at least two real options.
4. Create the file with `node {{SCRIPTS}}/adr.mjs new <dir> "Short title in the imperative"`, or `supersede <dir> <number> "New title"` when replacing a decision. This numbers the file, fills the template and, for a supersession, updates both records.
5. Write it, following [references/writing-guide.md](references/writing-guide.md). Replace every placeholder. Keep the Decision to a few active sentences that name the chosen option.
6. Set the status honestly: `proposed` until the deciders agree, then `node {{SCRIPTS}}/adr.mjs status <dir> <number> accepted`.
7. Lint and index. Run `node {{SCRIPTS}}/adr.mjs lint <dir>` until it reports no errors, then `node {{SCRIPTS}}/adr.mjs index <dir> --out <dir>/README.md`.
8. Report what you wrote, any facts you were not given, and any accepted ADR the new one touches.

## The lifecycle

Statuses are `proposed`, `accepted`, `rejected`, `deprecated` and `superseded`. See [references/lifecycle.md](references/lifecycle.md) for what each means and how supersession is linked.

## Tools

```text
node {{SCRIPTS}}/adr.mjs new <dir> "Title"
node {{SCRIPTS}}/adr.mjs supersede <dir> <number> "New title"
node {{SCRIPTS}}/adr.mjs status <dir> <number> <proposed|accepted|rejected|deprecated>
node {{SCRIPTS}}/adr.mjs lint <dir> [--strict] [--json]
node {{SCRIPTS}}/adr.mjs index <dir> --out <dir>/README.md
node {{SCRIPTS}}/adr.mjs rules
```

The linter checks structure, not truth. It cannot tell whether the reasoning is sound; that is for the people who decide. The rule list is in [references/lint-rules.md](references/lint-rules.md), and [references/good-and-bad.md](references/good-and-bad.md) shows what separates a useful record from a weak one.
Pliki w paczce (10)
  • SKILL.md 4 KB
  • core.md 2 KB
  • references/good-and-bad.md 1 KB
  • references/lifecycle.md 1 KB
  • references/lint-rules.md 2 KB
  • references/when-to-write.md 1 KB
  • references/writing-guide.md 2 KB
  • scripts/adr.mjs 6 KB
  • scripts/lib.mjs 10 KB
  • scripts/rules.json 2 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · pJijesh/adr-skill100MIT
maximiliancw/adrinaline100MIT
zazencodes/skills100MIT
vindotski/spotcraft100Apache-2.0
me-cedric/Shipyard100MIT
musingfox/cc-plugins100MIT
joestump/claude-plugin-sdd100MIT
kaisa-kucherenko/claude-code-flow100MIT
nguyengiavu/ngvu-factory100MIT

Migawka bazy z 13.11.2026 · wersja paczki 25ba58f49a30 (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-writer
    Generuje rekordy decyzji architektonicznych z kontekstem, uzasadnieniem, alternatywami i konsekwencjami w numerowanym formacie ze śledzeniem statusu.
  • 100recording-architecture-decisions
    Tworzy, aktualizuje, zastępuje i ocenia ADR oraz dziennik decyzji architektonicznych, w tym synchronizację bazową po zmianach architektury.
  • 100adr-writer
    Pisze lub zastępuje rekord decyzji architektonicznej, zwykle przy decyzji trudnej do odwrócenia.
  • 100architecture-decision-record
    Dostarcza szablony ADR w formacie Nygarda z kontekstem, decyzją, konsekwencjami i alternatywami do zapisu decyzji architektonicznych.
  • 90architecture-decision-record
    Dokumentuje istotną decyzję techniczną z kontekstem, alternatywami, konsekwencjami i statusem, jako rejestr decyzji architektonicznych (ADR).
  • 100arc42-chapter-09-architecture-decisions
    Pisze rekordy decyzji architektonicznych ADR według rozdziału 9 arc42, z uzasadnieniem i konsekwencjami każdej decyzji.

Uwagi i zgłoszenia

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