doctor

Doctor

Audit a project's Beislið workflow config end-to-end. Read <repo>/.beislid/workflow.md, probe each configured capability against the current host session, write a probe cache that orchestrators consume, and print a conversational audit.

Doctor is read-only on the repo and write-only on the cache. It does not modify workflow.md, install or remove skills, post comments, or invoke other orchestrators.

Pass --refresh to force a full re-probe even when the cache is fresh.

---

1. Precheck — git repo required

Run via Bash:

git rev-parse --show-toplevel

If exit code ≠ 0, hard-fail with this prose and stop:

🛑 Doctor needs a git repository. Beislið workflow config lives at <repo>/.beislid/workflow.md. Run git init here, make at least one commit, then re-run /doctor.

Capture the repo root path for later steps ($git_root).

Also verify there is at least one commit:

git rev-list --max-parents=0 HEAD | head -1

If exit ≠ 0 or output is empty, hard-fail with the same prose pattern adjusted to "make at least one commit." No path-hash fallback.

2. Read inputs

Read three files in this order:

1. $git_root/.beislid/workflow.md — the config under audit. If the Read fails (file does not exist), hard-fail with the two-clause prose and stop:

   🛑 No workflow.md found in .beislid/. If this is a fresh project, run /setup to create one. If you moved your config, restore it to <repo>/.beislid/workflow.md.

2. probe-semantics.md (relative to this SKILL.md, resolved through the per-skill symlink). If the Read fails (broken symlink), hard-fail:

   🛑 Doctor's probe-semantics aux is unreadable — likely a broken symlink. Re-run the Beislið installer to repair it.

3. workflow-md-format.md (relative to this SKILL.md, same pattern). Same broken-symlink message tailored to the format spec.

3. Validate the version stamp

The first line of workflow.md MUST match exactly:

<!-- beislid-workflow: v1 -->