| name | doctor-enforcement |
| description | Auto-run the relevant codebase doctor(s) after large edit sessions or before committing. Detects which subsystems were touched and runs the matching doctor. Use when the agent has completed a significant edit (5+ files), before claiming work is done, or when the user says "run doctors", "health check", "doctor pass", or "check everything." |
Doctor Enforcement
After a significant edit session, detect which subsystems were touched and run the relevant doctor(s) before reporting completion.
Trigger Conditions
Run this skill when ANY of the following are true:
- Agent edited 5+ files in a single session
- Agent touched files across multiple packages in a monorepo
- User says "run doctors", "health check", "doctor pass", "check everything"
- Agent is about to claim a task is complete
- Session involved framework migration, dependency updates, or config changes
Detection Logic
Check git diff --name-only (staged + unstaged) to determine which doctors to run:
| Files changed match | Run |
|---|
wiki/**, skills/**, config/** | npx tsx scripts/doctor.ts (wiki-doctor) |
*.tsx, *.jsx, components/**, app/**, pages/** | npx react-doctor@latest |
package.json, tsconfig.*, monorepo config | npx @sylphx/doctor (if monorepo) |
| Any frontend files | agent-browser vitals <url> (if dev server running) |
*.tf, infra/** | Project-specific infra doctor |
Execution
git diff --name-only HEAD
npx tsx scripts/doctor.ts
npx react-doctor@latest
npx @sylphx/doctor
agent-browser vitals http://localhost:3000
After Running
- Report the health score(s) to the user
- If failures exist, fix them before claiming completion
- If warnings exist, mention them but don't block
- If the project doesn't have a relevant doctor, suggest adding one
Rules
- Never skip doctors to save time. The 30 seconds a doctor takes prevents hours of debugging.
- If a doctor check fails, fix the root cause — don't suppress the check.
- If a failure pattern isn't caught by any existing doctor, propose a new check.
- In monorepos, run ALL doctors for changed surfaces, not just the one you think is relevant.
Related
wiki/concepts/doctor-pattern.md — the pattern definition and registrywiki/concepts/lint-enforced-agent-guardrails.md — enforcement hierarchyskills/personal/wiki-doctor/SKILL.md — wiki-specific doctor
