Stopping AI Tangents
Learn how to use real-time intent analysis to stay focused on your project goals.
The Problem: The AI Rabbit Hole
AI coding assistants are extremely effective at suggesting improvements. However, they lack context regarding your immediate priorities. It's easy to ask for a small fix and end up in a two-hour "rabbit hole" of refactoring that wasn't planned. These tangents kill sprint velocity and introduce unnecessary risk.
How TraceFlow Detects Tangents
TraceFlow uses passive intent extraction. You don't need to set a goal or link a ticket. The agent figures out what you're working on from the conversation itself and alerts you when you drift.
Automatic Intent Extraction
As you chat with Claude, Copilot, or any AI tool, TraceFlow builds a rolling understanding of your session's intent from your prompts and the files being touched.
Drift Detection
The early part of your session establishes a baseline. If the conversation or file activity diverges significantly from that baseline, TraceFlow calculates a divergence score.
Divergence Alert
When the score crosses the threshold, you get a nudge. The alert shows what you started working on vs. where you've drifted to.
Configuring Alerts
Tangent alerts can be delivered in three ways:
- Terminal Nudge: If you are using the
traceflow watchcommand, you will see a warning directly in your terminal. - Dashboard Notifications: Active sessions with high divergence are highlighted in red on the dashboard.
- Team Digest: Managers receive a summary of "Yield Lost to Tangents" in their weekly email report.
Advanced: Manual Goal Override
By default, TraceFlow extracts intent automatically and no setup is needed. For teams that want higher precision during critical sprints, you can optionally set an explicit project goal that overrides automatic extraction:
- Project Goal: Define a focus in
.project.yamlto give the scoring engine a fixed reference point instead of a rolling baseline. - Focus Override: Run
traceflow focus "task-name"to temporarily narrow the intent scope for a specific sub-task. The automatic extraction resumes when focus mode ends.