Przejdź do treści
Biblioteka skilli
Programowanie · Pisanie

adr

/adr

Generuje Architecture Decision Records, gdy trzeba udokumentować decyzję, zapisać powody wyboru rozwiązania lub uchwycić uzasadnienie architektoniczne.

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

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

Generuje Architecture Decision Records, gdy trzeba udokumentować decyzję, zapisać powody wyboru rozwiązania lub uchwycić uzasadnienie architektoniczne.

Oryginalny opis (EN)

Generate Architecture Decision Records — use when asked to document a decision, create an ADR, record why we chose X, or capture architectural rationale.

Jak działa

  1. Step 1: Gather Context
  2. Step 2: Check Existing ADRs
  3. Step 3: Write the ADR
  4. Rules
Sekcje z nagłówków SKILL.md, w oryginale · 60 linii, 278 słów
Podgląd SKILL.md
---
name: adr
description: Generate Architecture Decision Records — use when asked to document a decision, create an ADR, record why we chose X, or capture architectural rationale.
---

# ADR — Architecture Decision Record

Capture the *why* behind architectural decisions so future-you (and future-agents) don't reverse them without context.

## Step 1: Gather Context

Identify:
- What decision was made (or needs to be made)
- What alternatives were considered
- What constraints drove the choice
- What the consequences are

If the user hasn't specified, ask one question: "What decision are you documenting?"

## Step 2: Check Existing ADRs

```bash
mkdir -p .devkit/docs/adr
ls .devkit/docs/adr/ 2>/dev/null | grep -oE '^[0-9]+' | sort -n | tail -1
```

Add 1 to the highest number found, zero-padded to 4 digits. If no output, the directory is empty — start at `0001`.

## Step 3: Write the ADR

Create `.devkit/docs/adr/NNNN-short-title.md`:

```markdown
# NNNN. Short Decision Title

**Date:** YYYY-MM-DD
**Status:** accepted | proposed | deprecated | superseded by [NNNN]

## Context

What is the issue? What forces are at play? 2-4 sentences max.

## Decision

What did we decide? State it directly. 1-3 sentences.

## Alternatives Considered

- **Alternative A** — why rejected (1 line)
- **Alternative B** — why rejected (1 line)

## Consequences

What follows from this decision? Both positive and negative. Bullet list.
```

## Rules

- Keep it short. An ADR is a reference, not an essay. Under 200 words total.
- One decision per ADR. If there are two decisions, write two ADRs.
- Use plain language. No jargon that requires context to parse.
- Status is usually `accepted`. Use `proposed` only if the user hasn't decided yet.
- Never modify the substantive content of existing ADRs (Context, Decision, Alternatives, Consequences). When superseding, only update the old ADR's Status line to `superseded by [MMMM]`.

Wersje

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

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

  • 80decision-record
    Pisze zapis decyzji architektonicznej (ADR), gdy użytkownik chce zapisać decyzję albo uchwycić, że coś postanowiono.
  • 100create-adr
    Tworzy Architecture Decision Record dokumentujący decyzję techniczną i uzasadnienie wyboru podejścia.
  • 100create-adr
    Tworzy ADR z opisem istotnych decyzji architektonicznych i ich uzasadnieniem, by przyszli członkowie zespołu rozumieli powody wyboru.
  • 100adr-writer
    Generuje rekordy decyzji architektonicznych dla istotnych decyzji technicznych, gdy trzeba zapisać wybór architektoniczny i powody, dla których go dokonano.
  • 100architecture-decision-records-adr-authoring
    Dokumentuje kluczowe decyzje techniczne w rekordach ADR, opisując kontekst, kompromisy i uzasadnienie wyboru.
  • 80cmk:adr
    Zapisuje decyzje architektoniczne w ADR: wybór bazy, protokołu lub wzorca infrastruktury oraz ich aktualizacje.

Uwagi i zgłoszenia

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