Тріаж Галюцинацій и Устранение Причин

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

Когда агент выдает несуществующий метод или использует библиотеку, которой нет в проекте, типическая реакция неопытного вайбкодера — это гнев и эмоциональные крики в чате: "Ты тупой?! Я же говорил использовать Drizzle, а не Prisma!".

• Это приводит к нарастанию контекста чата эмоциональным мусором.
• Модель начинает извиняться, но продолжает делать ошибки, поскольку причина не была устранена.

Hallucination Triage — это холодный инженерный подход: относиться к галлюцинации модели не как к "глупости ИИ", а как к дефекту системы подачи контекста (Context Delivery Bug), который подлежит классификации и систематическому исправлению.

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

┌─────────────────────────────────────────────────────────────┐
│                 HALLUCINATION TRIAGE MATRIX                 │
├─────────────────────────────────────────────────────────────┤
│ 1. ДЕТЕКЦИЯ: Модель выдала вымышленный метод или тип       │
│    • Пример: `db.user.findFirstOrThrow()` в Drizzle ORM     │
├─────────────────────────────────────────────────────────────┤
│                          │                                  │
│                          ▼ ДИАГНОСТИКА ПРИЧИНЫ             │
│    ┌───────────────────────────────────────────────────┐    │
│    │ Тип А: Отсутствует файл? ➔ Модель не видела schema  │    │
│    │ Тип Б: Конфликт правил? ➔ В правилах упомянуто Prisma│   │
│    │ Тип В: Устаревшие веса? ➔ Знания модели с 2023 г.  │    │
│    └───────────────────────────────────────────────────┘    │
│                          │                                  │
│                          ▼ СИСТЕМНОЕ УСТРАНЕНИЕ             │
│ 1. Добавить точный файл типов в промпт                     │
│ 2. Зафиксировать запрет в rules: "NEVER use Prisma syntax"  │
│ 3. Добавить валидацию компилятором `tsc --noEmit`          │
└─────────────────────────────────────────────────────────────┘

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

01. Ликвидация галлюцинаций через файлы-декларации

Агент постоянно выдумывал пропсы для внутреннего компонента кнопки. Вместо объяснений разработчик создал файл src/components/ui/button.d.ts с четкими TypeScript-типами и добавил его в список автоматического контекста. Ошибки исчезли на 100%.

02. Протокол "Post-Mortem для ИИ-багов"

После решения сложного бага инженер тратит 2 минуты на обновление .agents/rules/learnings.md: "В этом проекте роутер Next.js использует Server Actions без ручного fetch-вызова. Не генерируй лишние роут-хендлеры для простых мутаций".

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

• Over-Correction (Гиперкомпенсация): Пытаясь исправить одну мелкую галлюцинацию, инженер пишет гигантское правило на 50 строк капслоком, которое запрещает модели использовать полезные сопутствующие паттерны. Правила должны быть хирургически точными.
• Игнорирование версий моделей: Если модель имеет слишком низкую способность к рассуждениям (например, устаревшая 3B модель), никакой триаж не поможет ей решать сложные задачи. Иногда единственным лечением является замена модели на более мощную.

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

Галлюцинация — это зеркало качества вашей инженерной документации. Если модель галлюцинирует, значит, ваша система была недостаточно детерминированной. Систематический триаж превращает каждую ошибку в кирпичик в фундаменте надежности вашего репозитория.