Programowanie · Pisanie
decision
/decision
Zapisuje decyzję architektoniczną w formie ADR przy ważnych wyborach technologicznych i zmianach konwencji.
- Autor
- ajyadav013 ↗
- 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
- Steps
- 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
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · ajyadav013/claude-kit | 90 | MIT |
| eliyce/paqad-ai | 100 | MIT |
| foxrun-ai/foxrun | 100 | MIT |
| randroids-dojo/skills | 90 | MIT |
| ajyadav013/claude-kit | 90 | MIT |
| researai/deepscientist | 90 | Apache-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.