speckit-docguard-review

Diagnose documentation issues and generate AI-ready fix prompts

SKILL.md

GitHub

DocGuard Diagnose

Runs guard validation, analyzes failures, and generates AI-ready prompts to fix documentation issues.

User Input

$ARGUMENTS

Steps

  1. Run DocGuard diagnose on the current project:
npx --yes docguard-cli@latest diagnose $ARGUMENTS
  1. Review the output:

    • Issues found — categorized as errors or warnings
    • Remediation plan — ordered list of fix commands
    • AI-ready prompt — copy/paste to your AI agent for automated fixes
  2. For multi-perspective analysis, add --debate to get three-agent prompts (Advocate/Challenger/Synthesizer).

Flags

  • --format json — Output as JSON
  • --debate — Generate multi-perspective AI prompts
  • --dir <path> — Run on a different directory

Research

Inspired by AITPG (IEEE TSE 2026) multi-agent prompting and TRACE (IEEE TMLCN 2026) calibrated quality evaluation.