Preface

In the DeepSeek Harness development workflow, agent exploration often leads to diverging information, while the execution phase is frequently interrupted by a lack of structured paths. Ariadne aims to bridge this gap, transforming abstract conversations into visualized decision and execution maps.

Plugin Positioning

Thread / Ariadne is a visual decision workbench designed for DeepSeek Harness. It is maintained by Zayzz-pixel and released under the MIT open-source license. The core value of the plugin is to help users explore ideas, focus on branches, and transform final choices into actionable flowcharts.

Installation and Enablement

Install the pinned version under the Web profile:

dsh plugin --profile web add github:Zayzz-pixel/dsh-ariadne#v0.3.0
dsh web

After installation, a “Conversation · Trace · Thread” tab will appear at the top of new sessions. Open “Thread” and enable the toolbar switch before the Agent in the current Session receives Ariadne tool permissions.

Core Features

The plugin mainly addresses problems in three areas: structure maintenance, decision finalization, and execution advancement.

Map and Project Management

  • Incremental Map Maintenance: Continuously record directions in the conversation with structured notation.
  • External Structure: Convert Topics, first-level directions, and depth relationships into an actionable structure.
  • Project Overview: Refresh the project overview from the persistent Session Map and aggregate sessions in the same workspace.

Decision and Execution Graph

  • Decision Pool: Separate “worth doing” from “already discussed,” with search and filtering support.
  • Execution Graph Generation: Generate a Final Plan v2 execution graph from the Decision Pool, using explicit dependencies to express execution order.
  • Node Types: Supports Task, Decision, and Checkpoint nodes, as well as success edges, failure edges, and route edges.

Workflow Control

  • Pinned Goal: Fix the current goal and scope for this round.
  • Structure Navigation: Preserve structure navigation around the current node, supporting dragging, zooming, collapsing, focusing, editing, and exporting.
  • Node-by-Node Execution: The user triggers execution for each node; the Agent processes only the current node and writes results and evidence back to the same Run.

Execution States and Recovery

The execution graph supports acyclic control flow. It recommends 5–20 nodes, with a maximum of 30 nodes.

Node Progression Logic

  • Task: A work package with independent acceptance criteria. On success, it follows the success edge to the next node.
  • Decision: Returns the exact routeKey from the allowed list to determine the subsequent route.
  • Checkpoint: Requires user review or approval; progress continues after approval.

State and Recovery

  • State Transitions: Supports Ready, Running, Waiting (user approval), and Blocked (failure/blockage) states.
  • History Recovery: Maps, projects, Final Plans, and Execution Runs from old sessions can be restored directly.
  • Version Compatibility: Old Final Plan v1 is automatically converted into a linear Task graph when read.

Export and Data

The plugin provides standard export formats for use with external tools.

  • Map Export: brainstorm-map.md (Markdown) and brainstorm-map.canvas (JSON Canvas 1.0).
  • Execution Graph Export: brainstorm-execution.json and brainstorm-execution.md (with a Mermaid flowchart).

Map exports include personal notes; execution graph exports include only shared records.

Notes

  1. Environment Requirements: Compatible with DeepSeek Harness 0.1.1-rc.2 and the Web profile; requires Node.js 18 or higher.
  2. Permissions and Maintenance: After a DH upgrade, recheck tools, queues, persistence, and client loading interfaces.
  3. Resource Cleanup: After turning off Thread for the current Session, related tools are removed from the model tool catalog of that Session.
  4. Run Locking: When an active Run is in a specific state, the Thread toggle remains locked.

Directory and Source Code