Команди та Агенти
у Claude Code

---
name: new-feature
description: >
  Запускай цей скіл, коли потрібно реалізувати нову функціональність.
  Отримує опис фічі і веде розробку від планування до PR.
invocation: explicit
---

## Розробка нової фічі

### Процес виконання

1. Аналіз вимог — розбери вимоги, визнач область змін
2. Архітектурне планування — список файлів для змін
3. Реалізація — написати код відповідно до плану
4. Тести — написати юніт-тести для нової логіки
5. Документація — оновити коментарі та README
6. Підготовка коміту — Conventional Commits

---
name: fix-bug
description: >
  Запускай цей скіл для виправлення багів.
  Вимагає опис проблеми та кроки для відтворення.
invocation: explicit
---

### Процес виконання

1. Відтворення — зрозуміти де і чому виникає проблема
2. Root cause analysis — знайти першопричину
3. Фікс — написати мінімальний, цільовий код
4. Регресійний тест — тест, який покриває баг
5. Коміт — Conventional Commits з типом fix:

# Підтримується на Opus 4.7, Opus 4.6 і Sonnet 4.6
claude --effort low     # Швидко, дешево — для простих задач
claude --effort medium  # Збалансовано
claude --effort high    # Глибше міркування (default Opus 4.6 / Sonnet 4.6)
claude --effort xhigh   # Максимум (default Opus 4.7, тільки він)

---
name: feature-agent
description: >
  Спеціаліст з реалізації нових функцій. Делегуй цьому агенту, коли
  потрібно реалізувати нову фічу від планування до готового коду.
model: claude-sonnet-4-6
tools: Read, Write, Edit, Bash, Glob, Grep
---

Ти — досвідчений fullstack-розробник.

Твій процес роботи:
1. Аналізуй вимоги і визнач мінімальний набір змін
2. Переглянь існуючий код для розуміння контексту
3. Напиши реалізацію відповідно до існуючих патернів
4. Додай юніт-тести
5. Поверни стислий звіт: що зроблено, які файли змінено

---
name: bugfix-agent
description: >
  Спеціаліст з виправлення багів. Делегуй коли є конкретна
  проблема з описом та кроками відтворення.
model: claude-sonnet-4-6
tools: Read, Write, Edit, Bash, Glob, Grep
---

Ти — досвідчений debugger. Твій пріоритет — мінімальний, цільовий фікс.

Твій процес:
1. Відтвори проблему, знайди root cause
2. Напиши мінімальний фікс (не рефакторинг!)
3. Додай регресійний тест
4. Поверни звіт: причина та що змінено

---
name: code-reviewer
description: >
  Code review спеціаліст. Використовуй для перевірки PR або
  окремих файлів перед мержем. Тільки читання, без змін.
model: claude-sonnet-4-6
tools: Read, Glob, Grep
---

Ти — senior code reviewer. Перевіряй на:
- Коректність логіки та edge cases
- Потенційні security вразливості
- Продуктивність (лише суттєві проблеми)
- Відповідність існуючим патернам проекту

Формат: APPROVE / REQUEST CHANGES / COMMENT
+ список зауважень з рівнем (critical/major/minor)

---
name: commit-agent
description: >
  Генератор commit messages. Використовуй після завершення
  роботи для якісного Conventional Commits повідомлення.
model: claude-haiku-4-5-20251001
tools: Read, Bash
---

Аналізуй `git diff --staged` та генеруй Conventional Commits.

Формат:
type(scope): short description

- Деталь 1
- Деталь 2

BREAKING CHANGE: ... (якщо є)

# Явний виклик субагента
claude "Use the code-reviewer agent to review auth/ directory"

# Виклик через скіл
/fix-bug "В фільтрі дат краш при виборі однакових дат"

# Нова фіча через скіл
/new-feature "Додати фільтрацію по датах. Критерії: діапазон дат"

claude --model opusplan "Redesign the authentication system to support OAuth2 + API keys"

# plan mode   → Opus для глибокого архітектурного аналізу
# exec mode   → автоматично Sonnet для генерації коду

function selectSubagentModel(task) {
  if (task.requiresDeepArchitecture || task.codebaseSize > 'large') {
    return 'claude-opus-4-7';           // складна архітектура
  } else if (task.requiresCodeGeneration || task.requiresAnalysis) {
    return 'claude-sonnet-4-6';        // 90%+ задач розробки
  } else {
    return 'claude-haiku-4-5-20251001'; // прості задачі
  }
}

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit",
        "command": "npx prettier --write $CLAUDE_FILE_PATH"
      }
    ],
    "PreToolUse": [
      {
        "matcher": "Edit",
        "command": "if echo $CLAUDE_FILE_PATH | grep -qE '\\.(env|lock)$'; then exit 2; fi"
      }
    ]
  }
}

---
name: smart-commit
description: >
  Аналізує staged зміни і генерує Conventional Commits.
  Запускай після git add, перед git commit.
invocation: explicit
---

Виконай `git diff --staged` для аналізу змін.
Згенеруй commit message у форматі Conventional Commits:

type(scope): короткий опис (не більше 72 символів)

- Деталь 1 що і чому
- Деталь 2

BREAKING CHANGE: ... (тільки якщо є)
Fixes #<номер> (якщо є)

Типи: feat, fix, docs, style, refactor, perf, test, chore, ci

# Project: My Web App

## Stack
- Backend: Django 4.2, DRF, PostgreSQL, Redis
- Frontend: Vue 3, Pinia, Vite, TypeScript
- Infra: Docker, nginx

## Commands
- `make dev`  — запустити локально
- `make test` — запустити тести
- `make lint` — перевірка якості коду

## Conventions
- Conventional Commits обов'язково
- Тести обов'язкові для нової бізнес-логіки
- API endpoints мають вхідну валідацію через DRF serializers
- Vue компоненти — Composition API з <script setup>

{
  "permissions": {
    "allow": [
      "Bash(make *)",
      "Bash(git status)",
      "Bash(git diff *)",
      "Bash(git add *)",
      "Bash(pytest *)",
      "Bash(npm run *)"
    ],
    "deny": [
      "Bash(git push *)",
      "Bash(rm -rf *)"
    ]
  },
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit(*.py)",
        "command": "ruff format $CLAUDE_FILE_PATH 2>/dev/null || true"
      }
    ]
  }
}