docguard-guard

Convert DocGuard guard output into a severity-triaged CDD compliance report.

Updated Mar 16, 2026
One-click install
npx skills add https://github.com/B0yZ4kr14/OrthoPlus-Enterprise --skill docguard-guard-b0yz4kr14
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: docguard-guard
Source: https://github.com/B0yZ4kr14/OrthoPlus-Enterprise/tree/main/.agent/skills/docguard-guard
Command: npx skills add https://github.com/B0yZ4kr14/OrthoPlus-Enterprise --skill docguard-guard-b0yz4kr14

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill turns raw DocGuard guard output into a prioritized, commit-ready quality assessment that you can act on immediately, reducing the chance of merging documentation drift or missing Canonical-Driven Development requirements.

Core Features & Use Cases

  • Automated Guard Execution: Runs DocGuard’s 19-validator suite via DocGuard CLI (or local dev mode) to obtain machine-readable results.
  • Severity Triage & Routing: Parses findings, maps them to PASS/WARN/FAIL, and categorizes issues by CRITICAL/HIGH/MEDIUM/LOW to guide what to fix first.
  • Actionable Remediation Plan: Produces specific next steps, including targeted file/section fixes and recommended follow-up actions (including optional automated chaining to a fix skill).

Use case example: After updating documentation or implementing a feature, run this Skill to identify which CDD validators failed (e.g., missing canonical docs or traceability breaks), then generate a remediation plan you can address before committing.

Quick Start

Run the Skill after installing DocGuard, and ask it to validate the current repository with docguard-guard so it returns a triaged guard report with recommended fixes.

Frequently Asked Questions about docguard-guard

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

FAQPage Schema
How do I validate documentation for Canonical-Driven Development compliance?▼

To validate CDD compliance, run a guard validation command that checks structural documentation, section completeness, and API surface traceability. This generates a severity-triaged report classifying issues as PASS, WARN, or FAIL to guide your remediation workflow before committing.

Why does documentation drift happen after feature implementation?▼

Documentation drift happens when implementation changes outpace updates to canonical docs, creating changelog gaps and misaligned drift-comments. Running a guard validator detects these breaks by assessing API surface traceability and structural completeness against the actual codebase.

Do I need the DocGuard CLI installed to run CDD quality gates?▼

Yes, you need a functioning DocGuard CLI or a local dev mode runner installed to execute the guard command. The validator requires detecting a CDD project root to execute its 19-validator suite and capture real output for triage.

What's the best way to triage documentation quality issues before a commit?▼

The best way to triage documentation quality issues is to run a guard validation suite that categorizes findings by CRITICAL, HIGH, MEDIUM, and LOW severity. This produces an actionable remediation plan with targeted file and section fixes needed before merging.

When should I run Spec-Kit related validations in my dev workflow?▼

You should run Spec-Kit validations after updating documentation or completing an implementation phase. This assesses structural documentation, section completeness, changelog gaps, and drift-comment alignment to ensure no CDD requirements are missing before committing.

Can I generate a remediation plan for missing canonical docs automatically?▼

Yes, running a guard validation command automatically generates a remediation plan for missing canonical docs. It maps validator failures to severity levels and produces specific next steps, including targeted file fixes and optional automated chaining to a fix skill.