Stats
Actions
Tags
Help us improve
Share bugs, ideas, or general feedback.
From aidoc-flow
Audits PRD documents with structural and content-quality checks, producing a combined report used by doc-prd-fixer. Run before EARS generation.
npx claudepluginhub vladm3105/aidoc-flow-framework --plugin aidoc-flowHow this skill is triggered — by the user, by Claude, or both
Slash command
/aidoc-flow:doc-prd-auditThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Run a **unified PRD audit** — declarative structural checks plus content-quality
Evaluates PRD quality across three dimensions (completeness, clarity, rigor) as a gate before research. Score ≥7 passes.
Reviews Product Requirements Documents (PRDs) for structure, business logic, testability, traceability metadata, and 1:N split compliance using lint script. Use after PRD completion for quality gate.
Audits a BRD with structural checks and content review, producing a combined report for the fixer skill. Use as a quality gate before PRD generation.
Share bugs, ideas, or general feedback.
Run a unified PRD audit — declarative structural checks plus content-quality
review — in one pass, producing a single combined report that
../doc-prd-fixer/SKILL.md consumes. The framework ships no runtime code, so
this skill is the validator: Claude performs each check directly against the
PRD using the spec as the contract.
Layer: 2 (PRD quality gate). Upstream: a PRD file. Downstream:
PRD-NN.A_audit_report_vNNN.md and an optional fix-cycle trigger.
Use after a PRD exists and before generating EARS, or inside the autopilot's
audit↔fix cycle. Do not use to create a PRD (use ../doc-prd/SKILL.md or
../doc-prd-autopilot/SKILL.md).
Fresh-audit policy: always audit from scratch — never reuse prior scores or cached results; compute the EARS-Ready score independently each run.
Report cleanup: after writing the new report, delete superseded
PRD-NN.A_audit_report_v*.md; keep PRD-NN.F_fix_report_v*.md and
.drift_cache.json. Record a cleanup summary in the report.
Input: PRD path (docs/02_PRD/PRD-NN_*/...); optional score threshold
(default 90).
Sequence: 1) run structural checks → 2) record findings → 3) run content
review → 4) merge/normalize findings → 5) write PRD-NN.A_audit_report_vNNN.md
→ 6) if auto-fixable findings exist, hand off to doc-prd-fixer.
Authority: framework/layers/02_PRD/README.md,
framework/layers/02_PRD/PRD-TEMPLATE.yaml (embedded rules), and
framework/governance/ID_NAMING_STANDARDS.md.
Tier 1 — blocking (error):
| Check | Verifies |
|---|---|
| Element ID format | every ID matches PRD.NN.SS.xxxx (4-hex hash); SS = host section |
| Structure | all 15 template sections present and non-empty |
| Cumulative tags | @brd: tags present and resolving to existing BRD elements |
| Customer-facing content | §10 substantive in ≥3 categories (not placeholders) |
| Quality gate | EARS-Ready score ≥ threshold (default 90) |
Tier 2 — advisory (warning): frontmatter metadata (below); §8 holds
PRD-level summaries with the layer-separation note; internal links and
template/governance references resolve; no ADR numbers cited before they exist;
thresholds consistent across sections and with the BRD source; diagram contract
tags present (@diagram: c4-l2, @diagram: dfd-l2, @diagram: sequence-sync
with alt/else — use ../charts-flow/SKILL.md).
Combined status: PASS only if all Tier 1 pass and content score ≥
threshold and no blocking issues; otherwise FAIL.
| Field | Required | Valid values |
|---|---|---|
document_type | yes | prd-document (not template) |
artifact_type | yes | PRD |
layer | yes | 2 |
deliverable_type | yes | code, document, ux, risk, process |
Findings: VALID-M001 missing deliverable_type; VALID-M002 invalid value;
VALID-M003 document_type not prd-document.
Output: PRD-NN.A_audit_report_vNNN.md, with sections — Summary (ID,
timestamp, overall status, structural status, content score) · Score
Calculation (100 − deductions, threshold compare) · Metadata Findings ·
Structural Findings · Content Findings · Diagram Contract Findings ·
Fix Queue (auto_fixable / manual_required / blocked) · Recommended
Next Step · Cleanup Summary.
Normalize every finding to: source (structural|content), code,
severity (error|warning|info), file, section, action_hint,
confidence (auto-safe|auto-assisted|manual-required). doc-prd-fixer
consumes the latest PRD-NN.A_audit_report_vNNN.md.
Before applying defaults, read the project adaptation profile
(.aidoc/profile.yaml). Honor only this skill's declared knobs:
section_toggles (a toggled-off optional section is not a finding; a
missing required section still is), active_layers (never flag the
absence of — or a missing reference to — a layer the project disabled, per the
cascade rule), and audit_threshold (use the project's quality-gate score
only when it is >= the framework default; ignore any lower value). Ignore
unknown keys.
Authority: framework/governance/ADAPTATION.md.
../doc-prd/SKILL.md · Fix: ../doc-prd-fixer/SKILL.md · Generate:
../doc-prd-autopilot/SKILL.mdframework/layers/02_PRD/README.md,
framework/layers/02_PRD/PRD-TEMPLATE.yaml,
framework/governance/ID_NAMING_STANDARDS.md