Курация Контекста и Гигиена Правил

1. Обзор концепции и системная проблема

Разработчики часто относятся к файлам типа .cursorrules или .clinerules как к мусору:

• Появился баг? Добавили правило: "Никогда не используй библиотеку X".
• Через неделю другой разработчик добавил: "Используй библиотеку X для быстрых операций".
• За три месяца файл превращается в нечитаемый свиток из 80 противоречивых указаний.
• Модель в каждом запросе вынуждена считывать этот хаос, тратя токены и теряя качество генерации.

Context Curation — это дисциплина минимализма и архитектурной чистоты: системные правила должны быть модульными, иерархическими, актуальными и лаконичными.

2. Архитектурная таксономия и ментальная модель

┌─────────────────────────────────────────────────────────────┐
│                 MODULAR CONTEXT HIERARCHY                   │
├─────────────────────────────────────────────────────────────┤
│ 1. ROOT RULES (.cursorrules / AGENTS.md) [Max 150 lines]    │
│    • Core stack & strict boundaries (Next.js 15, Drizzle)   │
│    • Ban-list (No any, no ts-ignore, no unverified deps)    │
│    • Verification command: `pnpm check && pnpm test`        │
├─────────────────────────────────────────────────────────────┤
│                          │                                  │
│                          ▼ On-demand dynamic loading        │
├─────────────────────────────────────────────────────────────┤
│ 2. DOMAIN SKILLS & SUBSYSTEM SPECS (.agents/skills/)        │
│    • `skills/better-auth/` ➔ loaded ONLY during auth tasks   │
│    • `skills/seo-audit/`   ➔ loaded ONLY for marketing pages│
│    • `skills/db-migrations/` ➔ loaded ONLY for schema edits │
└─────────────────────────────────────────────────────────────┘

3. Практические инженерные сценарии в продакшене

01. Правило "Однозначного запрета" (Negative Constraints)

Вместо длинных описаний того, как писать код, качественные правила четко формулируют запрещенные действия:

## Strict Invariants
- NEVER run `npm run build` locally during dev; use `tsc --noEmit`.
- NEVER use inline CSS styles; use Tailwind design tokens.
- NEVER invent mock user IDs; query database fixtures.

02. Использование относительных ссылок вместо копипасты кода

Вместо того, чтобы копировать весь файл типов в .cursorrules, указывайте ссылку:

Before modifying database entities, read schema definitions in [schema.ts](file:///src/db/schema.ts).

Современные агентские среды самостоятельно подтянут содержимое файла по необходимости.

4. Подводные камни, типовые ошибки и безопасность

• Попытка научить модель языка через правила: Не пишите в правилах лекции о том, что такое асинхронность в JavaScript или как работают промисы. Модель уже это знает. Правила нужны исключительно для специфики вашего репозитория.
• Потеря актуальности: Если проект перешел с Tailwind v3 на Tailwind v4, старые правила со старыми утилитами будут вызывать синтаксические ошибки. Проводите ежемесячный аудит правил.

5. Стратегический вывод для инженера 2026 года

Качество работы агента прямо пропорционально чистоте контекста, который вы ему предоставляете. Курация контекста — это цифровой эквивалент чистоты на хирургическом столе: лишние инструменты убираются, а нужные лежат на определенных местах.