heartflow-architecture-tracing

Trace HeartFlow data flow from think() through judgment-engine and decision-router.

38|8|Updated Mar 28, 2026
One-click install
npx skills add https://github.com/yun520-1/mark-heartflow-skill --skill heartflow-architecture-tracing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: heartflow-architecture-tracing
Source: https://github.com/yun520-1/mark-heartflow-skill/tree/main/skills/heartflow-architecture-tracing
Command: npx skills add https://github.com/yun520-1/mark-heartflow-skill --skill heartflow-architecture-tracing

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill allows users to understand the complete path of data flow within HeartFlow, from input to output, helping identify root causes such as "unknown" outcomes, failed Chinese word segmentation, or broken evidence chains.

Core Features & Use Cases

  • Complete Path Analysis: Tracks the data flow from think() → pipeline → judgment-engine → decision-router.
  • Debugging: Assists in debugging by analyzing the sources of "unknown" responses and broken chains.
  • Use Case: If you are trying to understand why HeartFlow returns "unknown" or if you need to analyze the source chain of your analysis results or debug the decision-making path, this skill provides valuable insights.

Quick Start

Activate the HeartFlow Architecture Tracing skill to trace the data flow from input to output.

Frequently Asked Questions about heartflow-architecture-tracing

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I trace the data flow in HeartFlow to debug an "unknown" outcome?

Tracing the HeartFlow data flow involves analyzing the path from the think() function through the pipeline, judgment-engine, and decision-router. By examining this complete architecture path, you can pinpoint the exact failure point causing the unknown outcome.

Why does HeartFlow return failed Chinese word segmentation during processing?

Failed Chinese word segmentation in HeartFlow happens when the data flow breaks between the think() function and the judgment-engine. Architecture tracing from input to output isolates whether the failure originates in the pipeline or a broken evidence chain.

What is the best way to analyze the decision-making path in AI architecture tracing?

Analyzing the decision-making path requires tracing the data flow from the think() function to the decision-router. This reveals how the judgment-engine evaluates inputs and routes decisions, allowing you to debug complex AI behaviors and broken source chains.

Do I need prior knowledge of HeartFlow internals to use architecture tracing?

Yes, architecture tracing requires a good understanding of HeartFlow's internal processes and the ability to handle complex data flows. Familiarity with the think() function, judgment-engine, and decision-router is necessary to effectively debug broken evidence chains.

How can I debug a broken evidence chain in my AI data flow analysis?

To debug a broken evidence chain in AI data flow analysis, trace the complete path from input to output, specifically tracking the think() function through the pipeline and judgment-engine. This isolates where the evidence chain breaks and causes failed analysis results.

When should I use architecture tracing for data flow analysis?

You should use architecture tracing for data flow analysis when you need to understand why HeartFlow returns unknown outcomes, analyze the source chain of analysis results, or debug the decision-making path. It helps identify root causes of failures across the internal pipeline.