Developer · FREE

Raport bramek

Z listy skutków składa plik bramek: G1..Gn, CHECK, EXPECT, EVIDENCE. Liczba w raporcie ma własną bramkę. Niemożliwe = ABANDON z powodem, nie ciche zwężenie zakresu.

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
Skutki, które mają być prawdą (obserwowalne): [SKUTKI]. Komendy, które umiemy odpalić: [KOMENDY]. Ścieżka pliku bramek: [PLIK].

Jeśli [SKUTKI] puste - dopytaj listę skutków (nie aktywności) i stop. NIE implementuj zadania. Najpierw ledger.

## Po co plik

Intencja nie przeżywa długiego kontekstu. Checkbox z minuty 2 jest ostry w minucie 90, gdy ciągnie do "done". Done = każda skrzynka z dowodem, nie obietnica.

## Format (maszynowy)

```
# Gates: <nazwa liścia>

Scope: <jedna linia skutku>

- [ ] G1: <skutek, obcy człowiek umie ocenić>
  CHECK: <komenda>
  EXPECT: <substring albo /regex/>
  EVIDENCE: pending

- [ ] G2: <skutek ręczny, gdy nie ma komendy>
  EVIDENCE: pending
```

Zasady:

- skutek, nie aktywność ("8 plików istnieje", nie "popracuj nad plikami")
- 5-12 bramek na liść. 2 = niedospecyfikowane; 20 = rozetnij liść
- CHECK zamienia tokeny samooceny na subprocess
- EXPECT trafia linię, która pada tylko przy sukcesie (`8/8 passed`), nie słowo `done`
- liczba, która ma trafić do raportu końcowego = własna bramka z CHECK mierzącym tę liczbę
- `EVIDENCE: pending` przy zaznaczonym `[x]` = NIESPEŁNIONE, gorsze niż puste pudełko
- niemożliwe: nie kasuj. Dopisz `ABANDON: G<n> powód`

## Czego nie pisać

- "zrób ładnie", "best practices", "TBD", "reszta analogicznie"
- CHECK, którego nie da się odpalić w tym repo
- EXPECT, które jest w stdout i przy failu, i przy passie

## Raport (dopiero gdy ledger pełny)

Na końcu sesji, nie wcześniej:

1. Wklej ledger (N z N, plus ABANDON jeśli był).
2. Każdą liczbę zmierz teraz albo oznacz "niesprawdzone".
3. Ogon EVIDENCE (3-5 linii), nie pełny log.
4. Jeśli składasz raport a pudełka puste - wróć do pliku, nie do recapu.

## Format wyjścia tego skilla

1. Pełna treść pliku pod [PLIK] (albo ścieżka, jeśli zapiszesz).
2. Tabela: Gn | skutek | CHECK/ręczna | czemu EXPECT rozstrzyga.
3. 1 zdanie: co będzie pierwszym fałszywym "done", jeśli ktoś zaznaczy x bez evidence.

Dywiz "-". Domyślna ścieżka, gdy [PLIK] puste: `GATES.md` w katalogu pracy.

Zanim wkleisz

Skill vs zły prompt

Zły prompt

Bramki: zrobić ładnie, pokryć wszystko, TBD, evidence pending ale zaznaczam x.

Skill

Skutki, które mają być prawdą (obserwowalne): [SKUTKI]. Komendy, które umiemy odpalić: [KOMENDY]. Ścieżka pliku bramek: [PLIK].

Jeśli [SKUTKI] puste - dopytaj listę skutków (nie aktywności) i stop. NIE implementuj zadania. Najpierw ledger.

## Po co plik

Intencja nie przeżywa długiego kontekstu. Checkbox z minuty 2 jest ostry w minucie 90, gdy ciągnie do "done". Done = każda skrzynka z dowodem, nie obietnica.

Użyj z tym narzędziem

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

Pytania

Jak użyć skilla "Raport bramek" 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 odpalania testu w chwili 'done' (to weryfikacja-przed-done). Nie do czterech przebiegów pracy (to petla-weryfikacji). Nie gdy zadanie to jedna oczywista linia bez skutku do zmierzenia.