# Globálna inštalácia
npm install -g @anthropic-ai/claude-code

# Overiť inštaláciu
claude --version

# Prejdi do svojho projektu
cd moj-projekt

# Spusti Claude Code
claude

npm update -g @anthropic-ai/claude-code

export ANTHROPIC_API_KEY="sk-ant-xxxxxxxxxxxxx"

# Načítaj zmeny bez restartu terminálu
source ~/.zshrc

ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxx

# Môj Projekt – Claude Kontext

## Tech Stack
- Next.js 14 (App Router)
- TypeScript strict mode
- Tailwind CSS
- PostgreSQL + Prisma ORM
- Vitest pre testy

## Štruktúra projektu
- `src/app/` – Next.js pages (App Router)
- `src/components/` – React komponenty
- `src/lib/` – helpers a utility funkcie
- `src/server/` – server-side logika
- `prisma/` – databázové schémy

## Príkazy
- `npm run dev` – development server
- `npm run test` – spusti testy
- `npm run build` – produkčný build
- `npx prisma migrate dev` – databázová migrácia

## Konvencie
- Komponenty: PascalCase, jeden súbor = jeden komponent
- API routes: REST, JSON responses, HTTP status kódy
- Error handling: vždy try/catch s logging
- Nepoužívaj `any` v TypeScript

## Zakázané operácie
- NIKDY nemaž súbory v `prisma/migrations/`
- NIKDY nemeň `.env.production`
- Pred zmazaním dát sa vždy opýtaj

## Dôležité poznámky
- Auth cez NextAuth.js – konfig v `src/lib/auth.ts`
- Všetky DB operácie cez Prisma Client, nie raw SQL

.claude/
├── CLAUDE.md           # Stručný úvod, odkazuje na rules/
└── rules/
    ├── code-style.md   # Konvencie písania kódu
    ├── testing.md      # Pravidlá pre testy
    └── security.md     # Bezpečnostné požiadavky

moj-projekt/
├── CLAUDE.md                  # Hlavný kontext pre Claude
├── .claude/
│   ├── settings.json          # Konfigurácia (commit do gitu)
│   ├── settings.local.json    # Lokálna konfigurácia (gitignore)
│   ├── CLAUDE.md              # Alternatívne miesto pre kontext
│   ├── rules/                 # Modulárne pravidlá (nové!)
│   │   ├── code-style.md
│   │   ├── testing.md
│   │   └── security.md
│   ├── skills/                # Vlastné slash príkazy
│   │   ├── review/
│   │   │   └── SKILL.md
│   │   └── deploy/
│   │       └── SKILL.md
│   ├── agents/                # Vlastné subagenty (nové!)
│   │   └── code-reviewer.md
│   └── hooks/                 # Hook skripty
│       └── protect-files.sh
├── src/
│   └── ...
├── .env                       # API kľúče (v .gitignore!)
└── .gitignore

{
  "permissions": {
    "allow": [
      "Bash(npm run test)",
      "Bash(npm run build)",
      "Bash(git status)",
      "Bash(git diff)"
    ],
    "deny": [
      "Bash(rm -rf *)",
      "Bash(git push --force)"
    ]
  },
  "hooks": {
    "Stop": [
      {
        "matcher": "",
        "hooks": [{
          "type": "command",
          "command": "echo '✅ Claude dokončil prácu'"
        }]
      }
    ]
  }
}

# Vytvor worktree pre feature branch
git worktree add ../projekt-feature feature/nova-funkcia

# Zoznam worktrees
git worktree list

# Zmaž worktree po dokončení
git worktree remove ../projekt-feature

mkdir -p .claude/skills/deploy
# Vytvor .claude/skills/deploy/SKILL.md s inštrukciami

{
  "hooks": {
    "Stop": [{
      "matcher": "",
      "hooks": [{
        "type": "command",
        "command": "osascript -e 'display notification \"Claude dokončil prácu\" with title \"Claude Code\"'"
      }]
    }]
  }
}

{
  "hooks": {
    "PostToolUse": [{
      "matcher": "Write",
      "hooks": [{
        "type": "command",
        "command": "npx prettier --write \"$CLAUDE_TOOL_OUTPUT_FILE_PATH\" 2>/dev/null || true"
      }]
    }]
  }
}

