Контекст-инжиниринг: введение

Шаблон для старта в контекст-инжиниринге — дисциплине построения контекста для ИИ-ассистентов кодинга, чтобы у них была вся информация для выполнения задачи от начала до конца.

Контекст-инжиниринг в 10 раз эффективнее промпт-инжиниринга и в 100 раз лучше вайбкодинга.

Быстрый старт

Склонируйте шаблон проекта
Отредактируйте CLAUDE.md — добавьте правила проекта
Добавьте примеры кода в папку examples/ (настоятельно рекомендуется)
Опишите фичу в INITIAL.md
Сгенерируйте комплексный PRP (промпт требований к продукту): /generate-prp INITIAL.md
Выполните PRP: /execute-prp PRPs/your-feature-name.md

Что такое контекст-инжиниринг?

Это смена парадигмы по сравнению с традиционным промпт-инжинирингом.

Промпт-инжиниринг против контекст-инжиниринга

Промпт-инжиниринг:

Фокус на удачных формулировках
Ограничен тем, как вы сформулировали задачу
Как записка-стикер

Контекст-инжиниринг:

Полная система предоставления контекста
Документация, примеры, правила, паттерны и валидация
Как полный сценарий со всеми деталями

Почему контекст-инжиниринг важен

Снижает сбои ИИ: большинство сбоев агентов — не сбои моделей, а нехватка контекста
Обеспечивает согласованность: ИИ следует паттернам и конвенциям вашего проекта
Позволяет сложные фичи: ИИ справляется с многошаговыми реализациями при правильном контексте
Самокоррекция: циклы валидации позволяют ИИ исправлять собственные ошибки

Структура шаблона

context-engineering-intro/
├── .claude/
│ ├── commands/ # generate-prp, execute-prp
│ └── settings.local.json # разрешения Claude Code
├── PRPs/
│ ├── templates/prp_base.md
│ └── EXAMPLE_multi_agent_prp.md
├── examples/ # примеры кода (критично!)
├── CLAUDE.md # глобальные правила для ассистента
├── INITIAL.md # шаблон запроса фичи
└── README.md

Пошаговый гид

1. Глобальные правила (CLAUDE.md)

Файл CLAUDE.md содержит правила уровня проекта, которым ассистент следует в каждом диалоге:

Знание проекта: чтение планов, проверка задач
Структура кода: лимиты размера файлов, организация модулей
Требования к тестам: паттерны юнит-тестов, ожидания по покрытию
Стиль: языковые предпочтения, форматирование
Стандарты документации: форматы docstring, правила комментариев

Шаблон можно использовать как есть или настроить под проект.

2. Запрос фичи (INITIAL.md)

Опишите, что хотите построить:

## FEATURE:
[Что строим — конкретика по функциональности и требованиям]

## EXAMPLES:
[Файлы примеров в examples/ и как их использовать]

## DOCUMENTATION:
[Ссылки на документацию, API, ресурсы MCP]

## OTHER CONSIDERATIONS:
[Грабли, специфические требования, что ассистенты обычно упускают]

3. PRP-воркфлоу

PRP (Product Requirements Prompt) — это полный промпт реализации фичи: цели, требования, примеры, правила, критерии завершения. Агент генерирует его по INITIAL.md, затем выполняет по шагам с проверками.

4. Использование примеров

Примеры кода в examples/ дают агенту образец желаемого стиля и паттернов. Это самый эффективный способ объяснить, как должен выглядеть результат.

Лучшие практики

Правила проекта — в глобальный файл (CLAUDE.md), а не в каждый промпт
Примеры — рядом с задачей: агент учится по образцу, а не по описанию
PRP — перед сложной фичей, а не «на ходу»
Цикл: требования → примеры → план → выполнение → валидация → исправление