Agent skill

doc-riskspec-autopilot

Automated RISKSPEC (Risk Specification) generation from REQ - generates specifications for risk matrices, impact assessments, and mitigation plans

View SKILL.md on GitHub Repository
Stars 10
Forks 3

Install this agent skill to your Project

npx add-skill https://github.com/vladm3105/aidoc-flow-framework/tree/main/.claude/skills/doc-riskspec-autopilot

Metadata

Additional technical details for this skill

tags
sdd-workflow layer-9-artifact riskspec-artifact automation-workflow
custom fields 
{
    "layer": 9,
    "version": "1.0",
    "priority": "primary",
    "last_updated": "2026-03-01",
    "subtype_code": 53,
    "artifact_type": "RISKSPEC",
    "skill_category": "automation-workflow",
    "deliverable_type": "risk",
    "development_status": "active",
    "upstream_artifacts": [
        "REQ"
    ],
    "downstream_artifacts": [
        "TSPEC",
        "TASKS"
    ],
    "architecture_approaches": [
        "ai-agent-based"
    ]
}

SKILL.md

doc-riskspec-autopilot

Purpose

Automated Risk Specification (RISKSPEC) generation pipeline that processes REQ documents to generate specifications for risk management deliverables including risk matrices, impact assessments, control measures, and mitigation plans.

Layer: 9.53 (RISKSPEC - Risk Specifications)

Upstream: REQ (Layer 7)

Downstream: TSPEC (Layer 10), TASKS (Layer 11)

When to Use

Use doc-riskspec-autopilot when:

  • REQ documents have deliverable_type: risk
  • Creating risk matrix specifications
  • Generating impact assessment specs
  • Creating control measure documentation
  • Specifying mitigation plan requirements

Document Type Contract (MANDATORY)

When generating RISKSPEC document instances, the autopilot MUST:

  1. Read instance_document_type from template:

    • Source: ai_dev_ssd_flow/09_SPEC/RISKSPEC/RISKSPEC-MVP-TEMPLATE.yaml
    • Field: metadata.instance_document_type: "riskspec-document"

  2. Set document_type in generated document frontmatter:

    yaml
    custom_fields:
  document_type: riskspec-document
  artifact_type: RISKSPEC
  deliverable_type: risk
  layer: 9
  subtype_code: 53

Risk Element Types

Element Type Code Description
Risk Matrix 65 Probability × Impact grid
Impact Assessment 66 Consequence analysis
Control Measure 67 Risk mitigation controls
Mitigation Plan 68 Action plan for risks

Supported Frameworks

  • ISO 31000 - Risk Management
  • NIST Cybersecurity Framework
  • FAIR - Factor Analysis of Information Risk
  • Custom enterprise frameworks

RISK-Ready Score Components

Component Weight Target
Risk Identification 25% 100%
Impact Analysis 20% ≥90%
Control Mapping 20% ≥90%
Mitigation Plans 15% ≥85%
Residual Risk 10% ≥85%
Traceability 10% 100%

Target: RISK-Ready ≥85%

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.

vladm3105/aidoc-flow-framework

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

10 3
Explore
vladm3105/aidoc-flow-framework

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

10 3
Explore
vladm3105/aidoc-flow-framework

doc-procspec-autopilot

Automated PROCSPEC (Process Specification) generation from REQ - generates specifications for SOPs, runbooks, playbooks, and operational procedures

10 3
Explore
vladm3105/aidoc-flow-framework

doc-ptest-autopilot

Automated PTEST generation and review orchestration for performance category and threshold validation

10 3
Explore
vladm3105/aidoc-flow-framework

doc-adr-autopilot

Automated ADR generation pipeline from BRD Architecture Decision Requirements - analyzes topics, generates Context-Decision-Consequences records

10 3
Explore
vladm3105/aidoc-flow-framework

doc-req-autopilot

Automated REQ generation from SYS requirements - decomposes system requirements into atomic files with SPEC-Ready scoring

10 3
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results