Swain Doctor

Runs at every session start to validate your swain project setup: governance blocks in instructions, tool availability, memory directories, ticket structure, script permissions, and the .agents directory. It auto-migrates legacy .beads directories to .tickets, repairs stale artifact indexes, and fixes broken worktree layouts that don't match ADR conventions. The detection logic lives in a consolidated bash script that outputs structured JSON, then remediation happens selectively based on what actually failed. It's idempotent and safe to run manually whenever something feels off. If you're jumping between worktrees or onboarding to an existing swain repo, this is what catches configuration drift before it bites you mid-session.

Install to Claude Code

npx -y skills add cristoslc/swain --skill swain-doctor --agent claude-code