Agent skill
doc-riskspec-audit
Unified RISKSPEC quality gate - validates structure, detects issues, computes RISK-Ready score
Install this agent skill to your Project
npx add-skill https://github.com/vladm3105/aidoc-flow-framework/tree/main/.claude/skills/doc-riskspec-audit
Metadata
Additional technical details for this skill
- tags
-
sdd-workflow layer-9-artifact riskspec-artifact quality-assurance
- custom fields
-
{ "layer": 9, "version": "1.0", "priority": "primary", "last_updated": "2026-03-01", "subtype_code": 53, "artifact_type": "RISKSPEC", "skill_category": "quality-assurance", "deliverable_type": "risk", "development_status": "active", "upstream_artifacts": [ "RISKSPEC" ], "downstream_artifacts": [ "Audit Report" ], "architecture_approaches": [ "ai-agent-based" ] }
SKILL.md
doc-riskspec-audit
Purpose
Unified RISKSPEC quality gate that combines structural validation, content review, and RISK-Ready scoring.
Layer: 9.53 (RISKSPEC Quality Gate)
RISK-Ready Score Calculation
| Component | Weight | Scoring Criteria |
|---|---|---|
| Risk Identification | 25% | All risks identified |
| Impact Analysis | 20% | Ratings justified |
| Control Mapping | 20% | Controls defined |
| Mitigation Plans | 15% | Actions specified |
| Residual Risk | 10% | Post-mitigation assessed |
| Traceability | 10% | Cumulative tags present |
Thresholds:
- PASS: ≥85%
- CONDITIONAL: 75-84%
- FAIL: <75%
Output Files
| File | Purpose |
|---|---|
RISKSPEC-NN.A_audit_report_vNNN.md |
Audit report |
References
- Template:
ai_dev_ssd_flow/09_SPEC/RISKSPEC/RISKSPEC-MVP-TEMPLATE.yaml - Schema:
ai_dev_ssd_flow/09_SPEC/RISKSPEC/RISKSPEC_MVP_SCHEMA.yaml
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
doc-spec-reviewer
Comprehensive content review and quality assurance for SPEC documents - validates YAML structure, REQ coverage, interface definitions, and identifies issues requiring manual attention
doc-prd-fixer
Automated fix skill that reads review reports and applies fixes to PRD documents - handles broken links, element IDs, missing files, and iterative improvement
doc-procspec-autopilot
Automated PROCSPEC (Process Specification) generation from REQ - generates specifications for SOPs, runbooks, playbooks, and operational procedures
doc-riskspec-autopilot
Automated RISKSPEC (Risk Specification) generation from REQ - generates specifications for risk matrices, impact assessments, and mitigation plans
doc-ptest-autopilot
Automated PTEST generation and review orchestration for performance category and threshold validation
doc-adr-autopilot
Automated ADR generation pipeline from BRD Architecture Decision Requirements - analyzes topics, generates Context-Decision-Consequences records
Didn't find tool you were looking for?