decision-record
/decision-record
Pisze, zastępuje lub zmienia rekord decyzji architektonicznej (ADR) tak, aby późniejsze zmiany nie mogły go unieważnić.
- Autor
- vickydotbat ↗
- Repozytorium
- vicky-skills ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 13.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 3
- Skrypty
- 1
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 13.11.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
- 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
- Steps
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
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · vickydotbat/vicky-skills | 90 | MIT |
| event4u-app/agent-config | 100 | MIT |
| Fili999/ai-hub | 100 | MIT |
| SHOTClubhouse/shotos | 100 | MIT |
| scratchpad-sh/skills | 100 | MIT |
| JordzPope/claude-skills-hiring-interviews | 100 | MIT |
| donald-ada/workinggenius | 100 | MIT |
| bmad-code-org/BMAD-METHOD | 80 | MIT |
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.