Kontekstowa kuracja i higiena reguł

1. Przegląd koncepcji i problem systemowy

Programiści często traktują pliki typu .cursorrules czy .clinerules jak śmietnik:

• Pojawił się błąd? Dodano regułę: "Nigdy nie używaj biblioteki X".
• Tydzień później inny programista dodał: "Używaj biblioteki X do szybkich operacji".
• Po trzech miesiącach plik zamienia się w nieczytelny zwój z 80 sprzecznymi wytycznymi.
• Model przy każdym zapytaniu musi przetwarzać ten chaos, marnując tokeny i tracąc jakość generowania.

Context Curation to dyscyplina minimalizmu i czystości architektonicznej: reguły systemowe muszą być modularne, hierarchiczne, aktualne i zwięzłe.

2. Taksonomia architektoniczna i model mentalny

┌─────────────────────────────────────────────────────────────┐
│                 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. Praktyczne scenariusze inżynierskie na produkcji

01. Reguła "Jednoznacznej negacji" (Negative Constraints)

Zamiast długich opisów sposobu pisania kodu, wysokiej jakości reguły precyzyjnie formułują zakazane działania:

## 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. Użycie odwołań względnych zamiast kopiowania kodu

Zamiast wklejać cały plik typów do .cursorrules, wskazuj odwołania:

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

Nowoczesne środowiska agentyczne samodzielnie pobiorą zawartość pliku w razie potrzeby.

4. Pułapki, typowe błędy i bezpieczeństwo

• Próba uczenia modelu językowego przez reguły: Nie umieszczajcie w regułach wykładów na temat tego, czym jest asynchroniczność w JavaScript lub jak działają promisy. Model już to wie. Reguły służą wyłącznie do specyfiki waszego repozytorium.
• Utrata aktualności: Jeśli projekt przeszedł z Tailwind v3 na Tailwind v4, stare reguły zawierające przestarzałe utility będą powodować błędy składniowe. Przeprowadzajcie miesięczny audyt reguł.

5. Strategiczny wniosek dla inżyniera roku 2026

Jakość pracy agenta jest bezpośrednio proporcjonalna do czystości kontekstu, który mu dostarczacie. Kuracja kontekstu to cyfrowy odpowiednik sterylności na stole operacyjnym: zbędne narzędzia są usuwane, a potrzebne leżą na wyznaczonych miejscach.