docguard-fix

Diagnose and repair canonical project documentation with codebase research and validator compliance.

Updated Mar 18, 2026
One-click install
npx skills add https://github.com/raccioly/coach-gravity --skill docguard-fix
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: docguard-fix
Source: https://github.com/raccioly/coach-gravity/tree/main/.agent/skills/docguard-fix
Command: npx skills add https://github.com/raccioly/coach-gravity --skill docguard-fix

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Canonical project documentation often lags behind the actual codebase. This Skill researches the real repository to replace placeholders with accurate, up-to-date content that reflects current structure and behavior.

Core Features & Use Cases

  • Real-time codebase research to generate canonical documentation that passes DocGuard validators.
  • Backups before overwriting existing docs and safe write patterns to preserve editor input.
  • Iterative quality checks with guardrails to ensure accuracy and consistency.

Quick Start

Run the docguard fix against this repository to repair and validate all documentation.

Frequently Asked Questions about docguard-fix

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

FAQPage Schema
How do I fix outdated project documentation that no longer matches my codebase?

To fix outdated project documentation, this Skill researches your actual codebase and replaces placeholders with accurate content across files like ARCHITECTURE.md and SECURITY.md. It ensures consistency, enforces frontmatter presence, and applies guard-driven quality checks.

What is the best way to validate canonical docs against repository structure?

Validating canonical docs against repository structure is handled by researching the codebase to enforce section completeness and validator compliance. It applies iterative guard-driven quality checks across ARCHITECTURE.md, SECURITY.md, TEST-SPEC.md, DATA-MODEL.md, and ENVIRONMENT.md.

How do I repair placeholder content in ARCHITECTURE.md and DATA-MODEL.md files?

Repairing placeholder content in ARCHITECTURE.md and DATA-MODEL.md files involves researching the real codebase to generate accurate, up-to-date content. This process replaces placeholders and enforces frontmatter presence for validator compliance.

Does docguard-fix create backups before overwriting existing documentation?

Yes, before overwriting existing documentation, this Skill creates backups and uses safe write patterns to preserve editor input. This ensures your original files are protected while replacing placeholders with real content.

Why does my project documentation fail DocGuard validators?

Project documentation fails DocGuard validators when placeholders remain or sections are incomplete. This Skill diagnoses and repairs canonical docs by enforcing frontmatter presence, section completeness, and guard-driven quality checks based on real codebase research.