Gap Details
Understanding the full gap detail view and all available information.
Gap Details
The gap detail view provides comprehensive information about a compliance gap. This page explains each section and how to use the information effectively.
Opening Gap Details
Access the detail view by:
- Clicking a gap row in the gaps list
- Direct URL - Each gap has a unique URL you can bookmark or share
- From document details - Click a gap in the document's gap list
Detail View Layout
The gap detail view is organized into sections:
Header Section
| Element | Description |
|---|---|
| Gap Title | Descriptive name of the gap |
| Severity Badge | Color-coded severity indicator |
| Status Badge | Current status with color |
| Edit Button | Modify gap properties |
| Actions Menu | Additional actions (workflow, export, delete) |
Main Content
The main area shows the gap description—a detailed explanation of what's missing or incomplete.
Information Tabs
Overview Tab
Primary gap information:
| Field | Description |
|---|---|
| Description | Full explanation of the gap |
| Framework | Associated compliance framework |
| Control | Specific control requirement |
| Severity | Critical, High, Medium, or Low |
| Status | Open, In Progress, Resolved, Accepted |
| Created | Date and time gap was identified |
| Last Updated | Most recent change |
AI Analysis Tab
For AI-identified gaps:
| Field | Description |
|---|---|
| Confidence Score | How certain the AI is (0-100%) |
| Reasoning | AI's explanation for identifying this gap |
| Source Document | Which document was analyzed |
| Relevant Excerpts | Portions of the document reviewed |
| Control Mapping | How this maps to framework controls |
Review the AI reasoning to understand why the gap was identified. High confidence scores (80%+) indicate strong evidence of the gap. Lower scores suggest potential uncertainty.
Related Items Tab
Connected items across the platform:
| Item Type | Description |
|---|---|
| Documents | Source document and related evidence |
| Workflows | Remediation workflows addressing this gap |
| Tasks | Individual tasks linked to this gap |
| Risks | Risk entries created from this gap |
| Controls | Framework controls affected |
Activity Tab
Complete history of the gap:
| Entry Type | Information Shown |
|---|---|
| Status Changes | When status changed and by whom |
| Edits | Property modifications |
| Comments | Team discussions |
| Workflow Updates | Remediation progress |
| System Events | Automatic updates |
Understanding Gap Properties
Severity Assessment
Severity indicates how critical the gap is:
| Severity | When Assigned | Action Timeline |
|---|---|---|
| Critical | Compliance violation, audit failure | Immediate (days) |
| High | Significant deficiency | Short-term (weeks) |
| Medium | Moderate issue | Medium-term (months) |
| Low | Minor improvement | When convenient |
Status Meaning
| Status | What It Means | Next Actions |
|---|---|---|
| Open | Needs attention | Triage and assign |
| In Progress | Being remediated | Monitor workflow |
| Resolved | Fixed with evidence | Verify and close |
| Accepted | Risk acknowledged | Document acceptance |
Control Mapping
The gap is linked to a specific control:
- Control ID - Framework's control identifier (e.g., CC6.1)
- Control Name - Human-readable control name
- Control Description - Full requirement text
- Control Family - Parent category in the framework
Reading AI Analysis
Confidence Score
The confidence score reflects AI certainty:
| Score Range | Meaning |
|---|---|
| 90-100% | High confidence, clear gap |
| 70-89% | Good confidence, likely valid |
| 50-69% | Moderate, may need review |
| Below 50% | Low, recommend manual review |
AI Reasoning
The reasoning section explains:
- What the AI looked for
- What it found (or didn't find)
- Why this constitutes a gap
- Specific evidence from the document
Source Excerpts
Quoted sections from the analyzed document:
- Shows what the AI reviewed
- Highlights relevant text
- Click to jump to document location
Taking Action on Gaps
From the Detail View
Update Status
Click the status badge to change status. Add notes explaining the change.
Change Severity
Edit the gap to adjust severity if the initial assessment needs correction.
Create Workflow
Click "Create Workflow" to build a remediation plan for this gap.
Add to Existing Workflow
Link the gap to an existing workflow that addresses similar issues.
Add Comment
Discuss the gap with your team in the comments section.
Quick Actions
| Action | Description |
|---|---|
| Copy Link | Share the gap URL with teammates |
| Export | Download gap details as PDF |
| Print for documentation | |
| Create Risk | Generate a risk entry from this gap |
Comments and Collaboration
Adding Comments
- Scroll to the comments section
- Type your comment in the text box
- @mention teammates for notifications
- Click "Post" to add the comment
Comment Best Practices
- Be specific - Reference exact concerns or questions
- Tag relevant people - Use @mentions for visibility
- Track decisions - Document reasoning for future reference
- Link related items - Reference other gaps, documents, or tasks
Linking Evidence
When resolving a gap, link supporting evidence:
- Click "Add Evidence" in the detail view
- Select from existing documents or upload new
- Explain how the evidence addresses the gap
- Mark the gap as resolved
Good Evidence
- Policies - Written commitments to the requirement
- Procedures - Step-by-step implementation guides
- Screenshots - Configuration or implementation proof
- Records - Logs, reports, or attestations
Common Questions
Can I merge duplicate gaps?
If you find duplicates:
- Keep the gap with more complete information
- Add notes referencing the duplicate
- Mark the duplicate as resolved (not deleted)
- Note in resolution: "Consolidated with [gap link]"
How do I split a gap that's too broad?
If a gap covers multiple issues:
- Create new gaps for each distinct issue
- Link them in comments
- Mark the original as resolved with note
- Assign appropriate severity to each new gap
What if I disagree with the AI assessment?
If the AI got it wrong:
- Review the AI reasoning carefully
- If truly invalid, mark as resolved with explanation
- If partially valid, adjust severity or scope
- Add comments explaining your assessment
Next Steps
- Updating Status - Change gap status
- AI Analysis - Understand AI confidence
- Creating Workflows - Build remediation plans