Спекачто сделать в одной задачена время задачи
Библиячто это за продуктв начале задачи
Правилакак работать в проектев каждой сессии
Скиллкак выполнить процедурупо вызову
Модель не помнит проект между сессиями. Четыре вида файлов возвращают ей этот контекст.
Четыре слоя контекста
| Слой | Что внутри | Когда в контексте | Файлы |
|---|---|---|---|
| Спека | требования, план, шаги одной задачи | на время задачи | spec.md · plan.md · tasks.md |
| Библия | цель продукта, пользователи, решения | в начале задачи | projectbrief.md · productContext.md |
| Правила | команды, стиль, запреты | в каждой сессии | CLAUDE.md · AGENTS.md · .cursor/rules |
| Скилл | процедура с примерами и скриптами | описание всегда, тело по вызову | SKILL.md |
Вывод
В этом примереСлои различаются сроком жизни и моментом, когда попадают в контекст.
В общем случаеПравила загружаются в каждую сессию, поэтому их держат короткими: Anthropic рекомендует до 200 строк на файл. Длинное и редкое переносят в скиллы, тело которых загружается только при вызове.
Что сделатьРазберите свой файл инструкций: факты оставьте в правилах, процедуры перенесите в скиллы, описание продукта — в библию.
Спека: одна задача до кода
Спека описывает задачу до начала работы: сначала что и зачем, затем как.
1Принципыодин раз на проект
→2Спекачто и зачем
→3Планкак
→4Задачишаги
→5Реализациякод по шагам
Основные шаги GitHub Spec Kit. Как делить большую спеку на части — в статье Спеки по агрегатам
Вывод
В этом примереSpec Kit ведёт задачу от принципов проекта через спеку и план к шагам и коду.
В общем случаеТребования записаны до кода, и ревью сверяет результат с этим текстом. Как спека встраивается в харнесс, описано в статье HDD и спеки.
Что сделатьДля задачи дольше одного дня напишите спеку: что, зачем и по каким признакам задача готова.
Библия проекта: что это за продукт
Библия — постоянное описание продукта: зачем он, для кого, как устроен и что уже решено. Термин из практики; ближайший документированный аналог — Memory Bank в Cline.
projectbrief.mdцели и требованияproductContext.mdзачем продукт, какие проблемы решаетsystemPatterns.mdархитектура и паттерныtechContext.mdстек и ограниченияactiveContext.mdтекущий фокус и следующие шагиprogress.mdчто готово, что осталосьВывод
В этом примереШесть файлов Memory Bank: от цели продукта до текущего прогресса.
В общем случаеБиблия отвечает на вопросы, которые иначе задают в каждом новом чате: что за продукт, какие решения приняты, что сейчас в работе. Файл текущего контекста обновляется чаще остальных.
Что сделатьНачните с одного файла: цель продукта, пользователи, ключевые термины и последние решения с датами.
Правила: в каждой сессии
Правила — инструкции, которые харнесс подставляет в начало каждой сессии.
Когда правило попадает в контекст · Cursor
Всегдакаждый чат
По описаниюагент решает сам
По файламсовпал шаблон пути
Вручную@rule
Вывод
В этом примереТри формата одной идеи: файл с инструкциями, который харнесс читает в начале работы.
В общем случаеПравила остаются контекстом, модель может их нарушить; действие, которое нужно запретить наверняка, блокируют хуком. Чем конкретнее и короче правило, тем стабильнее его выполняют.
Что сделатьЗаведите AGENTS.md или CLAUDE.md: команды сборки и тестов, стиль кода, запреты. Правила для отдельных папок вынесите в правила по путям.
Скиллы: процедура по вызову
Скилл — папка с инструкцией SKILL.md, примерами и скриптами для повторяющейся процедуры.
Старт сессии
отчётревью PRрелизписьмо клиенту
имя + описание↓ агент выбрал «ревью PR»
Вызовтело целиком
SKILL.mdинструкция, примеры, скриптыВывод
В этом примереОписания всех скиллов лежат в контексте всегда, тело загружается после выбора.
В общем случаеПоэтому длинный справочник в скилле почти ничего не стоит до использования. Скилл заводят, когда одну и ту же инструкцию или чек-лист вставляют в чат снова и снова, или когда раздел правил превратился в процедуру.
Что сделатьНайдите в правилах раздел, который описывает процедуру, и перенесите его в скилл с точным описанием, когда его применять.
То же в чате: проекты и скиллы
Вывод
В этом примереТри места, где промпт живёт дольше одного чата: инструкции, файлы и скиллы.
В общем случаеРоль, пример и формат, вынесенные в проект, работают в каждом новом чате без копирования. Общим проектом можно поделиться с командой, и все будут работать с одним набором примеров.
Что сделатьЗаведите проект под самую частую задачу недели и перенесите в его инструкции роль и формат из своего лучшего промпта.
Что куда положить
| Если это… | Куда |
|---|---|
| команда, стиль или запрет, нужные в каждой задаче | Правила |
| процедура из нескольких шагов, нужная иногда | Скилл |
| требования к одной задаче | Спека |
| знание о продукте и принятые решения | Библия |
| ошибка агента, которая повторяется | правило или проверка · HDD |
Вывод
В этом примереПять ситуаций и пять мест.
В общем случаеМесто определяют частота и срок жизни. То, что нужно всегда, держат коротким; то, что нужно редко, можно держать подробным.
Что сделатьРаз в неделю просматривайте правила: процедуры переносите в скиллы, решения — в библию с датой.