#!/bin/bash
INPUT=$(cat)
FILE_PATH=$(echo "$INPUT" | jq -r '.tool_input.file_path // empty')
PROTECTED=(".env" "package-lock.json" ".git/")

for pattern in "${PROTECTED[@]}"; do
  if [[ "$FILE_PATH" == *"$pattern"* ]]; then
    echo "Blokované: $FILE_PATH je chránený súbor" >&2
    exit 2
  fi
done
exit 0

{
  "hooks": {
    "PreToolUse": [{
      "matcher": "Edit|Write",
      "hooks": [{
        "type": "command",
        "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/protect-files.sh"
      }]
    }]
  }
}

{
  "hooks": {
    "PreToolUse": [{
      "matcher": "Bash",
      "hooks": [{
        "type": "http",
        "url": "http://localhost:8080/hooks/validate",
        "timeout": 30,
        "headers": {
          "Authorization": "Bearer $MY_TOKEN"
        },
        "allowedEnvVars": ["MY_TOKEN"]
      }]
    }]
  }
}

# Pridaj stdio MCP server
claude mcp add moj-server -- node /cesta/k/server.js

# Pridaj s environment premennou
claude mcp add github -e GITHUB_TOKEN=ghp_xxx -- npx @modelcontextprotocol/server-github

# Zoznam nainštalovaných serverov
claude mcp list

# Odober server
claude mcp remove moj-server

{
  "mcpServers": {
    "github": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxxxxxxxxx"
      }
    },
    "postgres": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "POSTGRES_CONNECTION_STRING": "postgresql://user:pass@localhost/db"
      }
    }
  }
}

import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

const server = new McpServer({ name: "moj-server", version: "1.0.0" });

// Definuj nástroj
server.tool(
  "get_user",
  "Vráti info o používateľovi z interného API",
  { userId: { type: "string" } },
  async ({ userId }) => {
    const data = await fetchFromInternalAPI(userId);
    return { content: [{ type: "text", text: JSON.stringify(data) }] };
  }
);

// Spusti server
const transport = new StdioServerTransport();
await server.connect(transport);

# Projekt-level (commitni do gitu, zdieľaš s tímom)
.claude/skills/
├── review/
│   └── SKILL.md        # /review
├── deploy/
│   ├── SKILL.md        # /deploy
│   └── checklist.md    # podporný súbor
└── fix-issue/
    └── SKILL.md        # /fix-issue

# Personal-level (pre všetky projekty)
~/.claude/skills/
└── summarize-changes/
    └── SKILL.md        # /summarize-changes

---
name: deploy
description: Pripraví a otestuje aplikáciu pred releasom. Použi keď chceš vydať novú verziu.
disable-model-invocation: true
allowed-tools: Bash(npm *) Bash(git *)
---

Priprav release:

1. Spusti `npm run test` — ak niečo failuje, zastav a reportuj
2. Spusti `npm run build` — over že build prebehne čisto
3. Skontroluj `git status` — nesmú byť necommitnuté zmeny
4. Navrhni verziu podľa semver (patch/minor/major)
5. Opýtaj sa či môžem pokračovať s tagom a pushom

---
description: Code review aktuálnych zmien. Použi pred každým commitom alebo merge.
allowed-tools: Bash(git diff) Bash(git status) Bash(npm run test)
---

Vykonaj kompletný code review aktuálnych zmien:

1. Spusti `git diff` a preskúmaj všetky zmenené súbory
2. Skontroluj:
   - Logické chyby a edge cases
   - Bezpečnostné problémy (SQL injection, XSS, citlivé dáta)
   - Výkon (N+1 dotazy, chýbajúce indexy)
   - Dodržanie konvencií z CLAUDE.md
3. Spusti `npm run test`
4. Zhrň nálezy:
   - ✅ Čo je dobré
   - ⚠️ Čo treba zlepšiť
   - ❌ Čo je kritické (blokuje merge)

---
name: fix-issue
description: Opraví GitHub issue podľa čísla
argument-hint: "[issue-number]"
disable-model-invocation: true
---

Oprav GitHub issue #$ARGUMENTS:

1. Načítaj detaily issue pomocou GitHub MCP nástroja
2. Analyzuj ktoré súbory treba zmeniť
3. Implementuj fix
4. Napíš test pokrývajúci tento bug
5. Vytvor commit: "fix: resolve issue #$ARGUMENTS"

