Directorul .claude/

Structura

.claude/
├── agents/           # Subagenti specializati
│   ├── architect.md  # Design review, analiza arhitecturala
│   ├── reviewer.md   # Code review, securitate, calitate
│   ├── researcher.md # Research documentatie, evaluare librarii
│   └── qa.md         # Test strategy, coverage gaps
├── commands/         # Comenzi slash personalizate
│   ├── obsidian-sync.md
│   ├── daily-note.md
│   └── adr-create.md
├── rules/            # Reguli path-scoped
│   └── obsidian-docs.md
├── hooks/            # Automatizari
│   └── stop.sh
├── settings.json     # Permisiuni si configurare
└── memory.json       # Knowledge graph (MCP)

Agents — Delegarea muncii

Agentii sunt subprocese specializate pe care agentul principal le poate lansa pentru task-uri specifice. Fiecare agent are un model, un set de tool-uri si un mod de permisiuni propriu.

Format-ul unui fisier agent:

---
name: architect
description: System design, architecture decisions...
tools: Read, Glob, Grep
model: opus
permissionMode: plan
---

Esti un software architect. Analizezi structura codului,
identifici pattern-uri, evaluezi tech debt si propui
imbunatatiri arhitecturale.

Nu modifici cod direct. Outputezi numai analiza si recomandari.

Commands — Comenzi slash

Comenzile slash standardizeaza actiuni repetitive. In loc sa descrii de fiecare data ce vrei, tastezi comanda.

Rules — Reguli path-scoped

Regulile se activeaza automat cand agentul lucreaza cu fisiere care se potrivesc cu glob-ul din frontmatter. Nu ocupa context cand nu sunt relevante.

---
globs: ["docs/**/*.md"]
---
# Obsidian Vault Conventions
- Frontmatter YAML obligatoriu
- Wikilinks interne
- Claude scrie NUMAI in directoarele autorizate

Hooks — Automatizare

Hook-urile sunt scripturi care se ruleaza automat la anumite evenimente. In sistemul v2.1, avem un Stop hook care se executa la finalul fiecarei sesiuni:

• Verifica ca STATE.md a fost actualizat recent (< 5 minute)
• Genereaza o session note in docs/30-sessions/
• Emite un warning daca STATE.md nu e fresh

Configurat in settings.json:

"hooks": {
  "Stop": [{
    "hooks": [{
      "type": "command",
      "command": "bash .claude/hooks/stop.sh"
    }]
  }]
}

Settings — Permisiuni si configurare

settings.json defineste trei categorii de permisiuni:

• allow — actiuni permise fara confirmare (Read, Glob, git operations, edit docs)
• deny — actiuni blocate permanent (rm -rf, sudo, acces la .env)
• ask — actiuni care necesita confirmare (git push, WebFetch)

Include si un PreToolUse hook care blocheaza comenzi periculoase inainte de executie.

Exercitiu

Deschide fiecare fisier din .claude/agents/ si observa diferentele: ce tools au, ce model folosesc, ce instructiuni primesc. Apoi verificasettings.json si identifica ce actiuni sunt in allow vs deny vs ask.