03 / 06 · Продвинутый

📖 Глоссарий

Краткий справочник всех терминов. Для полного глоссария см. E:\Clients\Claude\CLAUDE-ABBREVIATIONS.md (1600+ строк). Нажмите на букву для быстрой навигации, или используйте поиск. Термины с якорем доступны по прямой ссылке.

A C D E F G H J L M N O P R S T V W

ADR CC

Architecture Decision Record — документ с обоснованием архитектурного решения.

Хранится в docs/adr/. Фиксирует почему выбран один подход, а не другой.

Alembic Python

Инструмент миграций БД для SQLAlchemy. Аналог Laravel Migrations для Python.

alembic revision --autogenerate && alembic upgrade head

Artisan Laravel

CLI Laravel. Запускает команды: миграции, генерацию кода, очереди.

php artisan migrate, php artisan make:controller

Артефакт CC

Результат работы AI-модели: сгенерированный код, документ, тест, план. Всё что Claude создаёт — артефакт.

Важно: артефакты нужно проверять. Claude может создать синтаксически корректный но логически неверный артефакт.

auto-format hook CC

Hook который автоматически форматирует файл после каждого изменения.

PHP→Pint, Python→Ruff, TS/Vue→ESLint. PostToolUse событие.

Caddy Docker

Reverse proxy сервер. Принимает все входящие запросы и перенаправляет в нужные контейнеры.

Управляется через proxy.cmd. Папка E:\Clients\Windows\proxy

claude_readonly БД

Специальная роль PostgreSQL для Claude — только чтение. Не может изменять данные.

CREATE ROLE claude_readonly WITH LOGIN; GRANT SELECT ON ALL TABLES TO claude_readonly;

CLAUDE.md CC

Файл инструкций для Claude в корне проекта. Читается автоматически при каждом запуске.

Должен быть <150 строк. Содержит стэк, правила, критические ограничения. Иерархический: глобальный + монорепо + проект.

/clear CC

Команда сброса контекста текущей сессии. Начинает разговор заново — Claude забывает всё что было в сессии.

Используйте после завершения задачи перед новой темой. CLAUDE.md перечитывается заново. Не закрывает CC, только очищает историю.

/compact CC

Команда сжатия контекста. Claude создаёт краткое резюме истории сессии и продолжает работу с меньшим объёмом токенов.

В отличие от /clear — не теряет контекст полностью, только сжимает. Срабатывает автоматически при CLAUDE_CODE_AUTO_COMPACT_WINDOW=400000.

Composable Vue

Переиспользуемая функция Vue 3 для Composition API. Аналог React Hook — инкапсулирует логику с состоянием.

export function useCart() { const items = ref([]); ... return { items } }. Называются с префикса use.

Composition API Vue

Современный способ писать Vue компоненты. Используется вместо Options API.

<script setup lang="ts"> — обязателен в проектах.

Context Rot CC

Деградация качества ответов Claude к концу длинной сессии из-за накопления нерелевантного контекста.

Решение: /clear или /compact. Установить CLAUDE_CODE_AUTO_COMPACT_WINDOW=400000. Симптомы: Claude «забывает» правила, повторяет сделанное, путается.

Context Window CC

Максимальный объём информации который Claude держит в "памяти" за раз.

~200K токенов для Claude Sonnet. При заполнении — компактация. Больший контекст ≠ лучшие ответы: избыток шума снижает точность.

CSR (Client-Side Rendering) Vue

Рендеринг HTML в браузере, а не на сервере. Противоположность SSR. Плохо для SEO, быстрее для SPA.

Vue 3 без Nuxt = CSR. С Nuxt = SSR по умолчанию. Можно смешивать через definePageMeta({ ssr: false }).

DDL БД

Data Definition Language — SQL команды для изменения структуры БД: CREATE, ALTER, DROP.

Заблокированы для claude_readonly роли. Только через миграции вручную.

DI (Dependency Injection) Laravel

Паттерн передачи зависимостей через конструктор. Делает код тестируемым.

public function __construct(private readonly PaymentService $service) {}

Docker Compose Docker

Инструмент запуска нескольких Docker контейнеров как единого стека.

Управляется через mcp__docker__docker_compose_* инструменты.

Eloquent Laravel

ORM Laravel. Позволяет работать с БД через PHP объекты, а не сырой SQL.

Использовать только в Service/Repository, не в Controller!

ESLint Flat Config Vue

Новый (v9+) формат конфигурации ESLint. Файл eslint.config.js вместо .eslintrc.

Используется в Vue/Nuxt проектах. Запуск через pnpm lint:fix.

ETL Python

Extract, Transform, Load — процесс переноса данных: извлечение из источника, преобразование, загрузка в целевую систему.

При ETL-операциях снизить max_parallel_workers_per_gather=1 в PostgreSQL. Батчинг по 10K строк обязателен.

