Preskoči na sadržaj

Kako čitati ovu bibliu

TL;DR

Ova biblije je kompas, ne referenca. Četiri paralelna ulaza (po ulozi, po pitanju, po sistemu, po hitnoći). Svaka stranica odgovara na jedno pitanje, ne više. Linkovi vode na ci/<x>/CLAUDE.md ili docs/<x>.md — tu je source of truth.

Četiri ulaza

1. Po ulozi ("JA SAM...")

v7.md §1 — indeks 8 uloga sa linkovima na knjige. Odaberi svoju ulogu, skoči na odgovarajuću knjigu.

2. Po pitanju ("PITANJE JE...")

v7.md §2 — pitanja grupisana u 5 podkategorija:

  • Kako radi (mehanizam)
  • Zašto (obrazloženje + historijat)
  • Gdje da promijenim (mjesto + procedura)
  • Šta ako ne radi (debug playbook)
  • Šta ako želim (procedura + guardrails)

3. Po sistemu ("SISTEM JE...")

02-systems/ — cross-section reference: schemas, env vars, lock, fingerprint, sentry, arch graphs, vendor contract.

4. Hitna pomoć ("GORI")

04-incidents/ — 2-minutni oncall triage za specifične failure mode-ove.

Struktura jedne stranice

# Pitanje koje stranica odgovara?

!!! info "TL;DR"
    Odgovor u 30 sekundi.

## Sekcija 1 — mehanizam
[Koraci, kod, dijagram]

## Sekcija 2 — odluke
[Tablica, comparison]

## Failure modes
[Tipični problemi + fix]

## Vidi i
[Linkovi na related]
  • Naslov = pitanje, ne tema.
  • TL;DR = prvi paragraf, ne sakriven na dnu.
  • Vidi i = zadnja sekcija, cross-refs na related.
  • Bez duplikata: ako nešto piše u CLAUDE.md, linkuj a ne prepisuj.

Kad ne nađeš odgovor

  1. Greška u biblii, ne u tebi — ako odgovor nije lako naći, problem je u knjizi. Otvori PR.
  2. Pitaj u PR opisu, ne u chatu. PR ostaje trajno.
  3. Ako je load-bearing za produkciju (security, data loss), otvori Jira issue sa labelom followup na CI board-u.

Anti-pitanja (ovo NIJE biblije)

  • ❌ "Kako se koristi X?" → idi u ci/<x>/CLAUDE.md, ne u bibliu.
  • ❌ "Šta radi skripta Y?" → ci/<x>/CLAUDE.md + --help.
  • ❌ "Koja je razlika između v8 i v9?" → docs/history/.

Vidi i