flowsim

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.