FastAPI Python

Быстрый Python фреймворк для создания API. Автоматическая документация (OpenAPI).

Используется с SQLAlchemy 2 + Pydantic v2 + Alembic.

FormRequest Laravel

Класс Laravel для валидации запросов. Отделяет логику валидации от Controller.

$request->validated() — единственный безопасный способ получить данные.

Git Worktree Git

Инструмент Git для работы с несколькими ветками одновременно в разных папках.

git worktree add E:/Clients/wt/feature feat/feature main

Haiku CC

Самая дешёвая модель Claude ($1/$5 per 1M). Для простых задач.

Использовать для rename, format, простой regex. /model haiku

Hook CC

Скрипт который запускается автоматически до/после действий Claude. Пишется на Node.js в CJS формате.

PreToolUse, PostToolUse, Stop. Exit 0 = OK, exit 1 = предупреждение, exit 2 = БЛОК. Файлы с расширением .cjs (важно!)

Horizon Laravel

Dashboard для мониторинга Laravel очередей. Показывает джобы, статистику.

Мониторинг через boost_artisan({ command: "horizon:status" })

Hydration Vue

Процесс «оживления» SSR-рендеренного HTML на клиенте: Vue подключает event listeners к существующей разметке.

Ошибка гидрации (hydration mismatch) — когда HTML от сервера не совпадает с тем что Vue ожидает на клиенте. Частая причина: Date.now(), Math.random(), browser-only API в SSR.

JsonResource Laravel

Класс Laravel для сериализации Eloquent модели в JSON. Контроль формата ответа API.

return new PaymentResource($payment); — обязательно в Controller.

laravel-boost MCP

MCP сервер для Laravel. Даёт Claude прямой доступ к роутам, моделям, Artisan.

Запускается внутри Laravel контейнера: php artisan boost:mcp

LSP (Language Server Protocol) MCP

Протокол для IDE-функций: goto definition, find references, rename. Использует Serena MCP.

Serena реализует LSP для PHP/Python/TypeScript.

Mass Assignment Безопасность

Уязвимость: передача всех полей из запроса в модель без фильтрации.

Защита: только $request->validated() или явный $fillable.

MCP (Model Context Protocol) MCP

Протокол расширений Claude. Позволяет подключать внешние инструменты (БД, Docker, IDE).

Настраивается в .mcp.json (проект) или settings.json (глобально). При недоступности MCP-сервера CC продолжает работу без него.

.mcp.json MCP

Файл конфигурации MCP для конкретного проекта. Хранится в корне проекта.

Содержит DATABASE_URI с паролями — должен быть в .gitignore! Перекрывает глобальный settings.json. Синтаксис: { "mcpServers": { "name": { "command": ..., "args": [...] } } }

MCP_TOOL_SEARCH CC

Устарело. Tool Search встроен в CC 1.0+, работает автоматически без переменных.

Схемы MCP загружаются лениво по умолчанию (~5 700 токенов при старте вместо ~82 000). Переменная MCP_TOOL_SEARCH больше не нужна.

Migration (Миграция) БД

Версионированный скрипт изменения схемы базы данных. Гарантирует воспроизводимость структуры БД.

