Developer · FREE

ADR krótki

Z sporu 'która opcja' robi jednostronicowy Architecture Decision Record: kontekst, opcje, decyzja, konsekwencje. Kopiujesz do docs/adr. Używaj, gdy zespół kręci się w kółko na czacie, nie gdy trzeba napisać kod.

reviewed:

Jak zainstalować

  1. Uzupełnij pola poniżej (albo zostaw nazwy zmiennych i dopisz w czacie). Wartości z Skill creatora na liście podstawiają się same.
  2. Kopiuj, potem wklej w Claude.ai (instrukcje projektu) albo ChatGPT (Custom Instructions).
  3. Albo pobierz SKILL.md i połóż w folderze skilli Claude Code.
SKILL
Problem: [PROBLEM]. Opcje na stole: [OPCJE].

NIE PISZ KODU. Jeśli [OPCJE] ma mniej niż 2 pozycje - dopytaj o drugą i stop.

Format:

# ADR: tytuł w 6 słowach
Status: proponowane
Data: [DO UZUPEŁNIENIA]

## Kontekst
max 5 zdań, fakty nie nastrój

## Opcje
dla każdej: działa gdy / psuje się gdy / koszt utrzymania (1 linia)

## Decyzja
jedna opcja + 2 zdania dlaczego nie pozostałe

## Konsekwencje
- zysk
- dług
- co trzeba zrobić w ciągu 14 dni, żeby decyzja nie była papierowa

Nie dodawaj opcji, której nie ma w [OPCJE], chyba że oznaczysz ją jako "dorzucona, do akceptacji". Dywiz "-".

Zanim wkleisz

Skill vs zły prompt

Zły prompt

Powiedz, który stack jest najlepszy, mikroserwisy czy monolit, best practices.

Skill

Problem: [PROBLEM]. Opcje na stole: [OPCJE].

NIE PISZ KODU. Jeśli [OPCJE] ma mniej niż 2 pozycje - dopytaj o drugą i stop.

Format:

# ADR: tytuł w 6 słowach
Status: proponowane

Użyj z tym narzędziem

Lekcja: claude-start-06-claude-dla-programisty

Pytania

Jak użyć skilla "ADR krótki" w Claude?

Uzupełnij pola w nawiasach (albo weź je z profilu Skill creator na /skille), kliknij Kopiuj i wklej treść do instrukcji projektu w Claude.ai. W Claude Code kliknij Pobierz SKILL.md i połóż plik w folderze skilli. Skill działa też w ChatGPT (Custom Instructions). Nie chowa się za paywallem: kopia jest darmowa.

Kiedy tego skilla NIE używać?

Nie do wyboru dostawcy pod umowę (to zakup, nie ADR) i nie do usprawiedliwiania decyzji podjętej wczoraj bez opcji.