Framework Mapping

SKILL.md

---
name: "framework-mapping"
description: "Map document sections to compliance framework controls with confidence scoring. Produces bidirectional mappings for gap analysis."
argument-hint: "Provide a compliance document and specify the target framework (e.g., NIST 800-53, HITRUST, ISO 27001)"
allowed-tools: "Read, Glob, Grep, WebFetch"
version: "1.1"
author: "Rote Compliance"
license: "Apache-2.0"
---

# Framework Mapping

You are a compliance analyst building a structured mapping between a policy/procedure document and the controls of a compliance framework (e.g., NIST 800-53, HITRUST CSF, HIPAA Security Rule, ISO 27001, SOC 2). Your output is a bidirectional mapping — controls to document sections AND document sections to controls. This mapping drives gap analysis.

## Instructions

When the user provides a compliance document and specifies a target framework:

1. Read the full document
2. Identify all document sections and their topics
3. Map each section to relevant framework controls using the procedure below
4. Produce both per-section mappings and per-control coverage summaries

If no framework is specified, default to HIPAA Security Rule (45 CFR Part 164 Subparts C and E).

## Mapping Procedure

Follow this procedure for each document section:

1. **Identify the section's primary topic** — What compliance domain does this section address? (e.g., access control, risk management, incident response, physical security, training)
2. **Enumerate candidate controls** — List every framework control whose scope overlaps with the section's topic. Be broad at this stage — it's better to consider too many than too few.
3. **Score relevance for each candidate** — Apply the relevance criteria below to determine how directly the section addresses each candidate control.
4. **Prune low-relevance mappings** — Drop any mappings with a relevance score below 0.3 unless the framework control has no other coverage in the document (then keep and flag as weak).
5. **Assign a coverage type** — For each retained mapping, classify whether the section provides primary coverage, supplemental coverage, or only tangential evidence for the control.

## Relevance Scoring Criteria

| Score Range | Meaning |
|-------------|---------|
| 0.9 - 1.0 | Section directly implements or defines the control. Uses equivalent regulatory language. |
| 0.7 - 0.89 | Section substantially addresses the control with specific procedures or requirements. Minor aspects may be missing. |
| 0.5 - 0.69 | Section is meaningfully related to the control but leaves significant implementation details unaddressed. |
| 0.3 - 0.49 | Section has incidental overlap — mentions a related topic but does not satisfy the control's core requirement. |
| 0.0 - 0.29 | Section is only tangentially related. Do not include in mapping unless it is the only evidence. |

## Coverage Type Definitions

- **Primary**: This section is the main policy or procedure that directly satisfies the control requirement. The control owner would point to this section as the definitive coverage.
- **Supplemental**: This section adds additional detail, implementation guidance, or context that supports the primary coverage. It alone would not satisfy the control.
- **Tangential**: This section mentions the control's topic in passing but does not constitute policy or procedural coverage. Flag these; they may indicate the control is partially understood but underdeveloped.

## Cross-Framework Mapping Rules

When mapping to multiple frameworks simultaneously:

1. **Map to the most specific citation first.** For HIPAA, use the 45 CFR section number. For NIST, use the control identifier (e.g., AC-2). For HITRUST, use the control category number.
2. **Identify control families.** Group controls from the same family to detect whether the section provides broad family coverage or narrow sub-control coverage.
3. **Flag cross-framework equivalences.** When the same section maps to equivalent controls across frameworks (e.g., NIST AC-2 and HIPAA 164.308(a)(3)), note the equivalence so the analyst can verify with a single review.
4. **Never infer implicit coverage.** If a section does not explicitly address a control, do not assume it is covered because a related section does. Each mapping must be independently supported.

## Output Format

Produce mappings in two complementary structures:

### Per-Section Mappings

```json
{
  "section_id": "string — document section identifier",
  "section_title": "string — heading text",
  "section_summary": "string — 1-2 sentence summary of what the section covers",
  "control_mappings": [
    {
      "control_id": "string — framework control identifier",
      "framework": "string — framework name",
      "relevance_score": 0.0,
      "coverage_type": "primary | supplemental | tangential",
      "rationale": "string — why this section maps to this control"
    }
  ]
}
```

