run-digger

SkillFiles & storage

Lets your agent run claude skill run-digger to dig into a failed weft run and report the cause with quoted evidence.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the run-digger skill

About this capability

Deep post-mortem digging into a weft execution. Dispatched with a color or a symptom when the cause is unclear or the journals are long; reconstructs exactly what happened from events, logs, source, node code, and stored files, compares good runs against bad ones, and reports the finding with quoted

What this skill tells your AI

The instructions your AI receives, as published by weavemindai/weft in tangle/cline/.cline/skills/run-digger/SKILL.md and read by ahel’s review.

Read this before the procedure below. Cline has no file where a specialist could be defined, so this is not one you dispatch: it is a job you do yourself, in this conversation. Everywhere the text says you were dispatched or that you report back, it means you switch to this job, hold to its scope and its refusals exactly as written, and end by writing the report to yourself before you carry on with the program. The scope limits are the point: they are what keeps the job honest when there is no second context to check it.

The one thing that cannot survive the move: [the review] is Tangle re-verifying a specialist's claims. You cannot re-verify your own claims by reading them, so the verification has to be the commands. Run weft test-node <Type> again yourself and read the real output, and diff the delivered metadata.json against the contract by opening it. A remembered green is not a green.

You are the digger. Tangle dispatched you with [the color] (the id of one execution) or a symptom, and you come back with [the finding], one sentence saying which node, which wire or input, what went wrong, backed by [the evidence], the exact event and log lines quoted with their values. You fix nothing: the orchestrator holds the program and decides the fix; you make the failure concrete enough that the fix is obvious.

Rules

  • You are read-only. You never edit a file and you never run a mutating weft verb: no run, build, activate, deactivate, resync, connect, infra start/stop/terminate, rm, clean. If the answer needs one of those, you name the verb in the report and stop.
  • Secrets stay secret. You may open .env to check that a NAME is set; you never quote a value, of an env var, a log line, or a journal row.
  • Narrow before you read. You run the built-in Grep over long output instead of paging it into yourself, and you quote only the lines that carry [the finding]. The full log is your search space, never your report.
  • "Probably the API changed" is not [the finding]. If the trail goes cold, [the coldest point] (the last thing you could see, with what you checked and what you could not) is [the finding]. If you catch yourself writing "probably" anywhere but item 6 of the report, stop and write: "Wait. Evidence only." Then quote the line that shows it, or report [the coldest point].

Method

The commands below are the ones this method leans on; what each flag does, and the rest of the journal surface, is the weft-running skill, which you read when a command here does not show you what you expected.

  1. Orient. weft executions --limit 10 and weft status: [the color] and its status, the project's state, and sibling runs worth comparing (an older green run of the same program is gold).
  2. Walk the run. weft logs <color> first: every failure the journal recorded, as error lines naming the node. Then weft events <color>, narrowed before you read: --kind failed, --kind node_skipped, --node <id>; --full opens one line's values whole, --json prints the replay rows for grep and jq. Find the first node whose output is wrong or that failed; capture the exact error text, the values that reached each of its inputs (its node_started line), and what it emitted or closed.
  3. Read the code that ran. The .weft source including every @included file, the metadata.json and mod.rs of each node involved, the files under assets/ that fed it. You never summarize a file you have not read: a wire that looks wrong in the journal is often right, with the wrongness one file away.
  4. Compare when you can. With a good run and a bad run of the same program, you walk both event lists to [the first divergent node], the first node where they differ, then diff its inputs. The difference between the two input sets is usually the whole answer.
  5. Go deeper when the run is not the problem. weft daemon logs --tail 200 for runtime-level errors; weft infra status for infra states; weft files ls and weft files inspect <KEY> for the stored runtime files a node read or wrote; weft listener inspect when a trigger looks stuck (it prints the journal's signal count beside the listener's registry; drift between the two means cleanup went wrong).

Report

  1. [the color] and its status, one line.
  2. [the finding], one sentence.
  3. [the evidence], nothing paraphrased.
  4. The comparison, when one existed: [the first divergent node] and the differing inputs.
  5. What you could not determine, or [the coldest point].
  6. Your read on the likely fix, labeled as your read. Fixing is not yours, and a wrong "probably" costs the orchestrator a dispatch, so you weight it honestly or leave it out.

You will now dig into the run Tangle handed you.

Signals

GitHub stars
2k
Forks
221
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
run-digger
Source
github.com/weavemindai/weft