Przejdź do treści
Biblioteka skilli
Programowanie · Pisanie

adr

/adr

Pisze Architecture Decision Record jako jeden numerowany plik w docs/adr/ z kontekstem, rozważanymi opcjami i wyborem, gdy trzeba udokumentować wybór technologii lub zapisać, dlaczego wybrano X.

Repozytorium
ai-workflow ↗
Licencja
MIT
Ostatnia zmiana repozytorium
22.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 22.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

Pisze Architecture Decision Record jako jeden numerowany plik w docs/adr/ z kontekstem, rozważanymi opcjami i wyborem, gdy trzeba udokumentować wybór technologii lub zapisać, dlaczego wybrano X.

Wyzwalacze z opisu

write an ADRrecord why we picked Xdocument this decision

Argumenty

/adr [title]
Oryginalny opis (EN)

Write an Architecture Decision Record — one numbered file in docs/adr/ with context, options considered and the choice. Use when the user says 'write an ADR', 'record why we picked X', 'document this decision', or has just made a technical choice future contributors will question. Not for whole-system design (use /wf:architecture).

Jak działa

  1. Context Gathering
  2. Interview
  3. Write
  4. After Writing
Sekcje z nagłówków SKILL.md, w oryginale · 65 linii, 369 słów
Podgląd SKILL.md
---
name: adr
description: "Write an Architecture Decision Record — one numbered file in docs/adr/ with context, options considered and the choice. Use when the user says 'write an ADR', 'record why we picked X', 'document this decision', or has just made a technical choice future contributors will question. Not for whole-system design (use /wf:architecture)."
argument-hint: "[title]"
---
Create an Architecture Decision Record. Argument: $ARGUMENTS

## Context Gathering

1. Find the ADR directory (default `docs/adr/`; use the existing one if the repo has `docs/decisions/` or similar) and take the next number, zero-padded to the existing width, starting at `0001`.
2. Read recent ADRs (last 2-3) to match the project's style and voice.
3. If the decision relates to architecture, read `docs/ARCHITECTURE.md` for context.
4. If this decision replaces an earlier ADR, set the old one's status to `Superseded by ADR-NNNN` and link it in Related.

## Interview

Use AskUserQuestion to extract the decision. Keep it focused — an ADR is one decision, not a design doc. If the decision was just made in this session, draft from the conversation and ask only for what is missing.

1. **What's the decision?** — What are you deciding? What triggered this decision?
2. **Context** — What constraints, requirements, or pressures led to this? What's the current state?
3. **Options considered** — What alternatives did you evaluate? What are the tradeoffs of each?
4. **Decision** — What did you choose and why? What was the deciding factor?
5. **Consequences** — What changes as a result? What are the known downsides you're accepting?

If the decision is straightforward (user already knows what they want and why), keep the interview to 1-2 questions to fill in gaps. If the user is asking you to decide, present the options and a recommendation before writing.

## Write

Write to `docs/adr/NNNN-<slug>.md`:

```markdown
# ADR-NNNN: [Title]

**Status:** Proposed | Accepted | Deprecated | Superseded by [ADR-XXXX]
**Date:** [date]
**Deciders:** [the user plus anyone they name; if unnamed, `git config user.name`]

## Context

[What is the issue? What forces are at play? What constraints exist?]

## Decision

[What was decided. State it clearly in one sentence, then elaborate if needed.]

## Options Considered

### Option A: [Name]
- **Pros:** [benefits]
- **Cons:** [drawbacks]

(Repeat per option, at least two.)

## Consequences

### Positive
- [What improves]

### Negative
- [What gets harder or what risks are accepted]

## Related

- [Links to related ADRs, specs, issues, or documents]
```

## After Writing

Present the ADR for review. Status is `Proposed` unless the user said the decision is made.

Wersje

RepozytoriumWynikLicencja
Ta strona · rafagomes/ai-workflow100MIT
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 3ec4845cba84 (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-author
    Pisze ADR z kontekstem, rozważanymi opcjami i kompromisami, wybraną decyzją i konsekwencjami, np. dla wyboru bazy danych czy frameworku.
  • 100docs-adr
    Tworzy numerowany Architecture Decision Record dokumentujący decyzję techniczną z kontekstem, alternatywami i konsekwencjami.
  • 100adr-writing
    Pisze ADR, na podstawie którego przyszły inżynier może działać: numerowany, niezmienny zapis z kontekstem, rozważanymi opcjami, decyzją w jednym zdaniu i konsekwencjami, wraz z zastępowaniem i indeksem.
  • 100to-adr
    Zapisuje Architecture Decision Record w 1 do 3 zdaniach: co zdecydowano i dlaczego.
  • 90architecture-decision-record
    Dokumentuje istotną decyzję techniczną z kontekstem, alternatywami, konsekwencjami i statusem, jako rejestr decyzji architektonicznych (ADR).
  • 100adr-write
    Zapisuje pojedynczą decyzję architektoniczną jako numerowany ADR po zatwierdzeniu przez użytkownika, także gdy zapadła w trakcie implementacji.

Uwagi i zgłoszenia

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