Skip to content

KamiJeong/tech-bridge-book / .agents/skills/speckit-docguard-guard

speckit-docguard-guard

Verified

Run 19-validator quality gate with severity triage and actionable remediation

DocGuard Guard

Validate your project against its canonical documentation. Runs 160+ automated checks across 19 validators.

User Input

$ARGUMENTS

You MUST consider the user input before proceeding (if not empty).

Execution

  1. Run DocGuard guard validation:
npx --yes docguard-cli@latest guard $ARGUMENTS
  1. Parse each validator's result and build a severity-ranked findings table.

  2. Triage by severity:

    • CRITICAL: Structure, Security, Test-Spec failures → fix immediately
    • HIGH: Doc Sections, Drift, Changelog, Traceability → fix before commit
    • MEDIUM: Freshness, Docs-Coverage, Doc-Quality, Metrics → fix this sprint
    • LOW: TODO-Tracking, Schema-Sync, Spec-Kit, Metadata → fix when convenient
  3. For each failing check, provide an exact fix — specific file, section, and content.

  4. Re-run guard after fixes. Iterate until all checks pass (max 3 iterations).

Validators (19 total)

ValidatorWhat It Checks
StructureRequired CDD files exist
Doc SectionsCanonical docs have required sections
Docs-SyncExternal doc references are valid
Drift// DRIFT: comments have DRIFT-LOG entries
ChangelogCHANGELOG.md is maintained
Test-SpecTEST-SPEC.md matches actual test files
EnvironmentEnvironment docs and .env.example exist
SecurityNo hardcoded secrets, .gitignore configured
ArchitectureLayer boundaries and diagrams present
FreshnessDocs updated after recent code changes
TraceabilityCanonical docs linked to source code
Docs-DiffEntity/route/field drift between code and docs
Metadata-SyncMetadata headers are consistent
Docs-CoverageAll config files documented
Doc-QualityReadability, IEEE 830 compliance
TODO-TrackingTODOs are tracked
Schema-SyncSchema documentation matches code
Spec-KitSpec quality (FR-IDs, sections)
Metrics-ConsistencyInternal counts are accurate

Flags

  • --format json — Output results as JSON
  • --dir <path> — Run on a different directory
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall