Skill

pactkit-doctor

Diagnose project health status

Install

npx claudepluginhub pactkit/claude-code-plugin --plugin pactkit

Tool Access

This skill uses the workspace's default tool permissions.

Preview

Diagnostic tool for project health — config drift, missing files, stale graphs, orphaned specs.

SKILL.md

Similar Skills

kotlin-ktor-patterns

Provides Ktor server patterns for routing DSL, plugins (auth, CORS, serialization), Koin DI, WebSockets, services, and testApplication testing.

everything-claude-code

163.2k

deep-research

Conducts multi-source web research with firecrawl and exa MCPs: searches, scrapes pages, synthesizes cited reports. For deep dives, competitive analysis, tech evaluations, or due diligence.

everything-claude-code

163.2k

inventory-demand-planning

Provides demand forecasting, safety stock optimization, replenishment planning, and promotional lift estimation for multi-location retailers managing 300-800 SKUs.

everything-claude-code

163.2k

Stats

Parent Repo Stars4

Parent Repo Forks0

Last CommitMar 21, 2026

Actions

View Source View Plugin View on GitHub View README

PactKit Doctor

Diagnostic tool for project health — config drift, missing files, stale graphs, orphaned specs.

When Invoked

Init (auto-check): Verify project structure after initialization.

Standalone diagnostic when project health is in question.

Severity Levels

Level

Meaning

INFO

Informational, no action required

WARN

Potential issue, should be addressed

ERROR

Critical mismatch, must be fixed

Protocol

1. Run Deterministic Checks

Run pactkit doctor to perform automated diagnostics:

Orphaned/Missing Specs: Cross-references docs/specs/ vs board + archive.

Config Drift: Compares pactkit.yaml items vs deployed files.

Stale Graphs: Checks docs/architecture/graphs/*.mmd mtimes vs source files.

2. Structural Health (Manual)

Run visualize to check architecture graph generation.

Run visualize --mode class for class diagram verification.

Check docs/test_cases/ existence.

3. Infrastructure & Data

Verify pactkit.yaml exists (in .claude/pactkit.yaml or .opencode/pactkit.yaml) and is valid.

Check if tests/e2e/ is empty.

4. Report

Output a structured health report grouped by category:

PactKit Doctor

Diagnostic tool for project health — config drift, missing files, stale graphs, orphaned specs.

When Invoked

Init (auto-check): Verify project structure after initialization.
Standalone diagnostic when project health is in question.

Severity Levels

Level	Meaning
INFO	Informational, no action required
WARN	Potential issue, should be addressed
ERROR	Critical mismatch, must be fixed

Protocol

1. Run Deterministic Checks

Run pactkit doctor to perform automated diagnostics:

Orphaned/Missing Specs: Cross-references docs/specs/ vs board + archive.
Config Drift: Compares pactkit.yaml items vs deployed files.
Stale Graphs: Checks docs/architecture/graphs/*.mmd mtimes vs source files.

2. Structural Health (Manual)

Run visualize to check architecture graph generation.
Run visualize --mode class for class diagram verification.
Check docs/test_cases/ existence.

3. Infrastructure & Data

Verify pactkit.yaml exists (in .claude/pactkit.yaml or .opencode/pactkit.yaml) and is valid.
Check if tests/e2e/ is empty.

4. Report

Output a structured health report grouped by category:

Category	Check Item	Severity	Description
Architecture	Graph Freshness	INFO/WARN	Stale if > 7 days
Specs	Orphaned Specs	INFO	Specs without board entries
Specs	Missing Specs	WARN	Board stories without specs
Config	Drift Detection	ERROR	pactkit.yaml vs deployed
Tests	Test Suite	INFO/WARN	Test runner status

End with overall status: "Health: OK" (no WARN/ERROR) or "Health: NEEDS ATTENTION" (WARN/ERROR found).