/install data-flow-review
Flow Data Review
Trace the real code path before judging any field. Prefer actual callers, store writes, and request builders over comments or interface names.
Reconstruct The Flow
- Find the entry page, downstream pages, and every API wrapper used in the chain.
- Build a minimal path map: page -> action -> store write -> API call -> next page.
- Mark every branch point explicitly:
- backend result branches such as
100701/100702 - user choice branches such as confirm / cancel
- resume vs new-flow initialization
- success vs failure of follow-up transition APIs
- backend result branches such as
Track Canonical Fields
List the few fields whose semantics must stay stable across the flow. Typical examples:
- trace fields:
traceId,orderNo - business order fields:
orderId,bizId - reservation or plan fields:
planOrderId - identity fields: name, cert number, validity dates, OCR outputs
- process control fields:
processId,processType,preType,sysId
For each key field, record:
- source: where the value is first produced
- persistence: where it is written into store/session/local cache
- consumers: which later APIs/pages read it
- required meaning: what the downstream code assumes the field represents
If one field temporarily holds another concept, flag it. Do not accept "it gets corrected later" unless every intermediate consumer is proven safe.
Check Each Branch
For every branch point, verify these questions in order:
- Does the page continue, block, or only show a message?
- Does any store state change before the branch is confirmed?
- If the user cancels or the next API fails, will dirty state remain?
- Do later pages read from the latest closure variable or from persisted store state?
- Are success-only values written only after the success condition is truly satisfied?
Pay special attention to:
- writing business ids before transition APIs succeed
- cancel branches that leave persisted intermediate state
- fallback expressions such as
orderId || orderNo - one API using the correct local value while later pages still read an old store value
Validate Request Accuracy
For each important API in the flow:
- Locate the real payload assembly in code.
- Map every critical field to its source variable.
- Check type and format only from actual values or formatting code, not guesses.
- Compare semantically similar fields across APIs to ensure they are not silently collapsed.
When Excel or API docs are involved, compare:
- field name
- required/optional status
- type
- format
- constant values
- whether the value sits in header, query, or body
Judge Minimal-Change Safety
When reviewing a patch, ask:
- Did the change fix only the intended semantic bug?
- Did it move persistence earlier or later than before?
- Did it alter cancel, retry, refresh, resume, or failure paths?
- Did it introduce a new rejection/throw path without updating callers?
- Does it preserve original control flow for unaffected branches?
Prefer the smallest fix that restores correct field semantics without widening behavior changes.
Report Findings
Findings come first. Order by severity.
Each finding should include:
- severity
- exact file and tight line reference
- branch or scenario that triggers it
- why the resulting data becomes inaccurate or inconsistent
- whether the risk is wrong request data, dirty persisted state, or flow-control regression
After findings, give a short flow summary only if it helps explain the issue set.
Output Patterns
Use this skill for outputs such as:
- code review focused on state consistency
- end-to-end flow reconstruction
- branch-by-branch data accuracy audit
- minimal-change and no-regression review
- interface field provenance checks across pages and API wrappers
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install data-flow-review - After installation, invoke the skill by name or use
/data-flow-review - Provide required inputs per the skill's parameter spec and get structured output
What is data-flow-review?
Review business workflows for branch-state consistency, key field semantics, and end-to-end data correctness. Use when Codex needs to trace a flow, inspect b... It is an AI Agent Skill for Claude Code / OpenClaw, with 40 downloads so far.
How do I install data-flow-review?
Run "/install data-flow-review" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is data-flow-review free?
Yes, data-flow-review is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does data-flow-review support?
data-flow-review is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created data-flow-review?
It is built and maintained by ModeYapu (@modeyapu); the current version is v1.0.0.