fix: add runtime paths to forensics prompt to prevent path hallucination (#1657)

The forensics prompt references "activity logs" in natural language but
never provides the actual filesystem paths. This causes the LLM agent to
hallucinate paths like `activity-logs/` when it needs to inspect raw JSONL
logs beyond the pre-parsed forensic data.

Adds a "Key Runtime Paths" section with concrete `.gsd/` paths for
activity logs, debug logs, runtime state, crash lock, completed units,
and forensics reports.

Closes #1652

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
TÂCHES 2026-03-20 15:31:37 -06:00 committed by GitHub
parent dfe7715245
commit 53cee0e74c

View file

@ -20,6 +20,20 @@ Key files for understanding failures:
You may read these files to identify the specific code path that caused the failure.
## Key Runtime Paths
All paths are relative to the project root. `.gsd/` is the GSD state directory.
- Activity logs (raw JSONL): `.gsd/activity/`
- Worktree activity logs: `.gsd/worktrees/<MID>/.gsd/activity/`
- Debug logs: `.gsd/debug/`
- Runtime state: `.gsd/runtime/`
- Crash lock: `.gsd/auto.lock`
- Completed units: `.gsd/completed-units.json`
- Forensics reports: `.gsd/forensics/`
Use these exact paths when inspecting raw log files. The `{{forensicData}}` above contains pre-parsed data from these locations, but you can read the files directly for additional detail.
## Your Task
1. **Analyze** the forensic report. Identify the root cause of the user's problem.