Primjeri datoteka

Kako gradivni blokovi izgledaju u praksi

Ovo je mali skup primjera, kostur svakog gradivnog bloka, s engleskim ključevima i hrvatskim komentarima. Kliknite pločicu da skočite na primjer. Stvarne, radne verzije su u repozitoriju (CLAUDE.md, .claude/agents/, .claude/rules/, .claude/skills/).

CLAUDE.mdUstav, stalna pravila projekta AgentSpecijalist koji provjerava jednu stvar Pravilo (rule)Priručnik koji se učitava po putanji Vještina (skill)Naredba s koracima

CLAUDE.md, ustav

Vitka stranica (~120 redaka) koju Claude čita na početku svake sesije. To su kratke direktive i pokazivači, ne opširna dokumentacija.

# CLAUDE.md — ustav projekta

## Načela                          # 4–5 kratkih pravila, ne više
1. Prvo plan za netrivijalne zadatke; pokaži mi plan PRIJE izmjena.
2. Provjeri prije nego javiš "gotovo" (stvarno renderiraj / pokreni).
3. Specijalisti pobjeđuju generalista.
4. Odluke piši na disk, ne samo u chat.

## Struktura mapa                  # gdje što živi
- slides/      — prezentacija
- .claude/     — radni okvir (rules, skills, agents)

## Vještine                        # brza referenca naredbi
| Naredba   | Što radi                          |
|-----------|-----------------------------------|
| /render   | izgradi špicu i provjeri          |
| /commit   | spremi tek uz moje odobrenje      |

## Trenutno stanje                 # kratko, ažurira se
- Prezentacija objavljena na GitHub Pages.

Stvarni primjer. CLAUDE.md

Agent, specijalist

Živi u .claude/agents/<ime>.md. Zaglavlje (YAML) postavlja model i alate, a tekst su upute agentu. Popis alata bez Edit/Write čini agenta samo-za-čitanje (kritičar koji ne može mijenjati datoteke).

---
name: deck-critic                  # ime kojim ga vještine pozivaju
description: Read-only kritičar špice; nalazi greške i ocjenjuje.
model: sonnet                      # razina: haiku / sonnet / opus (raspodjela 70/20/10)
tools: Read, Grep, Glob            # SAMO čitanje → ne može uređivati datoteke
---

Ti si skeptični recenzent. Ne smiješ uređivati datoteke — samo nalaziš greške.
Provjeri: (1) sadržaj, (2) jasnoću, (3) dosljednost pojmova, (4) prelijevanje slajda.
Izvijesti po težini (Kritično / Veliko / Malo) i daj ocjenu 0–100.

Stvarni primjer. .claude/agents/deck-critic.md

Pravilo (rule), priručnik

Živi u .claude/rules/<ime>.md. Polje paths: čini ga vezanim uz putanju. Učitava se samo kad Claude dotakne datoteku koja odgovara. Bez paths: pravilo je “uvijek uključeno”.

---
description: Renderiraj prije nego javiš "gotovo".
paths: ['**/*.qmd']                # učitava se SAMO na .qmd datotekama
---

# Pravilo provjere
- Nakon svake izmjene .qmd pokreni /render (quarto render + provjera da HTML postoji).
- Ako render padne: pročitaj grešku, popravi, ponovno renderiraj.
- "Gotovo" znači *renderirano i provjereno*, nikad "izgleda dobro u glavi".

Stvarni primjer. .claude/rules/quality-gates.md

Vještina (skill), gumb

Živi u .claude/skills/<ime>/SKILL.md. Zaglavlje opisuje kad se koristi, a tijelo su numerirani koraci. Pozivate je s /<ime> ili je Claude sam odabere iz vašeg zahtjeva na običnom jeziku.

---
name: render
description: Izgradi špicu (Quarto) i provjeri da je HTML stvarno nastao.
argument-hint: "[datoteka .qmd — zadano slides/talk.qmd]"
---

# Koraci
1. Provjeri da `quarto` postoji; ako ne — STANI i reci korisniku da ga instalira.
2. Pokreni `quarto render <datoteka>`.
3. PROVJERI da izlazni `.html` postoji i da je naredba uspjela. Tek tada javi "gotovo".
4. Ako je render pao: pročitaj grešku, popravi, ponovno renderiraj.

Stvarni primjer. .claude/skills/render/SKILL.md

---

Više o tome kako se svaki blok uklapa pročitajte u mapi za učenje.