Context Curation & Rules Hygiene(Курація контексту та гігієна системних правил)

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 року

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