docguard-fixlisted

<!-- docguard:version: 0.34.9 --> # DocGuard Fix Skill ## User Input ```text $ARGUMENTS ``` You **MUST** consider the user input before proceeding (if not empty). If user specifies `--doc <name>`, focus on that single document. If no arguments, fix ALL issues found by `docguard diagnose`. ## Goal Research the actual codebase to generate or repair canonical documentation that passes DocGuard's 19-validator guard suite. This skill replaces generic templates with real, project-specific content and iterates until quality checks pass. ## Operating Constraints - **NEVER use placeholder content** — every section must reference real files, real modules, real dependencies - **ALWAYS back up before overwriting** — use `safeWrite()` pattern or create `.bak` files - **Maximum 3 validation iterations** — if still failing after 3 rounds, report remaining issues and stop - **Research before writing** — understand the codebase first, then generate documentation ## Execution Flow ### Step 0: Apply Mechanical Fixes First (no AI needed) ```bash npx docguard-cli fix --write 2>&1 ``` Removes endpoints documented in `docs-canonical/API-REFERENCE.md` that the OpenAPI spec confirms no longer exist (table row + detail block). Only edits `docguard:generated` docs, idempotent, prints what changed. Don't hand-edit these. ### Step 1: Diagnose Current State Run the diagnostic to identify all issues (each tagged `mechanical` or `agent`): ```bash npx docguard-cli diagnose 2>&1 ``` Parse the