AI Fit-Gap Analysis Guide
User Guide
BriefSpec
Introduction
AI Fit-Gap Analysis helps you assess project requirements against the Out-of-the-Box (OOTB) capabilities of your software platform. For each selected requirement, BriefSpec uses AI to suggest whether the need is a Fit, Partial Fit, or Gap, along with supporting analysis and, where applicable, a recommended gap resolution approach.
The feature is designed for consultants and project teams who need to populate Fit-Gap details efficiently across many backlog requirements. AI suggestions are always presented for your review. Nothing is written to the backlog until you accept a result.
This guide explains how to run AI Fit-Gap Analysis from the project Backlog, review the generated assessments, and apply accepted results to your requirements.
Accessing AI Fit-Gap Analysis
To use AI Fit-Gap Analysis, open the project and go to the Backlog.
In the Backlog toolbar, click the AI Generated Fit-Gap Analysis button (magic wand icon).
This opens the AI Fit-Gap Analysis panel like below.
If you had run an analysis in the past for the same project, the last run report details will be displayed.
Note that you can always manually update the Fit Status field on the Backlog (separate from the AI panel).
Before you can run an analysis:
- Your role must have privilege backlog-ai-fit-gap-analysis (Read & Edit) to use AI Fit-Gap Analysis.
- AI-powered features must be enabled for your tenant.
- The project must not be in Draft status.
Your tenant plan must include ai_fit_gap_analysis (otherwise the toolbar shows an upgrade message).
If a Fit-Gap analysis is already running in the background for the project, the toolbar indicates that status. You can reopen the panel to check progress or view the report after the run completes.
Here is how a generated report looks like.
Run Details shows the Pillars, Epics/Modules, and requirements included in the run. Results are split into tabs for Fit, Partial Fit, and Gap. Selecting a tab loads those assessments (for example, the Fit tab shows items the AI classified as Fit).
Which Requirements Are Eligible
AI Fit-Gap Analysis works on backlog requirements that do not yet have a Fit Status value. Requirements that already have Fit, Partial Fit, or Gap populated are excluded from analysis.
Requirements must also have Pillar (Software) and Module/Epic assigned, and must be in an eligible status. Rows missing pillar/module, with an existing Fit Status, or with an ineligible status are excluded and shown in the preview step with an explanation.
Selecting Scope
When the panel opens, the first step is to choose the scope of requirements to analyze.
You can define scope in either of these ways:
- Select all – include every Pillar and Module/Epic combination available in the project backlog.
- Add scope manually – choose one or more Pillar and Module/Epic combinations using the scope rows.
For each scope row, select a Pillar and one or more Modules/Epics. Use Add scope to include additional pillar combinations. Remove a row with the delete icon if it is no longer needed.
When your scope is ready, click on Preview Analysis to see which requirements will be analyzed.
Preview and Start Analysis
The preview screen lists eligible requirements with a blank Fit/Gap status within your selected scope.
Review the summary counts at the top, including the number of selected requirements and the approximate estimated AI tokens for the run. If the estimated usage exceeds your remaining token allowance, BriefSpec blocks the start and shows a token-limit message until you free capacity or purchase more tokens (Settings > Manage Plan).
Use the checkboxes to include or exclude individual requirements. Select All Unmapped Fit Status Requirements selects every eligible row in the preview list.
When you are ready, click Start Background Analysis. BriefSpec submits the selected requirements for AI assessment.
Analysis runs in the background. You may close the panel and continue other work. Reopen AI Fit-Gap Analysis later to view progress or results.
Once the background job completes, you are notified by email. Opening the project from that notification (or with showReport=ai-fit-gap on the project URL) can reopen the completed report.
Reviewing the Analysis Report
When the run completes, the panel shows the Last AI Generated Fit-Gap Analysis Report.
Results are grouped into tabs by proposed Fit status:
- Fit – the requirement is supported by standard product capabilities.
- Partial Fit – the requirement is partly supported; a gap remains.
- Gap – the requirement is not supported out of the box, or lacks enough detail for a confident fit assessment.
Use the run details sidebar to see who ran the analysis, the scope selected, and the list of analyzed requirements. You can collapse or expand this sidebar as needed.
Each result row shows the Requirement ID, title, pillar, module/epic, proposed Fit status, and confidence score. Expand a row to review the full AI assessment,
It includes:
- Fit Status
- Confidence Percentage
- Confidence Reasoning – why the AI assigned its confidence score.
- OOTB Coverage – what the software supports for this requirement.
- Feature Reference – the product feature, screen, or configuration area referenced by the assessment.
- Gap Summary (for Partial Fit and Gap) – what is not covered, when a gap exists.
- Resolution Approach – recommended way to address a Partial Fit or Gap.
- Unresolved Risk — whether significant unresolved risk remains if the gap is not addressed.
- Risk Description, Complexity, Estimated Effort (days), and Dependencies — supporting resolution details for Partial Fit and Gap items.
If confidence is below 50%, the result is flagged as Low confidence – verify manually. Review these items carefully before accepting.
You can download the full report to Excel using the download icon in the panel header. Use Re-Generate Report to start a new analysis run when you need a fresh assessment.
Accepting or Rejecting Results
For each result, use Accept or Reject to record your decision. You can also select multiple rows and use Accept Selected or Reject Selected.
Accepted results are applied to the corresponding backlog requirement Fit Status and related Fit-Gap fields when you save. Rejected results are not applied. Assessment text in the report is review-only — decisions are Accept or Reject, not in-panel editing of the AI narrative.
When you have marked your decisions, click Save Selected Decisions. BriefSpec persists your choices and updates accepted requirements in the backlog.
After pending decisions are saved, finalized rows leave the pending report list. When no pending decisions remain, the panel returns to scope selection so you can run another analysis if needed. Refresh the Backlog to see updated Fit Status values on accepted requirements.
Important: AI Fit-Gap Analysis provides recommendations only. Always review OOTB coverage, gap summaries, resolution approaches, and confidence scores before accepting results for use in your project deliverables.