What problem does it solve?
Trace claims in plans or tasks through the actual source code and surface mismatches in the resulting execution narrative. It enables structured code-review passes that reveal where the implementation diverges from the plan, improving the reliability of sdlc cycles.
Core Features & Use Cases
- Narrative flow tracing: map each claimed flow to concrete code anchors and report mismatches.
- Adjustable tracing scope: supports --max-hops, --focus, and --force to control depth and focus.
- Re-trace and cache: re-use prior traces when code hasn't changed to save time across fix loops.
- Eval and test integration: correlate with eval results and tests to validate flow correctness.
- Plan-to-code validation in /sdlc workflows: run after feature implementation to ensure alignment.
Quick Start
Run flowsim with a plan file or task reference to begin tracing the end-to-end flow through the codebase.