// Run a comprehensive health check on the AIWG installation and workspace with pass/fail diagnostics and remediation steps
Guide for filing high-quality issues — template selection, environment capture, duplicate detection, and import flow for cross-tracker reports
AIWG addons + extensions language map — categories, curated discover phrases, and per-bundle pointers covering everything beyond the framework quickrefs
Guide for opening high-quality pull requests — template, verification gates, delivery-policy compliance, no-attribution rule, and CI-green-before-done discipline
Update AIWG CLI and redeploy frameworks/tools to current project without leaving the session
Regenerate platform context file with preserved team directives
Display workspace status dashboard showing installed frameworks, deployments, artifact counts, and health indicators
| name | aiwg-doctor |
| description | Run a comprehensive health check on the AIWG installation and workspace with pass/fail diagnostics and remediation steps |
| platforms | ["codex"] |
You run a comprehensive health check on the AIWG installation and workspace, reporting pass/fail for each diagnostic with remediation steps for any failures.
Alternate expressions and non-obvious activations (primary phrases are matched automatically from the skill description):
aiwg doctoraiwg doctor to isolate the issueaiwg doctoraiwg doctoraiwg doctoraiwg doctor| Pattern | Example | Action |
|---|---|---|
| Health check | "check health" / "is aiwg healthy" | Run aiwg doctor |
| Diagnostic request | "diagnose" / "run diagnostics" | Run aiwg doctor |
| Broken install | "aiwg isn't working" | Run aiwg doctor |
| Setup validation | "check my aiwg setup" | Run aiwg doctor |
| Troubleshooting | "troubleshoot installation" | Run aiwg doctor |
| Verbose check | "run full diagnostics" | Run aiwg doctor --verbose |
When triggered:
Extract intent:
Run the appropriate command:
# Standard health check
aiwg doctor
# Verbose output (additional detail per check)
aiwg doctor --verbose
The doctor command (tools/cli/doctor.mjs) validates:
.aiwg/frameworks/registry.json exists and is valid JSON.claude/agents/, .claude/commands/)git, node, npm)Report the result — present a summary of checks passed and failed. For each failure, include the remediation step from the doctor output. Common remediations:
aiwg use sdlc (or the appropriate framework)aiwg sync or aiwg updatenpm install -g aiwgUser: "Check AIWG health"
Extraction: Routine health check, no specific symptom
Action:
aiwg doctor
Response: "All checks passed. npm package v2026.3.15 installed, registry valid (2 frameworks), deployment verified for claude-code, Node.js v20.11.0 compatible."
User: "AIWG commands aren't showing up in Claude"
Extraction: User reports missing commands — deployment check is the likely culprit
Action:
aiwg doctor
Response: "Doctor found 1 issue: framework files are not deployed to .claude/commands/. Run aiwg sync to redeploy, then restart your Claude session."
User: "I just installed AIWG — is everything set up correctly?"
Extraction: New install, full validation requested
Action:
aiwg doctor
Response: "Installation looks good. One note: no frameworks are deployed yet. Run aiwg use sdlc to deploy the SDLC framework, or aiwg use all to deploy everything."
User: "Run full diagnostics on AIWG"
Extraction: Verbose check requested
Action:
aiwg doctor --verbose
Response: "Verbose diagnostics complete. [Output summary with per-check detail, paths, and versions.]"
If the user mentions a specific symptom before triggering doctor:
aiwg doctor to check your installation. Can you describe what you were trying to do when it broke?"