Przejdź do treści
Biblioteka skilli
Programowanie · Pisanie

decision

/decision

Zapisuje decyzję architektoniczną w formie ADR przy ważnych wyborach technologicznych i zmianach konwencji.

Repozytorium
claude-kit ↗
Licencja
MIT
Ostatnia zmiana repozytorium
07.09.2026

Ocena i bezpieczeństwo

90/ 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ść25 / 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
0
Przestarzałość

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

Zapisuje decyzję architektoniczną w formie ADR przy ważnych wyborach technologicznych i zmianach konwencji.

Oryginalny opis (EN)

Record an architecture decision as an ADR. Use when making significant technology choices, pattern adoptions, or convention changes.

Jak działa

  1. Steps
  2. Guidelines
Sekcje z nagłówków SKILL.md, w oryginale · 42 linii, 343 słów
Podgląd SKILL.md
---
name: decision
description: Record an architecture decision as an ADR. Use when making significant technology choices, pattern adoptions, or convention changes.
---

Record an architecture decision as an ADR. The user will describe the decision as: the invocation request

## Steps

1. **Read the ADR index**: Read `docs/architecture/decisions/README.md` to find the next available number (look at the last row in the Index table, increment by 1).

2. **Read the template**: Read the [ADR template](adr-template.md) for the output structure.

3. **Generate the slug**: Convert the title argument to a slug (e.g., "Temporal over Celery" → "temporal-over-celery"). Lowercase, hyphens, no special characters.

4. **Gather context**: Based on the decision topic, explore the codebase to understand:
   - What exists today (current state)
   - What alternatives were considered or could be considered
   - What the trade-offs are

5. **Write the ADR**: Create `docs/architecture/decisions/NNNN-{slug}.md` following the template. Fill in:
   - **Status**: `Proposed` for new decisions (the team must accept it)
   - **Date**: today's date
   - **Context**: the problem or force that motivates the decision
   - **Decision**: what is being decided
   - **Alternatives Considered**: at least 2 alternatives with pros/cons
   - **Consequences**: at least 1 positive, 1 negative, and optionally neutral

6. **Update the index**: Add a new row to the Index table in `docs/architecture/decisions/README.md`.

7. **Commit**: Stage both files and commit with message: `adr: add NNNN — {Title}`

8. **Summarize**: Tell the user:
   - The ADR number and file path
   - A brief summary of what was recorded
   - Suggest they review it and change status to `Accepted` once the team agrees

## Guidelines

- ADRs record decisions, not implementations — focus on *why*, not *how*
- Keep ADRs concise — 40-80 lines is ideal
- If a decision supersedes a previous ADR, update the old ADR's status to `Superseded by [NNNN]`
- Don't create ADRs for trivial decisions (library version bumps, minor refactors, bug fixes)
- When unsure whether something deserves an ADR, err on the side of recording it — it's easier to delete than to reconstruct rationale later
- For an existing codebase with no recorded decisions, backfill in batch first — see "Retroactive Backfill" in the `documentation-and-adrs` skill; the template's "Reconstructed from" line marks back-filled ADRs
Pliki w paczce (3)
  • SKILL.md 2 KB
  • adr-template.md 1 KB
  • agents/openai.yaml 1 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · ajyadav013/claude-kit90MIT
eliyce/paqad-ai100MIT
foxrun-ai/foxrun100MIT
randroids-dojo/skills90MIT
ajyadav013/claude-kit90MIT
researai/deepscientist90Apache-2.0

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

  • 86adr
    Zapisuje decyzję architektoniczną jako krótki ADR w docs/adr i dodaje ją do indeksu architektury.
  • 100adr
    Zapisuje decyzję architektoniczną jako ADR i wyjaśnia, dlaczego wybrano daną technologię, model danych, granicę lub wzorzec zamiast alternatyw.
  • 100adr-write
    Zapisuje pojedynczą decyzję architektoniczną jako numerowany ADR po zatwierdzeniu przez użytkownika, także gdy zapadła w trakcie implementacji.
  • 90adr
    Zapisuje decyzję architektoniczną jako numerowany ADR w docs/adr, z kontekstem, alternatywami i konsekwencjami.
  • 100adr
    Tworzy nowy Architecture Decision Record w formacie MADR, gdy trzeba udokumentować decyzję architektoniczną.
  • 90new-adr
    Zapisuje istotną decyzję architektoniczną w formacie MADR w docs/adrs i aktualizuje indeks, także przy zastępowaniu wcześniejszej 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.