Flow Investigator — Development agent for Claude Code
Read-only diagnostician.
How to install Flow Investigator
Installs to ~/.claude/agents/noahwins-ng-flow-workflow-flow-investigator.md
mkdir -p ~/.claude/agents && curl -fsSL https://raw.githubusercontent.com/noahwins-ng/flow-workflow/HEAD/agents/flow-investigator.md -o ~/.claude/agents/noahwins-ng-flow-workflow-flow-investigator.md Restart Claude Code, or start a new session, for it to be picked up.
What Flow Investigator does
name: flow-investigator description: Read-only diagnostician. Given a symptom (a broken ship run, a failing check, a prod incident), runs diagnosis commands, cross-references signals, and returns a root-cause hypothesis with a confidence level and next-step commands. REPORT-ONLY — never remediates. Dispatched by flow-fix and flow-server-audit, or manually. tools: Read, Grep, Glob, Bash model: sonnet
You are a read-only diagnostician. Given a symptom, find the **root cause** and report i
Alternatives in Development
- OSS Hypothesis Checker Agent 2.3k ★
- Idea Agent — Literature search and hypothesis formation 728 ★
- Workflow Debugger — Hypothesis-driven debugging with structured evidence logging 530 ★
Full documentation available on GitHub
View Source RepositoryRelated Agents
Oncall Triage
Read-only incident investigator. Use when an alert fires or something is broken in a running environment. Gath
Incident Scribe
When a workflow fails 3+ times in same session or a prod/client-facing issue happens, writes a structured inci
Workflow Investigation Root Cause Validation
Independently validates a root cause hypothesis by tracing code and checking symptom coverage. Invoked synchro
Hw Debugger
Diagnose and fix one firmware symptom on real hardware - a hypothesis loop inside one locked round, then, with
CI Fix Agent
CI failure diagnosis and repair. Use when CI is failing, when asked to 'fix CI', 'pipeline broke', or 'build f
Dbg CI Fix Agent
CI failure diagnosis and repair. Use when CI is failing, when asked to 'fix CI', 'pipeline broke', or 'build f
Related Skills
Investigator
Root-cause debugging specialist that diagnoses issues through systematic investigation before proposing any fi
Fix Root
Root cause diagnosis. Find the real problem, not just the symptom. Patch narrowly but safely. Add regression p
Project Debug
Hypothesis-driven troubleshooting: structured debug from symptom to root cause