/doctor

name: doctor
description: Diagnose evolve health on Claude — verify the CLAUDE.md @import is actually loading the thin EVOLVE.md into sessions
context: fork

Doctor

Overview

On Claude, evolve is delivered by a single `@.evolve/EVOLVE.md` import line in this repo's `./CLAUDE.md`. That import requires a one-time, per-project "allow external imports" approval. If you (or a teammate) declined it — even once, in a past session — Claude silently disables the import forever, the thin EVOLVE.md never loads, and evolve becomes a no-op with **no error**.

This skill checks whether the import is actually reaching your sessions, by looking for a canary token that the installed EVOLVE.md expands into the session transcript when the import loads.

Required Action

Run the doctor script from the repo root:

python3 ${CLAUDE_PLUGIN_ROOT}/skills/evolve-lite/doctor/scripts/doctor.py

It is read-only and always exits 0. Read the status code it prints:

• **OK** — the import is loading; nothing to do.
• **IMPORT_DISABLED** — the `@import` line is in `CLAUDE.md` but its content is

not reaching sessions (you likely declined the external-import approval). Follow the remediation the script prints: purge the project approval, start a new session, and **Allow** the import dialog.

• **NOT_INSTALLED** — evolve isn't wired into this repo; re-run the installer.
• **STALE_EVOLVE_MD** — the installed `.evolve/EVOLVE.md` predates the canary;

re-run the installer to refresh it.

• **UNKNOWN** — no recent Claude transcripts for this project yet; open a

session, then re-run.

Relay the status and any remediation to the user.