Przejdź do treści
Biblioteka skilli
Programowanie · Pisanie

decision-record

/decision-record

Pisze, zastępuje lub zmienia rekord decyzji architektonicznej (ADR) tak, aby późniejsze zmiany nie mogły go unieważnić.

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

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

Skrypty: scripts/check-adr.sh

Co robi i kiedy

Pisze, zastępuje lub zmienia rekord decyzji architektonicznej (ADR) tak, aby późniejsze zmiany nie mogły go unieważnić.

Oryginalny opis (EN)

Write, supersede or amend an architecture decision record (ADR) so that no later pivot can make it false. Use whenever a broad rule gets decided (an answered ticket, a council's road, a lasting law), whenever a decision a record holds is reversed or narrowed, and before editing any file in a repo's decision-record folder.

Jak działa

  1. Steps
Sekcje z nagłówków SKILL.md, w oryginale · 20 linii, 628 słów
Podgląd SKILL.md
---
name: decision-record
description: Write, supersede or amend an architecture decision record (ADR) so that no later pivot can make it false. Use whenever a broad rule gets decided (an answered ticket, a council's road, a lasting law), whenever a decision a record holds is reversed or narrowed, and before editing any file in a repo's decision-record folder.
---

# Decision record

> _What is written in the log was true on the day it was written, and stays true after._

A record is immutable, so it must be written to stay true whatever happens later. The format, the forces and the status lines are in [FORMAT.md](FORMAT.md). Read it before the first step.

The `adr-scope-hint` hook repeats the scope and the append-only rule when a record is edited. `docs/agents/domain.md` names the record folder and the format. When its `ADR format:` line names a repo template, write in that template and run step 5 with `--template`, which checks only the rules that hold in any shape. Every other value (`decision-record`, or the older `ADR-FORMAT.md` and `true-names`), or no line, means [FORMAT.md](FORMAT.md).

## Steps

1. **Test the scope.** State the rule in one sentence and name two later decisions it will govern. Check the three tests in FORMAT.md's Scope. When one fails, write the why as a comment at the code that builds it and stop. Done when the rule and its two governed decisions are written down, or the comment is.
2. **Find the records it touches.** List the record folder and read every record whose title or forces cover the same ground, and every record in another repo the agent file points at. A record it reverses gets superseded in step 6. A record it adds to gets amended there. Done when each touched record is named as superseded, amended or untouched.
3. **Name the forces.** Write each outside limit the rule rests on as a dated, past-tense `- F<n>: ` line, with its source read this session (a measurement, a doc, a ticket comment). A preference or a plan is not a force. When the rule supersedes a record, one force says what changed in the old record's force. Done when every force has a date and a source you read.
4. **Write the record.** Number and name it as FORMAT.md's Shape says. Open the Decision with `While` and the forces it rests on. Give the Consequences, with the option turned down and each break the rule causes: a stored form, a public call or a file layout that changes, with its migration or the words `No migration:` and who that leaves behind. Name the Guard: the test, lint, CI step or hook that fails on drift. When the repo has none and one fits in this effort, build it now (the found-work rule). A real check's failure message or header comment names the record number, so a reader who trips it finds the why. Otherwise write `Review only.` Done when the file is on disk and a named check's text holds the record number.
5. **Check it.** Run `bash scripts/check-adr.sh <record>` from this skill's folder on the new record and on each record step 6 touches. With a repo template, run `bash scripts/check-adr.sh --template <record>` instead. Done when it exits 0.
6. **Mark the old records.** Append one line to the Status of each record from step 2: `Superseded by ADR-NNNN on YYYY-MM-DD: F<n> no longer holds.` or `Amended by ADR-NNNN on YYYY-MM-DD.` An older-shape record takes `Superseded by ADR-NNNN.` as its last line instead. Change nothing else in it. Restate no record's rule in an agent file, README or doc: a copy drifts from the record. Point at the record by number instead ("Money rules: ADR-0002."). No hook backs this yet: telling a restatement from a pointer needs judgement. Then run `plot-twist` with the old rule, so tickets, docs and agent files stop citing it, unless `plot-twist` started this run. Done when `git diff` on each old record shows one added line and nothing removed, and every other file this effort touched names the rule only by record number.

Charter: C3, C4, C8 ([CHARTER.md](../../CHARTER.md)).
Pliki w paczce (3)
  • FORMAT.md 5 KB
  • SKILL.md 4 KB
  • scripts/check-adr.sh 4 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · vickydotbat/vicky-skills90MIT
event4u-app/agent-config100MIT
Fili999/ai-hub100MIT
SHOTClubhouse/shotos100MIT
scratchpad-sh/skills100MIT
JordzPope/claude-skills-hiring-interviews100MIT
donald-ada/workinggenius100MIT
bmad-code-org/BMAD-METHOD80MIT

Migawka bazy z 13.11.2026 · wersja paczki fedc89db5e0e (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
    Pisze lub zastępuje rekord decyzji architektonicznej, zwykle przy decyzji trudnej do odwrócenia.
  • 100adr
    Pisze lub aktualizuje rekord decyzji architektonicznej w docs/decisions: numerację, nagłówek, zastępowanie i indeks.
  • 100adr-writer
    Pisze rekord decyzji architektonicznej w Markdownie, gdy użytkownik prosi o ADR, decyzję techniczną albo jej udokumentowanie.
  • 100adr-author
    Pisze lub zmienia rekord decyzji architektonicznej, który nazywa konkretne moduły, funkcje i ustawienia, i sprawdza go przed zapisem.
  • 100adr
    Pisze lub ocenia rekord decyzji architektonicznej dla serwisu: kontekst, kryteria, opcje, decyzję i konsekwencje.
  • 100recording-architecture-decisions
    Tworzy, aktualizuje, zastępuje i ocenia ADR oraz dziennik decyzji architektonicznych, w tym synchronizację bazową po zmianach architektury.

Uwagi i zgłoszenia

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