sdlc-doctor

Diagnose Speculator SDLC workflow environment health via Git, files, plugins, and CLI checks.

Updated Mar 5, 2026
One-click install
npx skills add https://github.com/DMokong/speculator --skill sdlc-doctor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sdlc-doctor
Source: https://github.com/DMokong/speculator/tree/main/skills/sdlc-doctor
Command: npx skills add https://github.com/DMokong/speculator --skill sdlc-doctor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill diagnoses and verifies that your development environment is correctly configured for the Speculator SDLC workflow, catching potential issues before they disrupt your development process.

Core Features & Use Cases

  • Environment Checks: Validates Git repository status, branch, and worktree configuration.
  • File Validation: Ensures essential configuration files like CLAUDE.md and .claude/sdlc.local.md are present and correctly formatted.
  • Plugin & Hook Verification: Confirms the SDLC plugin is loaded and pre-commit hooks are registered.
  • Spec & Lock Health: Scans for active specs, checks their status, and identifies stale or aged lock files.
  • Dependency Check: Verifies the presence of the beads CLI for issue tracking.
  • Auto-Fix Capabilities: Attempts to resolve common issues like missing directories or stale lock files when invoked with --fix.
  • Initialization: Guides users through setting up a default configuration with the --init flag.

Quick Start

Run /sdlc doctor to check your current environment's health.

Frequently Asked Questions about sdlc-doctor

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

FAQPage Schema
How do I check if my Git environment is configured correctly for the SDLC workflow?

Use a diagnostic tool to check your Git environment for the SDLC workflow by validating repository status, branch, and worktree configuration to catch potential issues early.

What is the best way to diagnose missing configuration files in a Speculator project?

The best way to diagnose missing configuration files in a Speculator project is to run an environment check that scans for essential files like CLAUDE.md and .claude/sdlc.local.md to verify their presence and formatting.

Can I automatically fix stale lock files and missing spec directories?

Yes, you can automatically fix stale lock files and missing spec directories by running the environment diagnostic with a fix flag to resolve common configuration issues automatically.

Does the SDLC environment check verify pre-commit hooks and plugin wiring?

Yes, the SDLC environment check verifies pre-commit hooks and plugin wiring by confirming the SDLC plugin is loaded and validating that pre-commit hooks are registered in your project.

Why does my SDLC workflow require the beads CLI to be installed?

Your SDLC workflow requires the beads CLI to be installed because it provides the dependency check for issue tracking, ensuring your development environment has all necessary tools for the Speculator workflow.

How do I initialize a default configuration for my SDLC project environment?

To initialize a default configuration for your SDLC project environment, run the diagnostic tool with an initialization flag to guide you through setting up the default configuration for the Speculator workflow.