IDE, термінал і логи як докази

Докази поєднують код і фактичну поведінку

Код і конфігурація показують задум, але не гарантують результат запуску. Для investigation корисно поєднати виділений фрагмент у IDE, команду відтворення, короткий test output, stack trace, релевантні логи та, за потреби, скриншот UI.

Claude Code працює точніше, коли отримує конкретні перевірені сигнали: очікуване значення, фактичне значення, назву тесту та координати падіння.

Пакет доказів для бага

Мета: що потрібно пояснити або виправити
Контекст: файл, метод і виділений фрагмент
Команда: як відтворити проблему
Результат: expected і actual
Trace/logs: лише релевантні рядки
UI evidence: назва скриншота та опис
Очікування: мінімальна зміна і перевірка тестами

Працюйте від симптома до першопричини

1. Сформулюйте очікуване й фактичне значення.
2. Звузьте контекст у IDE до методу або невеликого діапазону.
3. Додайте команду відтворення.
4. Знайдіть тип винятку та перший рядок власного коду в trace.
5. Зіставте trace з передачею даних у коді.
6. Додайте лише потрібні рядки логів або короткий UI evidence.
7. Попросіть про мінімальне виправлення без непотрібного рефакторингу.

./gradlew test --tests OrderControllerTest

expected: 400, actual: 500
OrderControllerTest.java:73
OrderService.java:51

Фільтруйте логи та захищайте секрети

• не надсилайте весь лог без потреби;
• залишайте рядки, які повʼязані з відтворенням;
• видаляйте токени, паролі, внутрішні URL та інші секрети;
• скриншот доповнює trace і лог, але не замінює їх;
• розділяйте backend-проблему та її відображення у frontend.

Після аналізу

Збережіть висновок у troubleshooting note або evidence-артефакті: симптом, команда, доказ, причина, мінімальна зміна й результат повторної перевірки. Це робить розслідування повторюваним.