PartnerAlly Docs
Compliance Gaps

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

ElementDescription
Gap TitleDescriptive name of the gap
Severity BadgeColor-coded severity indicator
Status BadgeCurrent status with color
Edit ButtonModify gap properties
Actions MenuAdditional 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:

FieldDescription
DescriptionFull explanation of the gap
FrameworkAssociated compliance framework
ControlSpecific control requirement
SeverityCritical, High, Medium, or Low
StatusOpen, In Progress, Resolved, Accepted
CreatedDate and time gap was identified
Last UpdatedMost recent change

AI Analysis Tab

For AI-identified gaps:

FieldDescription
Confidence ScoreHow certain the AI is (0-100%)
ReasoningAI's explanation for identifying this gap
Source DocumentWhich document was analyzed
Relevant ExcerptsPortions of the document reviewed
Control MappingHow 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.

Connected items across the platform:

Item TypeDescription
DocumentsSource document and related evidence
WorkflowsRemediation workflows addressing this gap
TasksIndividual tasks linked to this gap
RisksRisk entries created from this gap
ControlsFramework controls affected

Activity Tab

Complete history of the gap:

Entry TypeInformation Shown
Status ChangesWhen status changed and by whom
EditsProperty modifications
CommentsTeam discussions
Workflow UpdatesRemediation progress
System EventsAutomatic updates

Understanding Gap Properties

Severity Assessment

Severity indicates how critical the gap is:

SeverityWhen AssignedAction Timeline
CriticalCompliance violation, audit failureImmediate (days)
HighSignificant deficiencyShort-term (weeks)
MediumModerate issueMedium-term (months)
LowMinor improvementWhen convenient

Status Meaning

StatusWhat It MeansNext Actions
OpenNeeds attentionTriage and assign
In ProgressBeing remediatedMonitor workflow
ResolvedFixed with evidenceVerify and close
AcceptedRisk acknowledgedDocument 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 RangeMeaning
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

ActionDescription
Copy LinkShare the gap URL with teammates
ExportDownload gap details as PDF
PrintPrint for documentation
Create RiskGenerate a risk entry from this gap

Comments and Collaboration

Adding Comments

  1. Scroll to the comments section
  2. Type your comment in the text box
  3. @mention teammates for notifications
  4. 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:

  1. Click "Add Evidence" in the detail view
  2. Select from existing documents or upload new
  3. Explain how the evidence addresses the gap
  4. 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:

  1. Keep the gap with more complete information
  2. Add notes referencing the duplicate
  3. Mark the duplicate as resolved (not deleted)
  4. Note in resolution: "Consolidated with [gap link]"

How do I split a gap that's too broad?

If a gap covers multiple issues:

  1. Create new gaps for each distinct issue
  2. Link them in comments
  3. Mark the original as resolved with note
  4. Assign appropriate severity to each new gap

What if I disagree with the AI assessment?

If the AI got it wrong:

  1. Review the AI reasoning carefully
  2. If truly invalid, mark as resolved with explanation
  3. If partially valid, adjust severity or scope
  4. Add comments explaining your assessment

Next Steps

On this page