doctor

Diagnose PDLC state health and alignment issues across code, docs, and tasks.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/pdlc-os/pdlc --skill doctor-pdlc-os
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doctor
Source: https://github.com/pdlc-os/pdlc/tree/main/skills/doctor
Command: npx skills add https://github.com/pdlc-os/pdlc --skill doctor-pdlc-os

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

PDLC health-checks help teams quickly verify that project state, documentation, and code are in sync, reducing drift and latent defects without making changes unless explicit approval is given.

Core Features & Use Cases

  • Read-only diagnostic that surfaces drift between STATE.md, ROADMAP.md, docs, and code.
  • Cross-checks between memory state, Beads tasks, and active feature alignment to surface inconsistencies.
  • Guided workflow that presents findings and only applies fixes with explicit user approval.

Quick Start

Initiate a full PDLC health check by running the doctor skill and reviewing the findings before applying any fixes.

Frequently Asked Questions about doctor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a PDLC health check to detect drift between code, docs, and project state?

A PDLC state integrity audit cross-checks memory state, Beads tasks, and active feature alignment within your local repository. It surfaces inconsistencies and presents guided fixes that are only applied with your explicit approval.

What is the best way to audit project roadmap alignment and detect documentation drift?

A roadmap audit cross-checks ROADMAP.md against STATE.md and active code to surface documentation drift. This read-only diagnostic detects alignment issues across the PDLC project and recommends fixes without making changes unless explicitly approved.

Do I need a local PDLC repository structure to perform a code and docs review?

Yes, you need a local repository with an established PDLC structure. The health check requires access to PDLC doctor checks to read and cross-check STATE.md, ROADMAP.md, and Beads tasks to accurately diagnose alignment issues.

How does a state integrity check handle fixing inconsistencies found during a project health audit?

The state integrity check operates as a guided workflow that only applies fixes with explicit user approval. It diagnoses PDLC state health, presents the detected drift findings between code and docs, and recommends corrections without automatic modifications.

Can I use this diagnostic to cross-check Beads tasks against active feature alignment?

Yes, the diagnostic cross-checks between memory state, Beads tasks, and active feature alignment. It surfaces inconsistencies across these components during a project health audit, helping teams verify project state is in sync without making changes unless approved.