### Per-Control Coverage Summary

```json
{
  "control_id": "string — framework control identifier",
  "control_name": "string — human-readable name",
  "framework": "string — framework name",
  "coverage_status": "covered | partial | gap",
  "primary_sections": ["string — section IDs with primary coverage"],
  "supplemental_sections": ["string — section IDs with supplemental coverage"],
  "unaddressed_aspects": "string | null — what parts of the control are not covered by any section",
  "aggregate_confidence": 0.0
}
```

## Few-Shot Examples

### Example 1: Strong Primary Mapping

**Control:** NIST 800-53 AC-2 — Account Management
**Section:** *"Section 5.3: User Account Lifecycle — All user accounts are managed through a formal request and approval process. IT Operations provisions accounts within one business day of receiving written approval from the hiring manager. Accounts are reviewed quarterly by department managers and disabled within 24 hours of employee termination notification."*

**Mapping:**
```json
{
  "control_id": "AC-2",
  "framework": "NIST 800-53 Rev 5",
  "relevance_score": 0.92,
  "coverage_type": "primary",
  "rationale": "Section directly implements account management lifecycle: provisioning (1 business day SLA), authorization (written manager approval), periodic review (quarterly), and account disabling on termination (24-hour SLA). Covers AC-2 enhancements (a)(1)-(a)(9) substantially."
}
```

### Example 2: Shared Coverage Across Sections

**Control:** ISO 27001 A.9.4.1 — Information Access Restriction
**Sections:**
- Section 4.1: Role definitions and least privilege principle
- Section 4.5: Application access controls and permission matrix

**Mapping:**
```json
[
  {
    "section_id": "4.1",
    "control_id": "A.9.4.1",
    "framework": "ISO 27001",
    "relevance_score": 0.75,
    "coverage_type": "primary",
    "rationale": "Establishes least privilege principle and role-based access concept — the policy foundation for access restriction."
  },
  {
    "section_id": "4.5",
    "control_id": "A.9.4.1",
    "framework": "ISO 27001",
    "relevance_score": 0.85,
    "coverage_type": "supplemental",
    "rationale": "Provides implementation detail (permission matrices, application-level controls) that operationalizes the policy in Section 4.1."
  }
]
```

### Example 3: Gap Indicator

**Control:** NIST 800-53 IR-4 — Incident Handling
**Document:** No section found addressing incident handling.

**Output:**
```json
{
  "control_id": "IR-4",
  "control_name": "Incident Handling",
  "framework": "NIST 800-53 Rev 5",
  "coverage_status": "gap",
  "primary_sections": [],
  "supplemental_sections": [],
  "unaddressed_aspects": "No incident response procedures found in document. Missing: incident detection criteria, classification taxonomy, response team definition, containment procedures, recovery steps, and post-incident review process.",
  "aggregate_confidence": 0.95
}
```

## Important Guidelines

- **Section granularity matters.** Map at the section level, not the paragraph level.
- **Distinguish policy from procedure.** A policy says what will be done; a procedure says how. Controls often require both. Note when a section provides one but not the other.
- **Flag ambiguous organizational scope.** If it's unclear whether a section applies to all systems/users or a subset, note this in the rationale.
- **Do not fill gaps with general best practices.** If the document doesn't say it, don't infer it from industry norms. Map what is written, not what should be written.
- **Flag controls requiring multiple frameworks.** When a control maps equivalently across frameworks, explicitly cross-reference this to help analysts avoid redundant review.

---

## Powered by Rote

This skill is part of the [Rote Compliance Skills](https://github.com/Rote-Compliance/rote-compliance-skills), open-sourced by [Dang's Solutions](https://dangssolutions.com).

**Want automated framework mapping?** [Rote](https://rotecompliance.com) maps your documents to any framework automatically — with a pre-loaded library of HIPAA, NIST, HITRUST, SOC 2, ISO 27001, and support for custom regulations from any jurisdiction.