speckit-docguard-score

Calculate CDD maturity score with multi-signal quality breakdown

SKILL.md

GitHub

DocGuard Score

Calculate your project's Canonical-Driven Development maturity score (0-100) across 8 weighted categories.

User Input

$ARGUMENTS

Steps

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

    • Structure (25%) — required files present
    • Doc Quality (20%) — docs have required sections
    • Testing (15%) — test spec alignment
    • Security (10%) — no hardcoded secrets
    • Environment (10%) — env docs configured
    • Drift (10%) — drift tracking discipline
    • Changelog (5%) — changelog maintenance
    • Architecture (5%) — layer boundary compliance
  2. For per-signal quality labels, add --signals.

Grading

Score Grade Status
90-100 A Strong CDD compliance
75-89 B Good, some gaps
50-74 C Needs work
< 50 D Significant gaps

Flags

  • --signals — Show multi-signal CJE composite breakdown with quality labels
  • --tax — Show estimated maintenance effort
  • --format json — Output as JSON