# 1. Установите Claude Code
curl -fsSL https://claude.ai/install.sh | bash     # macOS / Linux / WSL
# или: npm install -g @anthropic-ai/claude-code

# 2. Поставьте starter-kit в свой проект
git clone https://github.com/justxor/claude-code-pro-course.git
bash claude-code-pro-course/install.sh ~/path/to/my-project

# 3. Запустите
cd ~/path/to/my-project && claude
> /context          # что загружено
> /onboard          # skill из starter-kit: обзор проекта

flowchart LR
    subgraph B["🟢 Основы"]
        M0["00 Установка"] --> M1["01 Промптинг"] --> M2["02 CLAUDE.md"] --> M3["03 Настройки"]
    end
    subgraph W["🟡 Рабочий процесс"]
        M4["04 Workflow профи"]
    end
    subgraph E["🟠 Расширение"]
        M5["05 Skills"] --> M6["06 Subagents"] --> M7["07 Hooks"] --> M8["08 MCP"]
    end
    subgraph P["🔴 Масштаб"]
        M9["09 Плагины"] --> M10["10 Headless и CI"] --> M11["11 Pro-приёмы"]
    end
    B --> W --> E --> P

flowchart LR
    U["👤 Задача<br/>промпт · @файлы · скриншоты"] --> C["📥 Сбор контекста<br/>CLAUDE.md · Read · Grep · Glob"]
    C --> P["🧠 План<br/>что менять и как проверить"]
    P --> A["🛠 Действие<br/>Edit · Write · Bash · MCP"]
    A --> V{"✅ Проверка<br/>тесты · линтер · сборка"}
    V -- "ошибка" --> C
    V -- "готово" --> R["📝 Результат<br/>diff · коммит · PR"]
    PM["🔐 Permissions"] -. "разрешить / спросить / запретить" .-> A
    H["🪝 Hooks"] -. "до и после каждого инструмента" .-> A

flowchart TB
    subgraph CW["🪟 Окно контекста"]
        direction TB
        S1["Системный промпт и инструменты"]
        S2["CLAUDE.md и правила"]
        S3["Описания skills · agents · MCP"]
        S4["История диалога"]
        S5["Прочитанные файлы и вывод команд"]
    end
    CW --> Q{"Что дальше?"}
    Q -- "новая задача" --> CL["/clear<br/>чистый лист"]
    Q -- "длинная задача" --> CO["/compact<br/>сжать историю"]
    Q -- "большое исследование" --> SA["🤖 Subagent<br/>своё окно, вернёт только вывод"]

flowchart TB
    subgraph U["👤 Пользователь — ~/.claude/"]
        U1["CLAUDE.md"]
        U2["settings.json"]
        U3["skills/ · agents/ · output-styles/"]
    end
    subgraph PR["📦 Проект — в git, для команды"]
        P1["CLAUDE.md · .claude/rules/"]
        P2[".claude/settings.json<br/>permissions · hooks · statusLine"]
        P3[".claude/skills/ · .claude/agents/"]
        P4[".mcp.json"]
    end
    subgraph L["🔒 Локально — не в git"]
        L1["CLAUDE.local.md"]
        L2[".claude/settings.local.json"]
    end
    PL["🧩 Плагины<br/>skills · agents · hooks · MCP"]
    U --> S(("Сессия<br/>Claude Code"))
    PR --> S
    L --> S
    PL --> S

flowchart TD
    Q1{"Должно происходить всегда,<br/>без исключений?"} -- да --> HK["🪝 Hook"]
    Q1 -- нет --> Q2{"Нужна внешняя система<br/>или данные?"}
    Q2 -- да --> MCP["🔌 MCP-сервер"]
    Q2 -- нет --> Q3{"Задача шумная,<br/>нужен отдельный контекст?"}
    Q3 -- да --> SA["🤖 Subagent"]
    Q3 -- нет --> Q4{"Повторяемая процедура<br/>или промпт?"}
    Q4 -- да --> SK["🧰 Skill"]
    Q4 -- нет --> CM["📄 CLAUDE.md или обычный промпт"]

sequenceDiagram
    actor Dev as Разработчик
    participant C as Claude
    participant R as Репозиторий
    Dev->>C: Plan mode — изучи модуль оплаты, ничего не меняй
    C->>R: Read · Grep · Glob
    C-->>Dev: План — файлы, шаги, риски, как проверить
    Dev->>C: Поправь шаг 3, остальное ок — реализуй
    loop пока проверки не зелёные
        C->>R: Edit
        C->>R: Bash — тесты и линтер
    end
    C-->>Dev: diff и краткий итог
    Dev->>C: Закоммить и открой PR

sequenceDiagram
    participant C as Claude
    participant H as Hook
    participant T as Инструмент
    C->>H: PreToolUse — Bash rm -rf
    alt опасная команда
        H-->>C: exit 2 и причина в stderr
        Note over C: вызов заблокирован, Claude видит причину
    else всё в порядке
        H-->>C: exit 0
        C->>T: выполнить
        T-->>C: результат
        C->>H: PostToolUse — Edit
        H-->>C: prettier и eslint --fix
    end

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          { "type": "command", "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write" }
        ]
      }
    ]
  }
}