Laravel: database/migrations/*.php. Python/Alembic: alembic/versions/*.py. Claude генерирует, разработчик проверяет и запускает вручную.

mypy Python

Статическая проверка типов Python. Находит ошибки типов до запуска кода.

[tool.mypy] strict = true в pyproject.toml

Nuxt 3 Vue

SSR фреймворк на Vue 3. Рендеринг на сервере для SEO и производительности.

Правило: все composables работают и server-side. import.meta.client для browser API.

OOM (Out of Memory) Docker

Ситуация когда контейнер использует больше RAM чем доступно. Убивается ОС.

Симптом: Exit code 137. Решение: shared_buffers=4GB, work_mem=64MB в PG.

OWASP TOP-10 Безопасность

10 самых распространённых веб-уязвимостей: SQL Injection, XSS, CSRF и др.

Claude автоматически избегает этих уязвимостей при написании кода.

Pest Laravel

Современный PHP фреймворк тестирования. Чище чем PHPUnit, поддерживает TDD.

./vendor/bin/pest --parallel для быстрого запуска всех тестов.

Pinia Vue

State management для Vue 3. Замена Vuex. Composition API синтаксис.

defineStore('name', () => { ... }) — только Composition API!

Pint Laravel

PHP форматтер от Laravel. Применяет PSR-12 стиль автоматически.

./vendor/bin/pint. Автоматически через auto-format hook.

Plan Mode CC

Режим работы Claude Code где он показывает план изменений и ждёт подтверждения перед выполнением. Безопасный режим для новичков и сложных задач.

Включить: Shift+Tab два раза. Индикатор [plan] в строке ввода. Обязателен для первых задач и всего что меняет больше 5 файлов.

postgres-mcp MCP

MCP сервер для PostgreSQL. С флагом --access-mode=restricted — только чтение.

Используется с ролью claude_readonly для двойной защиты.

Prompt Injection Безопасность

Атака: скрытые инструкции внедряются в читаемые Claude файлы или веб-страницы, перехватывая управление агентом.

Векторы: README.md, git commit messages, PR-комментарии, данные из внешних URL. Защита: allowedDirectories, read-only токены, sandbox для untrusted input.

PSR-12 Laravel

Стандарт форматирования PHP кода. Обязателен в Laravel проектах.

Автоматически применяется Pint. Настраивается в pint.json.

Pydantic v2 Python

Валидация данных Python через type hints. Замена dict в FastAPI.

class PaymentCreate(BaseModel): amount: Decimal. model_config для v2.

Race Condition CC

Состояние гонки: два параллельных агента пытаются изменить один ресурс одновременно, результат непредсказуем.

В мульти-агентных задачах: каждый агент должен работать только в своей директории. git add . из параллельного агента — верный путь к race condition.

Rate Limit Безопасность

Ограничение количества запросов к API за единицу времени. Защита от перегрузки и злоупотреблений.

Anthropic API: лимиты по токенам в минуту (TPM) и запросам в минуту (RPM). При превышении — ошибка 429. Решение: exponential backoff.

Read-only роль БД

Роль БД с правами только на чтение. Используется для безопасного доступа Claude.

claude_readonly — только SELECT. Без INSERT/UPDATE/DELETE/DDL.

Reactive / ref / computed Vue

Реактивные примитивы Vue 3: ref() для простых значений, reactive() для объектов, computed() для вычисляемых.

const count = ref(0) — обращение: count.value в JS, просто count в шаблоне. computed кешируется автоматически.

Ruff Python

Быстрый Python линтер и форматтер. Заменяет flake8 + black + isort.

ruff check --fix && ruff format. Автоматически через auto-format hook.

Sanctum Laravel

Laravel пакет для API аутентификации через токены и SPA сессии.

Использовать Bearer token для API. Настроить SANCTUM_STATEFUL_DOMAINS.

Schema (Схема БД) БД

Структура базы данных: таблицы, колонки, индексы, связи. Описывает как хранятся данные, не сами данные.

Изменение схемы = миграция. Claude может читать схему через information_schema (только SELECT). Прямой ALTER TABLE запрещён.

Serena MCP

LSP-powered MCP сервер. Понимает код как IDE: goto definition, find usages.

Запускается через uvx. Нужен для PHP/Python/TypeScript навигации.

Skill (Superpowers) CC

Предустановленная workflow-инструкция для Claude. Активируется slash-командой.

/brainstorm, /write-plan, /tdd, /debugging, /verification

SQLAlchemy 2 Python

ORM для Python. Версия 2 — async-first, улучшенная типизация.

Использовать AsyncSession для async FastAPI handlers.

SSR (Server-Side Rendering) Vue

Рендеринг HTML на сервере, а не в браузере. Улучшает SEO и первую загрузку.

Nuxt 3 реализует SSR. Нельзя использовать localStorage без import.meta.client. Ошибка гидрации — самая частая проблема SSR.

TDD (Test-Driven Development) CC

Методология: сначала тест, потом код. RED → GREEN → REFACTOR.

Обязателен для фич >5 файлов. Skill /tdd помогает следовать методологии.

Telescope Laravel

Инструмент отладки Laravel. Записывает запросы, очереди, исключения, SQL.

Данные в таблице telescope_entries. Доступны через postgres-mcp для анализа.

Token CC

Единица текста для ИИ. ~0.75 слова. Стоимость Claude = количество токенов × цена.

Sonnet 5: $3/$15 per 1M. Opus 4.8: $5/$25. Haiku 4.5: $1/$5 per 1M.

Token Inflation CC

Чрезмерно многословные ответы Claude. Увеличивают стоимость, засоряют контекст.

Решение: CLAUDE.md правило "отвечай кратко". Tool Search снижает расход на MCP (автоматичен с CC 1.0+).

Vitest Vue

Фреймворк тестирования для Vue/Nuxt. Быстрый, совместим с Jest API.

Для unit/component тестов. Playwright — только для e2e.

Worktree Git

Отдельная рабочая папка для другой ветки Git. Позволяет параллельную работу без переключения веток.

E:\Clients\wt\feature-name. Удалить после merge: git worktree remove. Каждый worktree — независимый Claude Code процесс.

WSL2 Docker

Windows Subsystem for Linux 2. Запускает Docker на Windows. Настроен на 38GB RAM.

C:\Users\..\.wslconfig: memory=38GB, swap=2GB. Применить: wsl --shutdown.