Висновок про codebase має мати доказ
Claude Code корисний для пошуку звʼязків, але його відповідь не є джерелом правди сама по собі. Висновок про поведінку системи потрібно привʼязати до файлу й методу, маршруту, тесту, конфігурації або результату команди.
Найсильніший висновок зазвичай спирається на кілька незалежних доказів: наприклад, маршрут показує точку входу, сервіс — бізнес-логіку, а тест — очікувану поведінку відмови.
| Джерело | Що підтверджує | Чого не доводить саме по собі |
|---|---|---|
| Маршрут або контролер | Існування точки входу | Повний сценарій |
| Сервісний метод | Місце бізнес-логіки | Факт виклику користувачем |
| Тест | Очікувану поведінку випадку | Відсутність інших сценаріїв |
| Конфігурація | Поріг, прапорець або режим | Фактичне використання кодом |
| Лог або команда | Результат запуску | Причину події без аналізу коду |
Формула evidence-based Q&A
- Звузьте питання до однієї поведінки.
- Обмежте область пошуку конкретним flow або модулем.
- Попросіть для кожного кроку файл, метод, тест і конфігурацію.
- Додайте режим лише читання.
- Перевірте наведені посилання вручну.
- Окремо запишіть неперевірене та рівень упевненості.
Простеж лише login flow від HTTP-входу до створення сесії.
Не редагуй файли.
Для кожного кроку вкажи:
- файл і метод;
- перетворення даних;
- повʼязаний тест;
- конфігурацію;
- що підтверджено;
- що лишилося неперевіреним.Розрізняйте факт, інтерпретацію і припущення
| Мітка | Значення |
|---|---|
| Підтверджено | Є пряме посилання на код, тест, конфігурацію або результат команди |
| Потребує перевірки | Є сигнал, але недостатньо доказів для висновку |
| Не перевірено | Ділянку ще не досліджували |
Як розбирати суперечність
- перевірте, чи не існують різні точки входу;
- пошукайте фонові jobs, batch-процеси та внутрішні виклики;
- порівняйте код із тестами та конфігурацією;
- не виправляйте код у тій самій сесії лише через суперечливу гіпотезу;
- оновіть висновок після появи нового доказу.
Evidence log замість стенограми чату
До inventory достатньо перенести короткий висновок, джерела, межі перевірки й невизначеність. Повна історія діалогу не є добрим довгостроковим артефактом: вона містить повтори та тимчасові припущення.
Канонічне джерело уроку · JavaRush
Відкрити матеріал JavaRush