flowchart LR
    M["🎯 Главная сессия"] --> A1["🔍 explorer<br/>ищет по коду"]
    M --> A2["🧪 test-runner<br/>гоняет тесты"]
    M --> A3["🛡 security-reviewer<br/>ищет уязвимости"]
    A1 -- "краткая сводка" --> M
    A2 -- "только упавшие тесты" --> M
    A3 -- "список находок" --> M

---
name: reviewer
description: Ревью изменений перед коммитом. Используй после любой заметной правки.
tools: Read, Grep, Glob, Bash
model: sonnet
---
Ты строгий ревьюер. Проверь git diff на баги, пограничные случаи,
утечки секретов и нарушения стиля из CLAUDE.md.
Отвечай списком: файл:строка — проблема — как исправить.

flowchart TB
    R["📦 Репозиторий"] --> W1["../app-auth<br/>feature/auth"]
    R --> W2["../app-billing<br/>feature/billing"]
    R --> W3["../app-fix<br/>fix/flaky-test"]
    W1 --> C1["🤖 Claude 1"]
    W2 --> C2["🤖 Claude 2"]
    W3 --> C3["🤖 Claude 3"]

git worktree add ../app-auth -b feature/auth
cd ../app-auth && claude

# Разовый запрос в скрипте или CI
claude -p "Найди причину падения сборки" --output-format json < build.log

# Ревью своего diff перед пушем
git diff main | claude -p "Сделай ревью: баги, пограничные случаи, безопасность"

# Ограничить инструменты и число шагов
claude -p "Обнови CHANGELOG по последним коммитам" --allowedTools "Read,Edit,Bash(git log:*)" --max-turns 10

# Массовая миграция: файл за файлом
for f in $(git ls-files 'src/**/*.js'); do
  claude -p "Переведи $f на TypeScript, не меняя поведения" --allowedTools "Read,Edit,Bash(npx tsc:*)"
done

flowchart LR
    T["🛠 Claude хочет<br/>вызвать инструмент"] --> H{"🪝 PreToolUse<br/>hook"}
    H -- "exit 2" --> X["⛔ Заблокировано"]
    H -- "ок" --> D{"Есть правило<br/>deny?"}
    D -- да --> X
    D -- нет --> K{"Есть правило<br/>ask?"}
    K -- да --> Q["🙋 Спросить вас"]
    K -- нет --> A{"Есть правило<br/>allow?"}
    A -- да --> OK["✅ Выполнить"]
    A -- нет --> Q
    Q -- "разрешили" --> OK
    Q -- "отказали" --> X

{
  "permissions": {
    "allow": [
      "Bash(npm run test:*)",
      "Bash(npm run lint)",
      "Bash(git status)",
      "Bash(git diff:*)"
    ],
    "ask": [
      "Bash(git push:*)"
    ],
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)",
      "Bash(rm -rf:*)",
      "Bash(curl:*)"
    ]
  }
}

flowchart LR
    L1["🟢 Новичок<br/>чат и правки по просьбе"] --> L2["🟡 Практик<br/>CLAUDE.md · Plan mode · тесты"]
    L2 --> L3["🟠 Продвинутый<br/>skills · hooks · subagents · MCP"]
    L3 --> L4["🔴 PRO<br/>worktrees · headless · CI · плагины для команды"]

- [ ] 00 Установка          - [ ] 06 Subagents        + Лаба 5
- [ ] 01 Промптинг          - [ ] 07 Hooks            + Лаба 6
- [ ] 02 CLAUDE.md + Лаба 1 - [ ] 08 MCP              + Лаба 7
- [ ] 03 Настройки + Лаба 2 - [ ] 09 Плагины
- [ ] 04 Workflow  + Лаба 3 - [ ] 10 Headless и CI    + Лаба 8
- [ ] 05 Skills    + Лаба 4 - [ ] 11 Pro-приёмы (итоговый чек-лист)

.
├── course/                  # 12 модулей + cheatsheet.md + faq.md
├── labs/                    # 8 лабораторных работ
├── recipes/prompts.md       # библиотека промптов
├── starter-kit/             # готовая конфигурация для копирования
│   ├── CLAUDE.md  .mcp.json
│   └── .claude/
│       ├── settings.json    # permissions + hooks + statusLine
│       ├── skills/          # 8 skills
│       ├── agents/          # 5 субагентов
│       ├── hooks/           # 4 hook-скрипта
│       ├── rules/           # правила по путям
│       ├── output-styles/   # режим наставника
│       └── statusline.sh
├── plugin-example/          # пример плагина
├── install.sh               # установщик starter-kit
├── scripts/validate.py      # проверки (запускаются в CI)
└── .github/workflows/       # @claude, авто-ревью PR, валидация