---
description: Zhrnie necommitnuté zmeny a upozorní na riziká.
---

## Aktuálne zmeny

!`git diff HEAD`

## Inštrukcie

Zhrň zmeny v 2-3 bodoch. Vypíš riziká (chýbajúce error handling,
hardcoded hodnoty, testy ktoré treba aktualizovať).

Potrebujem rozšíriť schopnosti Claudu...

→ Je to opakovateľný workflow v rámci projektu?
    ÁNO → použi SKILL (/review, /deploy, /fix-tests)

→ Potrebujem prístup k externej službe (GitHub, DB, Slack)?
    ÁNO → použi MCP PLUGIN

→ Je úloha príliš veľká alebo potrebujem paralelné spracovanie?
    ÁNO → použi SUBAGENT (Explore, Plan, general-purpose)

→ Potrebujem izolovať prácu od hlavného branchu?
    ÁNO → použi SUBAGENT s isolation: "worktree"

Vykonaj kompletný release review:

1. Spusti EXPLORE AGENTA (subagent) ktorý preskúma všetky
   zmenené súbory a identifikuje potenciálne problémy

2. Pomocou GitHub MCP (plugin) načítaj otvorené issues
   a over či zmeny riešia nejaký z nich

3. Spusti testy a build

4. Zhrň výsledky a navrhni či je kód pripravený na merge

---
description: Expertný code reviewer pre kvalitu a bezpečnosť. Použi po každej väčšej zmene.
tools:
  - Read
  - Grep
  - Glob
  - Bash
model: sonnet
---

Si senior code reviewer. Fokusuj sa na:
- Kvalitu kódu a čitateľnosť
- Bezpečnostné zraniteľnosti
- Výkonnostné problémy
- Pokrytie testami

Vždy uveď konkrétny súbor a riadok pre každý nález.

claude --agents '{
  "debugger": {
    "description": "Debugging specialist pre chyby a failing testy.",
    "prompt": "Si expert debugger. Analyzuj chyby a navrhni opravy.",
    "tools": ["Read", "Grep", "Glob", "Bash"]
  }
}'

~/.claude/projects/<projekt>/memory/
├── MEMORY.md          # Stručný index, načíta sa do každej session
├── debugging.md       # Debugovacie vzory ktoré Claude objavil
├── api-conventions.md # API rozhodnutia z minulých sessions
└── ...                # Ďalšie témy ktoré Claude vytvorí

// Vypnúť auto memory
{ "autoMemoryEnabled": false }

// Vlastná cesta pre ukladanie
{ "autoMemoryDirectory": "~/my-custom-memory-dir" }

---
name: tech-stack
description: Technológie používané v projekte
metadata:
  type: project
---

Projekt používa Next.js 14, TypeScript strict mode,
Tailwind CSS a PostgreSQL cez Prisma ORM.

**Prečo:** Tím pozná React, potrebujeme SSR pre SEO.
**Ako aplikovať:** Vždy generuj kód kompatibilný s týmto stackom.

- [Tech Stack](tech-stack.md) — Next.js, TypeScript, Tailwind, PostgreSQL
- [User Preferences](user-prefs.md) — preferuje krátke odpovede, slovenčina
- [Project Goals](project-goals.md) — e-shop platforma, launch Q3 2025

Pridaj funkciu [POPIS] do [SÚBOR/MODUL].
Požiadavky:
- [Požiadavka 1]
- [Požiadavka 2]
Neupravuj iné súbory ako [zoznam povolených].

V súbore [SÚBOR] na riadku [ČÍSLO] sa vyskytuje chyba:
[CHYBOVÁ SPRÁVA]

Reprodukcia: [kroky na reprodukciu]
Očakávané správanie: [čo má robiť]
Aktuálne správanie: [čo robí]

Refaktoruj [SÚBOR/FUNKCIA] pre lepšiu [čitateľnosť/výkon/testovateľnosť].
Zachovaj rovnaké API a správanie.
Nepridávaj nové funkcie.

# Overenie verzie
claude --version

# Overenie API kľúča
echo $ANTHROPIC_API_KEY

# Reset konfigurácie
claude /config

# Zobrazenie logov (ak existujú)
cat ~/.claude/logs/latest.log