run-digger
SkillFiles & storageLets 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.
No other account needed.
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 deliveredmetadata.jsonagainst 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
weftverb: 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
.envto 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.
- Orient.
weft executions --limit 10andweft 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). - Walk the run.
weft logs <color>first: every failure the journal recorded, aserrorlines naming the node. Thenweft events <color>, narrowed before you read:--kind failed,--kind node_skipped,--node <id>;--fullopens one line's values whole,--jsonprints the replay rows forgrepandjq. Find the first node whose output is wrong or that failed; capture the exact error text, the values that reached each of its inputs (itsnode_startedline), and what it emitted or closed. - Read the code that ran. The
.weftsource including every@included file, themetadata.jsonandmod.rsof each node involved, the files underassets/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. - 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.
- Go deeper when the run is not the problem.
weft daemon logs --tail 200for runtime-level errors;weft infra statusfor infra states;weft files lsandweft files inspect <KEY>for the stored runtime files a node read or wrote;weft listener inspectwhen 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
- [the color] and its status, one line.
- [the finding], one sentence.
- [the evidence], nothing paraphrased.
- The comparison, when one existed: [the first divergent node] and the differing inputs.
- What you could not determine, or [the coldest point].
- 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