adpa-enterprise-framework-automation/dist/modules/ai/processors/BusinessAnalysisQualityProcessor.js

Modular, standards-compliant Node.js/TypeScript automation framework for enterprise requirements, project, and data management. Provides CLI and API for BABOK v3, PMBOK 7th Edition, and DMBOK 2.0 (in progress). Production-ready Express.js API with TypeSpe

/**
 * Business Analysis Quality Assurance Processor
 * Specialized AI processor for quality assurance in business analysis deliverables
 *
 * @class BusinessAnalysisQualityProcessor
 * @description Handles quality assessment, validation, and improvement recommendations
 * for business analysis artifacts including requirements, documentation, and processes.
 *
 * @version 1.0.0
 * @author Requirements Gathering Agent Team
 * @created 2025-01-27
 *
 * @filepath src/modules/ai/processors/BusinessAnalysisQualityProcessor.ts
 */
import { BaseAIProcessor } from './BaseAIProcessor.js';
import { AIProcessor } from '../AIProcessor.js';
export class BusinessAnalysisQualityProcessor extends BaseAIProcessor {
    aiProcessor = AIProcessor.getInstance();
    /**
     * Performs comprehensive quality assessment of requirements
     */
    async assessRequirementsQuality(requirements, qualityStandards = 'BABOK v3') {
        return await this.handleAICall(async () => {
            const messages = this.createStandardMessages("You are an expert Quality Assurance specialist for Business Analysis. Assess the quality of requirements against industry standards.", `Perform a comprehensive quality assessment of the following requirements:

Requirements to Assess:
${requirements.join('\n- ')}

Quality Standards: ${qualityStandards}

Generate a detailed quality assessment report that includes:

## Quality Assessment Overview
- Assessment scope and methodology
- Quality standards applied
- Assessment criteria and weights
- Overall quality score (0-100)

## Quality Dimensions Analysis

### 1. Clarity and Understandability
- Language clarity and precision
- Ambiguity assessment
- Technical jargon appropriateness
- Stakeholder comprehension level
- Score: [0-100] with justification

### 2. Completeness
- Information completeness
- Missing details identification
- Scope coverage assessment
- Acceptance criteria presence
- Score: [0-100] with justification

### 3. Consistency
- Internal consistency within requirements
- Consistency with other documents
- Terminology consistency
- Format and structure consistency
- Score: [0-100] with justification

### 4. Correctness
- Technical accuracy
- Business logic correctness
- Feasibility assessment
- Alignment with business objectives
- Score: [0-100] with justification

### 5. Traceability
- Source traceability
- Forward traceability
- Bidirectional links
- Coverage assessment
- Score: [0-100] with justification

### 6. Verifiability
- Testability of requirements
- Measurable criteria presence
- Acceptance criteria quality
- Validation approach clarity
- Score: [0-100] with justification

### 7. Prioritization
- Priority assignment presence
- Priority rationale
- Stakeholder agreement
- Business value alignment
- Score: [0-100] with justification

### 8. Modifiability
- Change impact assessment
- Modularity and independence
- Version control readiness
- Update procedures clarity
- Score: [0-100] with justification

## Detailed Findings

### Strengths Identified
- High-quality requirements examples
- Best practices demonstrated
- Effective techniques used
- Stakeholder value delivered

### Weaknesses and Gaps
- Quality issues identified
- Missing information
- Improvement opportunities
- Risk areas highlighted

### Critical Issues
- Must-fix problems
- High-impact deficiencies
- Compliance violations
- Stakeholder concerns

## Quality Metrics
- Requirements clarity index
- Completeness percentage
- Consistency score
- Traceability coverage
- Defect density
- Stakeholder satisfaction

## Improvement Recommendations

### Immediate Actions (Critical)
- Fix critical quality issues
- Address compliance gaps
- Resolve stakeholder concerns
- Implement quick wins

### Short-term Improvements
- Enhance documentation quality
- Improve process adherence
- Strengthen validation procedures
- Increase stakeholder engagement

### Long-term Enhancements
- Process optimization
- Tool improvements
- Training and development
- Quality culture building

## Quality Assurance Plan
- Ongoing quality monitoring
- Review checkpoints
- Quality gates implementation
- Continuous improvement process

## Compliance Assessment
- BABOK v3 compliance level
- Industry standard adherence
- Organizational policy compliance
- Regulatory requirement satisfaction

Format as structured markdown with clear scoring, specific examples, and actionable recommendations.`);
            const response = await this.aiProcessor.makeAICall(messages, 2800);
            return this.aiProcessor.extractContent(response);
        }, 'Requirements Quality Assessment', 'quality-assessment');
    }
    /**
     * Validates consistency across multiple documents
     */
    async validateDocumentConsistency(documents, projectContext) {
        return await this.handleAICall(async () => {
            const documentList = documents.map(doc => `${doc.name}:\n${doc.content}`).join('\n\n---\n\n');
            const messages = this.createStandardMessages("You are an expert Document Consistency Analyst. Validate consistency across multiple business analysis documents.", `Validate consistency across the following business analysis documents:

${documentList}

Project Context:
${projectContext}

Generate a comprehensive consistency validation report that includes:

## Consistency Analysis Overview
- Documents analyzed
- Consistency criteria applied
- Analysis methodology
- Overall consistency score (0-100)

## Cross-Document Consistency Check

### Terminology Consistency
- Consistent use of business terms
- Definition alignment across documents
- Glossary compliance
- Acronym and abbreviation consistency

### Requirements Consistency
- Functional requirement alignment
- Non-functional requirement consistency
- Business rule consistency
- Acceptance criteria alignment

### Process Consistency
- Workflow alignment
- Process step consistency
- Role and responsibility alignment
- Decision point consistency

### Data Consistency
- Data element definitions
- Data flow consistency
- Data model alignment
- Data quality requirements

### Stakeholder Consistency
- Stakeholder identification alignment
- Role definition consistency
- Responsibility assignment consistency
- Communication requirement alignment

## Inconsistency Identification

### Critical Inconsistencies
- Contradictory requirements
- Conflicting business rules
- Incompatible processes
- Data model conflicts

### Significant Inconsistencies
- Terminology variations
- Process step differences
- Role responsibility gaps
- Timeline misalignments

### Minor Inconsistencies
- Formatting differences
- Reference inconsistencies
- Detail level variations
- Style inconsistencies

## Document Pair Analysis
For each document pair:
- Consistency score
- Aligned elements
- Inconsistent elements
- Recommendations for alignment

## Root Cause Analysis
- Sources of inconsistency
- Process gaps contributing to issues
- Communication breakdowns
- Tool or template limitations

## Impact Assessment
- Business impact of inconsistencies
- Technical implementation risks
- Stakeholder confusion potential
- Project delivery risks

## Resolution Recommendations

### Immediate Actions
- Critical inconsistency resolution
- Stakeholder clarification sessions
- Document updates required
- Process corrections needed

### Process Improvements
- Document review procedures
- Consistency checking protocols
- Template standardization
- Tool integration enhancements

### Preventive Measures
- Consistency checking automation
- Regular review cycles
- Training and awareness
- Quality gates implementation

## Consistency Maintenance Plan
- Ongoing monitoring approach
- Regular consistency audits
- Update synchronization procedures
- Version control strategies

Format as structured markdown with clear inconsistency identification, impact assessment, and actionable resolution plans.`);
            const response = await this.aiProcessor.makeAICall(messages, 2600);
            return this.aiProcessor.extractContent(response);
        }, 'Document Consistency Validation', 'consistency-validation');
    }
    /**
     * Verifies completeness against templates and standards
     */
    async verifyCompleteness(document, template, documentType) {
        return await this.handleAICall(async () => {
            const messages = this.createStandardMessages("You are an expert Completeness Verification specialist. Verify document completeness against templates and standards.", `Verify the completeness of the following document against the provided template:

Document Type: ${documentType}

Document to Verify:
${document}

Template/Standard:
${template}

Generate a comprehensive completeness verification report that includes:

## Completeness Assessment Overview
- Document type and purpose
- Template/standard applied
- Verification methodology
- Overall completeness score (0-100)

## Template Compliance Analysis

### Required Elements Assessment
For each required template element:
- Element name and description
- Presence status (present/missing/partial)
- Quality assessment if present
- Impact of absence if missing

### Optional Elements Assessment
For each optional template element:
- Element name and description
- Presence status
- Value assessment if present
- Benefit of inclusion if missing

### Additional Elements Assessment
For elements present but not in template:
- Element description
- Value assessment
- Relevance to document purpose
- Recommendation for retention

## Completeness Scoring

### Content Completeness (40%)
- All required information present
- Sufficient detail level
- Appropriate depth of coverage
- Stakeholder needs addressed

### Structural Completeness (25%)
- Template structure followed
- Required sections present
- Logical organization maintained
- Navigation and readability

### Quality Completeness (20%)
- Information accuracy
- Clarity and understandability
- Professional presentation
- Error-free content

### Compliance Completeness (15%)
- Standard adherence
- Regulatory compliance
- Organizational policy compliance
- Industry best practices

## Gap Analysis

### Critical Gaps
- Missing mandatory elements
- Incomplete critical information
- Compliance violations
- Stakeholder requirement gaps

### Significant Gaps
- Missing important elements
- Insufficient detail levels
- Process step omissions
- Quality standard gaps

### Minor Gaps
- Missing optional elements
- Formatting inconsistencies
- Reference incompleteness
- Style guide deviations

## Impact Assessment
- Business impact of gaps
- Stakeholder impact analysis
- Project risk implications
- Compliance risk assessment

## Completion Recommendations

### Immediate Actions
- Add missing critical elements
- Complete partial information
- Fix compliance violations
- Address stakeholder concerns

### Enhancement Opportunities
- Add valuable optional elements
- Improve information quality
- Enhance presentation
- Strengthen compliance

### Process Improvements
- Template usage training
- Quality review procedures
- Completeness checking tools
- Standard update processes

## Completion Roadmap
- Priority-based completion plan
- Resource requirements
- Timeline estimates
- Quality checkpoints

## Quality Assurance
- Review and validation procedures
- Stakeholder approval process
- Final quality checks
- Maintenance procedures

Format as structured markdown with clear gap identification, scoring rationale, and actionable completion plans.`);
            const response = await this.aiProcessor.makeAICall(messages, 2400);
            return this.aiProcessor.extractContent(response);
        }, 'Completeness Verification', 'completeness-verification');
    }
    /**
     * Validates requirements traceability matrix
     */
    async validateTraceability(traceabilityMatrix, requirements, projectContext) {
        return await this.handleAICall(async () => {
            const messages = this.createStandardMessages("You are an expert Traceability Validation specialist. Validate requirements traceability matrices for completeness and accuracy.", `Validate the following requirements traceability matrix:

Traceability Matrix:
${traceabilityMatrix}

Requirements Context:
${requirements.join('\n- ')}

Project Context:
${projectContext}

Generate a comprehensive traceability validation report that includes:

## Traceability Validation Overview
- Validation scope and objectives
- Traceability standards applied
- Validation methodology
- Overall traceability score (0-100)

## Traceability Coverage Analysis

### Forward Traceability
- Requirements to design elements
- Requirements to test cases
- Requirements to implementation
- Coverage percentage and gaps

### Backward Traceability
- Design to requirements
- Test cases to requirements
- Implementation to requirements
- Coverage percentage and gaps

### Bidirectional Traceability
- Two-way link verification
- Consistency checking
- Synchronization validation
- Maintenance assessment

## Traceability Matrix Validation

### Matrix Structure Assessment
- Column completeness
- Row completeness
- Relationship accuracy
- Link quality assessment

### Link Verification
- Valid source-target relationships
- Appropriate link types
- Relationship strength assessment
- Missing link identification

### Coverage Analysis
- Requirement coverage percentage
- Orphaned requirements identification
- Uncovered design elements
- Test coverage gaps

## Traceability Quality Assessment

### Link Quality (30%)
- Accurate relationships
- Appropriate granularity
- Clear link types
- Verified connections

### Coverage Quality (25%)
- Complete requirement coverage
- Comprehensive target coverage
- No orphaned elements
- Balanced distribution

### Maintenance Quality (25%)
- Update procedures
- Version synchronization
- Change impact tracking
- Audit trail maintenance

### Usability Quality (20%)
- Matrix readability
- Navigation ease
- Search capabilities
- Report generation

## Gap Analysis

### Critical Gaps
- Missing critical requirements
- Orphaned high-priority requirements
- Broken traceability chains
- Compliance violations

### Significant Gaps
- Incomplete coverage areas
- Weak traceability links
- Missing test coverage
- Documentation gaps

### Minor Gaps
- Formatting inconsistencies
- Reference inaccuracies
- Detail level variations
- Process deviations

## Risk Assessment
- Traceability risks identified
- Impact on project delivery
- Compliance risks
- Quality assurance risks

## Improvement Recommendations

### Immediate Actions
- Fix critical traceability gaps
- Restore broken links
- Complete missing coverage
- Address compliance issues

### Process Improvements
- Traceability maintenance procedures
- Automated link validation
- Regular audit cycles
- Tool integration enhancements

### Quality Enhancements
- Link quality standards
- Coverage metrics implementation
- Reporting improvements
- Training and awareness

## Traceability Maintenance Plan
- Ongoing maintenance procedures
- Regular validation cycles
- Change impact procedures
- Quality monitoring approach

Format as structured markdown with clear gap identification, coverage analysis, and actionable improvement plans.`);
            const response = await this.aiProcessor.makeAICall(messages, 2500);
            return this.aiProcessor.extractContent(response);
        }, 'Traceability Validation', 'traceability-validation');
    }
    /**
     * Generates quality metrics and KPIs for business analysis activities
     */
    async generateQualityMetrics(projectData, timeframe = 'current') {
        return await this.handleAICall(async () => {
            const messages = this.createStandardMessages("You are an expert Business Analysis Metrics specialist. Generate comprehensive quality metrics and KPIs for business analysis activities.", `Generate quality metrics and KPIs based on the following project data:

Project Data:
${projectData}

Timeframe: ${timeframe}

Create a comprehensive quality metrics report that includes:

## Quality Metrics Overview
- Metrics framework applied
- Measurement period
- Data sources used
- Reporting frequency

## Requirements Quality Metrics

### Defect Metrics
- Requirements defect density
- Defect discovery rate
- Defect resolution time
- Defect severity distribution
- Root cause analysis

### Clarity Metrics
- Ambiguity index
- Stakeholder understanding score
- Review feedback analysis
- Clarification request frequency

### Completeness Metrics
- Template compliance percentage
- Information completeness score
- Missing element tracking
- Coverage gap analysis

### Consistency Metrics
- Cross-document consistency score
- Terminology consistency index
- Process alignment percentage
- Data consistency rating

## Process Quality Metrics

### Efficiency Metrics
- Requirements gathering velocity
- Document production time
- Review cycle time
- Approval turnaround time

### Effectiveness Metrics
- Stakeholder satisfaction score
- Requirements stability index
- Change request frequency
- Rework percentage

### Productivity Metrics
- Requirements per analyst per day
- Document pages per hour
- Review efficiency ratio
- Automation utilization rate

## Stakeholder Engagement Metrics

### Participation Metrics
- Meeting attendance rates
- Review participation levels
- Feedback response rates
- Collaboration tool usage

### Satisfaction Metrics
- Stakeholder satisfaction scores
- Communication effectiveness rating
- Expectation alignment index
- Conflict resolution success rate

### Value Delivery Metrics
- Business value realization
- Benefit achievement rate
- ROI on BA activities
- Time to value delivery

## Quality Trend Analysis

### Historical Trends
- Quality improvement over time
- Defect rate trends
- Productivity trends
- Satisfaction trends

### Predictive Indicators
- Quality risk indicators
- Early warning signals
- Trend projections
- Improvement opportunities

### Benchmark Comparisons
- Industry benchmark comparison
- Organizational benchmark comparison
- Best practice alignment
- Maturity level assessment

## Key Performance Indicators (KPIs)

### Strategic KPIs
- Business objective alignment
- Stakeholder value delivery
- Project success contribution
- Strategic initiative support

### Operational KPIs
- Process efficiency measures
- Quality achievement rates
- Resource utilization rates
- Delivery timeline adherence

### Quality KPIs
- Defect-free delivery rate
- First-time approval rate
- Rework reduction percentage
- Compliance achievement rate

## Improvement Opportunities

### Quick Wins
- Immediate improvement actions
- Low-effort, high-impact changes
- Process optimizations
- Tool enhancements

### Strategic Improvements
- Long-term capability building
- Process transformation
- Technology investments
- Skill development

### Innovation Opportunities
- Emerging technology adoption
- Process innovation
- Collaboration enhancements
- Automation expansion

## Action Plan
- Priority improvement initiatives
- Resource requirements
- Timeline and milestones
- Success criteria

## Monitoring and Reporting
- Ongoing metrics collection
- Regular reporting schedule
- Dashboard implementation
- Continuous improvement process

Format as structured markdown with clear metrics definitions, trend analysis, and actionable improvement recommendations.`);
            const response = await this.aiProcessor.makeAICall(messages, 2700);
            return this.aiProcessor.extractContent(response);
        }, 'Quality Metrics Generation', 'quality-metrics');
    }
}
//# sourceMappingURL=BusinessAnalysisQualityProcessor.js.map