aidlc-doctor

Diagnose repository compliance against an 18-item AI-native template without modifying files.

1|Updated Feb 16, 2026
One-click install
npx skills add https://github.com/codepresso-dev/codepresso-ai-plugin --skill aidlc-doctor-codepresso-dev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: aidlc-doctor
Source: https://github.com/codepresso-dev/codepresso-ai-plugin/tree/main/skills/aidlc-doctor
Command: npx skills add https://github.com/codepresso-dev/codepresso-ai-plugin --skill aidlc-doctor-codepresso-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams adopting AI-agent-friendly repository structures need a way to measure how compliant an existing repo is and detect drift over time, without risking unintended file changes during the audit. ## Core Features & Use Cases - Read-only compliance scan: Runs aidlc-cli.mjs scan against a target path and reports an 18-item table with status, evidence, and reason for each item, plus an overall percentage. - Profile-aware scoring: When .codepresso/state/aidlc-profile.json exists, it passes the profile so items are scored honestly against the team's actual tools and host instead of a generic baseline. - Gap explanation and secrets surfacing: Explains functional scoring nuances (e.g., a pre-push script not wired to a git hook scores partial), flags detected secrets in masked form with rotation advice, and marks items requiring manual setup. - Use Case: After scaffolding a repo with aidlc-init, re-run this skill monthly to check whether CI workflows, code indexes, or hooks have drifted out of compliance. ## Quick Start Ask the AI to run /codepresso:aidlc-doctor on your repository path to see its AI-native compliance score and missing items.

Frequently Asked Questions about aidlc-doctor

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

FAQPage Schema
How do I check if my repository is AI-agent friendly?▼

Run the aidlc-doctor scan against your repository path to get an 18-item compliance table with status, evidence, and reasoning for each item, plus an overall percentage score. It is read-only, so nothing in the repo is changed.

How to re-check AI-native compliance drift over time?▼

Re-run the scan periodically against the same repository. Because scoring is functional rather than cosmetic, items that silently break—like a stale code index or an unwired git hook—will drop in score and appear as gaps.

Why does my pre-push hook score partial in the compliance scan?▼

A pre-push item scores partial when the script exists in the repo but is not wired to an actual git hook. Scoring is functional, so files that exist but are not connected to the workflow do not earn full credit.

Does the compliance scan modify any repository files?▼

No, the scan is strictly read-only and never writes or modifies files. To fix identified gaps, the report suggests running the companion aidlc-init scaffolder, which handles file creation separately.

What happens when the scan detects secrets in my repo?▼

Detected secrets are surfaced as a red-flag finding with the value masked, along with a recommendation to rotate the credential. The raw secret value is never echoed in the report output.