| name | requirements-merge |
| description | Combines multiple requirement sources into a single coherent specification, handling conflicts and redundancies while maintaining source traceability and supporting stakeholder review workflows. |
| license | MIT |
Requirements Merge
Intelligently merges requirements from multiple sources and formats into a unified, coherent specification while identifying conflicts, eliminating redundancies, preserving important variations, and maintaining complete source traceability throughout stakeholder review processes.
Core Function
Input: Multiple requirements documents + project_id + merge_strategy + conflict_resolution_rules
Primary Output: Markdown unified requirements specification (for stakeholder review and downstream skills)
Secondary Output: JSON format with detailed merge analysis and traceability (for machine processing and audit trails)
Output Destination:
- Markdown:
outputs/projects/{project_id}/Analysis/unified-requirements.md (primary for downstream)
- JSON:
outputs/projects/{project_id}/Analysis/merge-analysis.json (machine processing)
- Conflicts Log:
outputs/projects/{project_id}/Analysis/merge-conflicts.md (stakeholder review)
Directory Structure: Auto-created project folders with Analysis subfolder containing unified requirements, merge analysis, conflict resolution logs, and stakeholder approval tracking
Usage
GitHub Copilot Integration (Recommended):
Use this skill directly in Copilot by providing multiple requirements documents and merge strategy.
Copilot will automatically merge requirements, identify conflicts, and produce a unified specification.
Example prompt:
"Use requirements-merge skill to merge these three requirements documents: [doc1.md], [doc2.pdf], [doc3.docx]. Apply conservative merge strategy with manual conflict resolution for high-impact conflicts."
Traditional Script Approach:
from process_merge import RequirementsMerger
merger = RequirementsMerger()
result = merger.merge_requirements([
"requirements-v1.md",
"stakeholder-feedback.docx",
"technical-constraints.pdf"
], "PROJECT-001", merge_strategy="comprehensive")
Command Line:
python process_merge.py PROJECT-001 --strategy comprehensive requirements-v1.md stakeholder-feedback.docx technical-constraints.pdf
Output Schema
Primary Format (Markdown) - Unified Requirements Specification:
# Unified Requirements Specification
**Project**: PROJECT-001
**Merge Date**: 2026-02-15T10:30:00Z
**Sources Merged**: 3 documents (requirements-v1.md, stakeholder-feedback.docx, technical-constraints.pdf)
**Total Requirements**: 47 (15 core, 20 merged, 12 enhanced)
**Conflicts Resolved**: 8 (3 automatic, 5 stakeholder-reviewed)
**Merge Strategy**: Comprehensive with stakeholder validation
## Executive Summary
**Merge Outcome**: Successfully unified 3 requirement sources into coherent specification
**Quality Metrics**: 96% requirement coverage, 100% traceability maintained
**Stakeholder Impact**: 5 conflicts requiring stakeholder review and approval
**Next Steps**: Stakeholder review of conflict resolutions, final approval workflow
## Requirements by Category
### Core Requirements (Consensus Across Sources)
#### R-001: User Authentication
**Unified Requirement**: System shall authenticate users using multi-factor authentication within 3 seconds
**Source Traceability**:
- requirements-v1.md (R-003): "System shall authenticate users within 3 seconds"
- stakeholder-feedback.docx (SF-012): "Must support multi-factor authentication"
- technical-constraints.pdf (TC-007): "Authentication response time ≤ 3 seconds"
**Merge Method**: Consensus enhancement
**Confidence Level**: High (100% source agreement)
#### R-002: Data Storage Compliance
**Unified Requirement**: All user data shall be stored in compliance with GDPR, CCPA, and SOX regulations with end-to-end encryption
**Source Traceability**:
- requirements-v1.md (R-015): "Data storage must comply with GDPR"
- stakeholder-feedback.docx (SF-008): "Need CCPA and SOX compliance"
- technical-constraints.pdf (TC-003): "Implement end-to-end encryption for all data"
**Merge Method**: Regulatory aggregation
**Confidence Level**: High (regulatory requirements)
### Enhanced Requirements (Source Conflicts Resolved)
#### R-003: API Response Performance [CONFLICT RESOLVED]
**Unified Requirement**: API response times shall not exceed 200ms for 95% of requests, with maximum timeout of 500ms
**Conflict Resolution**:
- requirements-v1.md (R-007): "API response < 200ms average"
- stakeholder-feedback.docx (SF-015): "Response time must be < 100ms"
- technical-constraints.pdf (TC-011): "Maximum response time 500ms"
**Resolution Method**: Stakeholder priority + technical feasibility analysis
**Stakeholder Decision**: Approved 200ms/95th percentile standard (Date: 2026-02-14)
**Confidence Level**: High (stakeholder validated)
#### R-004: Mobile Platform Support [VARIATION PRESERVED]
**Unified Requirement**: Support iOS 14+, Android 10+, with progressive web app fallback for older versions
**Source Variations**:
- requirements-v1.md (R-022): "Support iOS and Android latest 2 versions"
- stakeholder-feedback.docx (SF-023): "Must support iOS 12+ for legacy devices"
- technical-constraints.pdf (TC-015): "Progressive web app for cross-platform compatibility"
**Resolution Method**: Comprehensive coverage strategy
**Confidence Level**: Medium (implementation complexity uncertainty)
### New Requirements (Source Additions)
#### R-005: Accessibility Compliance
**Unified Requirement**: Interface shall comply with WCAG 2.1 AA standards including screen reader support
**Source Traceability**: stakeholder-feedback.docx (SF-031): "Need accessibility for compliance"
**Addition Rationale**: Legal compliance requirement, no conflicts with existing specifications
**Confidence Level**: High (regulatory requirement)
## Conflict Resolution Log
### Resolved Conflicts
#### Conflict CR-001: Authentication Method
**Conflict Description**: OAuth2 vs SAML vs proprietary authentication
**Sources Involved**:
- requirements-v1.md: OAuth2 preference
- stakeholder-feedback.docx: SAML required for enterprise
- technical-constraints.pdf: Proprietary solution suggested
**Resolution**: Multi-protocol support (OAuth2 primary, SAML enterprise, API fallback)
**Stakeholder Approval**: Pending (escalated to architecture review board)
**Impact Assessment**: Medium complexity increase, high flexibility gain
#### Conflict CR-002: Data Retention Period
**Conflict Description**: 7 years vs 5 years vs indefinite retention
**Sources Involved**:
- requirements-v1.md: 7 years for audit compliance
- stakeholder-feedback.docx: 5 years sufficient for business needs
- technical-constraints.pdf: Storage costs favor shorter retention
**Resolution**: 7 years active, 5 years archived, purge after 7 years
**Stakeholder Approval**: Approved by legal and finance teams (2026-02-13)
**Impact Assessment**: Low complexity, balanced cost and compliance
### Pending Conflicts (Stakeholder Review Required)
#### Conflict CR-003: Deployment Architecture
**Conflict Description**: Cloud-native vs hybrid vs on-premises deployment
**Sources Involved**: All three sources present different preferences
**Business Impact**: High (affects entire technical architecture)
**Escalation Level**: Executive decision required
**Review Deadline**: 2026-02-20
**Interim Solution**: Cloud-native development with hybrid deployment option preserved
## Redundancy Analysis
### Eliminated Redundancies
**Performance Requirements**: 12 duplicate performance specifications consolidated into 4 unified requirements
**Security Specifications**: 8 overlapping security requirements merged into 3 comprehensive specifications
**Integration Requirements**: 6 similar API integration requests consolidated into 2 detailed specifications
### Preserved Variations
**Regional Compliance**: Maintained separate GDPR, CCPA, and SOX requirements due to different implementation approaches
**User Interface Variants**: Preserved desktop, mobile, and tablet-specific UI requirements due to different interaction patterns
**Integration Protocols**: Maintained REST, GraphQL, and WebSocket requirements for different use case optimizations
## Quality Metrics
### Merge Statistics
- **Total Input Requirements**: 73 (across 3 sources)
- **Unified Output Requirements**: 47 (35% consolidation efficiency)
- **Conflicts Identified**: 8 (11% conflict rate)
- **Automatic Resolution**: 3 conflicts (37.5%)
- **Stakeholder Resolution**: 5 conflicts (62.5%)
- **Traceability Coverage**: 100% (all requirements traced to sources)
### Validation Results
- **Completeness Check**: ✅ All source requirements addressed
- **Consistency Check**: ✅ No internal contradictions in unified specification
- **Traceability Audit**: ✅ Complete source-to-unified mapping maintained
- **Stakeholder Approval**: 🟨 85% approved, 15% pending review
## Stakeholder Review Workflow
### Review Process
1. **Conflict Identification**: Automated analysis identifies conflicting requirements
2. **Impact Assessment**: Business and technical impact evaluation for each conflict
3. **Stakeholder Notification**: Relevant stakeholders notified of conflicts requiring review
4. **Resolution Discussion**: Facilitated stakeholder sessions for conflict resolution
5. **Decision Documentation**: Formal recording of stakeholder decisions and rationale
6. **Approval Tracking**: Status tracking for all review and approval activities
### Approval Status
- **Technical Architecture Team**: ✅ Approved unified technical requirements
- **Business Stakeholders**: 🟨 Approved core business requirements, reviewing performance conflicts
- **Legal/Compliance Team**: ✅ Approved all regulatory and compliance requirements
- **Project Management**: 🟨 Approved project scope, reviewing timeline impact of conflicts
### Next Actions
1. **Schedule architecture review board meeting** for authentication protocol decision (CR-001)
2. **Finalize deployment architecture decision** with executive stakeholders (CR-003)
3. **Update project timeline** based on conflict resolution outcomes
4. **Generate final approved requirements specification** after all conflicts resolved
## Traceability Matrix
| Unified ID | Original Sources | Merge Type | Stakeholder Status |
|------------|------------------|------------|-------------------|
| R-001 | requirements-v1.md:R-003, stakeholder-feedback.docx:SF-012 | Enhancement | Approved |
| R-002 | requirements-v1.md:R-015, technical-constraints.pdf:TC-003 | Aggregation | Approved |
| R-003 | requirements-v1.md:R-007, stakeholder-feedback.docx:SF-015 | Conflict Resolution | Approved |
| R-004 | All 3 sources (variations preserved) | Comprehensive | Pending |
| R-005 | stakeholder-feedback.docx:SF-031 | Addition | Approved |
---
**Review Status**: In Progress - 5 conflicts pending stakeholder resolution
**Approval Deadline**: 2026-02-20
**Final Specification**: Will be generated upon completion of all conflict resolutions
Secondary Format (JSON) - Machine Processing and Audit Trail:
{
"metadata": {
"project_id": "PROJECT-001",
"merge_timestamp": "2026-02-15T10:30:00Z",
"sources": [
{
"filename": "requirements-v1.md",
"requirements_count": 25,
"format": "markdown"
},
{
"filename": "stakeholder-feedback.docx",
"requirements_count": 31,
"format": "docx"
},
{
"filename": "technical-constraints.pdf",
"requirements_count": 17,
"format": "pdf"
}
],
"merge_strategy": "comprehensive",
"skill_version": "1.0.0"
},
"merge_summary": {
"total_input_requirements": 73,
"unified_output_requirements": 47,
"consolidation_efficiency": 0.35,
"conflicts_identified": 8,
"conflicts_auto_resolved": 3,
"conflicts_stakeholder_resolved": 5,
"traceability_coverage": 1.0
},
"unified_requirements": [
{
"id": "R-001",
"text": "System shall authenticate users using multi-factor authentication within 3 seconds",
"category": "core",
"merge_type": "enhancement",
"confidence_level": "high",
"stakeholder_status": "approved",
"source_traceability": [
{
"source_file": "requirements-v1.md",
"original_id": "R-003",
"original_text": "System shall authenticate users within 3 seconds",
"contribution": "baseline_requirement"
},
{
"source_file": "stakeholder-feedback.docx",
"original_id": "SF-012",
"original_text": "Must support multi-factor authentication",
"contribution": "security_enhancement"
}
]
}
],
"conflicts": [
{
"id": "CR-001",
"description": "Authentication method disagreement",
"status": "pending",
"business_impact": "medium",
"technical_impact": "medium",
"escalation_level": "architecture_review_board",
"sources_involved": [
{
"source": "requirements-v1.md",
"position": "OAuth2 preference",
"rationale": "Industry standard, developer familiarity"
},
{
"source": "stakeholder-feedback.docx",
"position": "SAML required",
"rationale": "Enterprise integration requirements"
}
],
"proposed_resolution": "Multi-protocol support implementation",
"resolution_timeline": "2026-02-20"
}
],
"redundancy_analysis": {
"eliminated_redundancies": [
{
"category": "performance",
"original_count": 12,
"consolidated_count": 4,
"consolidation_method": "metric_unification"
}
],
"preserved_variations": [
{
"category": "regional_compliance",
"reason": "different_implementation_approaches",
"variation_count": 3
}
]
},
"quality_metrics": {
"completeness_check": true,
"consistency_check": true,
"traceability_audit": true,
"stakeholder_approval_rate": 0.85
},
"stakeholder_workflow": {
"approvals": [
{
"team": "technical_architecture",
"status": "approved",
"approval_date": "2026-02-14T16:00:00Z"
},
{
"team": "business_stakeholders",
"status": "partial",
"pending_items": ["performance_conflicts"],
"review_deadline": "2026-02-18T17:00:00Z"
}
],
"pending_actions": [
{
"action": "schedule_architecture_review",
"deadline": "2026-02-17T12:00:00Z",
"responsible": "solution_architect"
}
]
}
}
Tertiary Format (Markdown) - Conflict Resolution Log for Stakeholder Review:
# Merge Conflicts Resolution Log
**Project**: PROJECT-001
**Generated**: 2026-02-15T10:30:00Z
**Status**: 5 of 8 conflicts require stakeholder resolution
## High Priority Conflicts (Executive Decision Required)
### CR-003: Deployment Architecture Strategy
**Impact Level**: 🔴 **HIGH** - Affects entire technical architecture and cost model
**Sources**: All three requirement documents present different architectural preferences
**Business Impact**:
- Cost implications: Cloud vs on-premises operational expenses
- Timeline impact: 2-4 months difference in deployment approach
- Scalability constraints: Different growth capacity based on choice
**Technical Impact**:
- Development approach: Cloud-native vs hybrid development patterns
- Integration complexity: Different third-party service integration approaches
- Maintenance overhead: Varying operational support requirements
**Stakeholder Positions**:
- **IT Leadership**: Prefers cloud-native for scalability and maintenance reduction
- **Finance Team**: Concerned about ongoing cloud costs vs capital expenditure
- **Compliance Team**: Requires hybrid approach for sensitive data sovereignty
- **Development Team**: Recommends cloud-native for development velocity
**Recommended Resolution Process**:
1. Executive stakeholder meeting by 2026-02-17
2. Total cost of ownership analysis presentation
3. Risk assessment for each deployment option
4. Final decision and implementation roadmap approval
**Interim Approach**: Continue cloud-native development with deployment flexibility preserved
### CR-001: Authentication Protocol Standards
**Impact Level**: 🟡 **MEDIUM** - Affects security architecture and enterprise integration
**Conflict Description**: Disagreement on primary authentication protocols
**Review Required By**: Architecture Review Board
**Deadline**: 2026-02-20
## Medium Priority Conflicts (Team Lead Resolution)
### CR-004: User Interface Framework Selection
**Impact Level**: 🟡 **MEDIUM** - Affects development timeline and user experience
**Resolution Needed By**: 2026-02-19
**Assigned To**: Frontend Architecture Team Lead
### CR-005: Database Architecture Pattern
**Impact Level**: 🟡 **MEDIUM** - Affects data consistency and performance patterns
**Resolution Needed By**: 2026-02-21
**Assigned To**: Database Architecture Team Lead
## Low Priority Conflicts (Automatic Resolution Applied)
### CR-006: Logging Framework Choice ✅ **RESOLVED**
**Resolution**: Multi-framework support with configuration-based selection
**Approved By**: Development Team Lead (2026-02-14)
### CR-007: Code Style Standards ✅ **RESOLVED**
**Resolution**: Adopted most restrictive standards from all sources
**Approved By**: Development Team Lead (2026-02-14)
### CR-008: Testing Coverage Requirements ✅ **RESOLVED**
**Resolution**: Highest coverage requirement applied (90% code coverage)
**Approved By**: Quality Assurance Team Lead (2026-02-14)
## Stakeholder Action Items
### Immediate Actions Required (Next 48 Hours)
1. **Schedule executive architecture decision meeting** (Responsible: Project Manager)
2. **Prepare cost analysis for deployment options** (Responsible: Finance Team)
3. **Complete security impact assessment for authentication options** (Responsible: Security Team)
### This Week Actions
4. **Frontend framework prototype evaluation** (Responsible: Frontend Team)
5. **Database performance benchmarking** (Responsible: Backend Team)
6. **Compile stakeholder preference surveys** (Responsible: Business Analyst)
### Next Week Actions
7. **Final conflict resolution documentation** (Responsible: Technical Writer)
8. **Updated project timeline with resolution impacts** (Responsible: Project Manager)
9. **Stakeholder sign-off on unified requirements** (Responsible: Product Owner)
---
**Next Review Meeting**: 2026-02-18 at 2:00 PM
**Escalation Contact**: Senior Solution Architect
**Documentation Status**: This log will be updated as conflicts are resolved
Instructions
1. Multi-Source Requirement Analysis
Source Processing Strategy:
- Format Normalization: Convert all input formats (PDF, DOCX, MD, TXT, etc.) into structured requirement objects
- Semantic Analysis: Use NLP to identify requirement intent, not just textual similarity
- Categorization Consistency: Apply consistent requirement categorization across all sources
- Quality Assessment: Evaluate requirement clarity, completeness, and testability for each source
Requirement Extraction Process:
- Atomic Decomposition: Break complex requirements into atomic, testable components
- Context Preservation: Maintain business context and rationale from original sources
- Dependency Identification: Map dependencies and relationships between requirements
- Priority Inheritance: Preserve or infer requirement priorities from source documents
2. Conflict Detection and Classification
Conflict Types:
- Direct Contradiction: Requirements that explicitly contradict each other
- Priority Mismatch: Same requirement with different priority levels across sources
- Scope Variance: Different interpretations of requirement scope and boundaries
- Implementation Approach: Different technical approaches for achieving same goal
- Quality Attributes: Conflicting non-functional requirements (performance, security, etc.)
- Timeline Conflicts: Requirements with incompatible delivery timeline expectations
Conflict Analysis Process:
- Semantic Similarity: Use NLP to identify semantically similar but conflicting requirements
- Impact Assessment: Evaluate business, technical, and timeline impact of each conflict
- Stakeholder Mapping: Identify which stakeholders are affected by each conflict
- Resolution Complexity: Assess difficulty and resource requirements for conflict resolution
Conflict Prioritization:
- High Priority: Architectural decisions, regulatory requirements, security fundamentals
- Medium Priority: Feature specifications, performance requirements, integration approaches
- Low Priority: Implementation details, tooling choices, coding standards
3. Automatic Conflict Resolution
Auto-Resolution Rules (Conservative Approach):
- Regulatory Compliance: Always choose most restrictive compliance requirement
- Security Standards: Always apply highest security standard when multiple specified
- Performance Metrics: Use most stringent performance requirement that's technically feasible
- Data Quality: Apply highest data quality and integrity standards
- Testing Standards: Adopt most comprehensive testing requirement coverage
Safe Auto-Resolution Criteria:
- Resolution doesn't change fundamental business logic
- No significant cost or timeline impact
- Technical feasibility is confirmed
- Regulatory or security compliance is maintained
- All affected stakeholders would reasonably agree with resolution
Documentation Requirements:
- Log all automatic resolutions with detailed rationale
- Provide rollback mechanism if stakeholders disagree with auto-resolution
- Maintain audit trail for compliance and review purposes
4. Stakeholder-Driven Conflict Resolution
Resolution Workflow:
- Conflict Presentation: Clearly articulate conflict sources, implications, and options
- Impact Analysis: Provide business, technical, cost, and timeline impact assessment
- Recommendation Development: Present recommended resolution with supporting rationale
- Stakeholder Consultation: Facilitate stakeholder discussion and decision-making
- Decision Documentation: Formally record stakeholder decisions and approval
Escalation Framework:
- Team Level: Technical decisions, implementation approaches, minor scope changes
- Architecture Review: System design conflicts, technology stack decisions, major technical patterns
- Business Stakeholders: Feature priorities, business rule conflicts, user experience decisions
- Executive Level: Strategy conflicts, major cost implications, significant timeline impacts
Decision Support Tools:
- Cost-Benefit Analysis: Quantitative impact assessment for each resolution option
- Risk Assessment: Technical, business, and operational risks for different resolution paths
- Prototype Development: When needed, develop prototypes to validate resolution approaches
- Stakeholder Voting: Structured decision-making process for complex multi-stakeholder conflicts
5. Redundancy Elimination with Context Preservation
Redundancy Detection:
- Textual Similarity: Identify requirements with similar wording but potentially different intent
- Functional Equivalence: Detect requirements that achieve the same functional outcome
- Implementation Overlap: Identify requirements that would result in overlapping implementation
- Business Value Duplication: Find requirements targeting identical business outcomes
Intelligent Consolidation:
- Scope Expansion: Merge narrow requirements into broader, more comprehensive specifications
- Quality Enhancement: Combine basic requirements with enhanced quality attributes
- Context Integration: Merge requirements while preserving important contextual variations
- Traceability Preservation: Maintain links to all original sources during consolidation
Variation Preservation Rules:
- Platform Differences: Preserve platform-specific requirements (mobile vs desktop vs web)
- Regional Variations: Maintain region-specific compliance or business rule differences
- User Role Differences: Keep role-specific requirement variations intact
- Implementation Phases: Preserve requirements that apply to different implementation phases
6. Unified Specification Generation
Content Organization Strategy:
- Hierarchical Structure: Organize by business domain, then functional area, then specific requirements
- Cross-Cutting Concerns: Handle quality attributes, security, and performance as cross-cutting themes
- Dependencies and Relationships: Clearly document requirement dependencies and interaction patterns
- Prioritization Integration: Integrate priority levels and phasing information into unified structure
Quality Standards for Unified Output:
- Consistency: Uniform terminology, formatting, and specification patterns
- Completeness: All original requirement intent preserved and addressed
- Clarity: Clear, unambiguous language accessible to all stakeholders
- Testability: All requirements specified in testable, verifiable terms
- Traceability: Complete mapping between unified requirements and original sources
Format Optimization:
- Stakeholder-Specific Views: Generate different views optimized for different stakeholder needs
- Machine Processing: Provide structured formats suitable for automated processing
- Review Workflows: Optimize format for stakeholder review and approval processes
- Integration Ready: Format suitable for integration with project planning and development tools
Integration Points
Upstream Skills:
requirements-ingest: Process and normalize individual requirement sources before merging
goals-extract: Business objectives inform conflict resolution priorities and decisions
process-w5h: Stakeholder analysis guides conflict escalation and resolution workflows
domain-extractconcepts: Domain terminology consistency supports merge quality
Downstream Skills:
process-scopemin: Unified requirements feed into scope minimization and MVP planning
project-planning-tracking: Conflict resolution timelines integrate with overall project schedules
diagram-generatecollaboration: Unified requirements inform system interaction modeling
change-management: Requirement changes and conflict resolutions trigger change management
Collaboration Skills:
domain-alignentities: Ensure merged requirements maintain domain architecture consistency
project-status-reporting: Merge progress and conflict resolution status feed into project reporting
project-document-management: Unified specifications integrate with project documentation structure
Quality Assurance
Validation Checklist
Merge Completeness:
Conflict Resolution Quality:
Specification Quality:
Stakeholder Workflow:
Success Metrics
Process Effectiveness:
- Merge completion time (target: 2-5 business days for typical projects)
- Conflict resolution rate (target: >90% within initial stakeholder review cycle)
- Stakeholder approval rate for unified specifications (target: >95%)
- Requirement traceability accuracy (target: 100% traceable)
Quality Outcomes:
- Reduction in downstream requirement clarification requests (target: >70% reduction)
- Stakeholder satisfaction with unified specification quality (target: >90% satisfaction)
- Development team clarity on requirements (target: <5% implementation questions)
- Post-implementation requirement change rate (target: <10% post-merge changes)
Business Impact:
- Requirements phase duration optimization (target: 20-30% time reduction)
- Development velocity improvement due to requirement clarity
- Stakeholder alignment and conflict reduction in subsequent project phases
- Project risk reduction through early conflict identification and resolution
This skill provides comprehensive requirements merging capabilities that enable complex multi-stakeholder projects to achieve unified, coherent requirement specifications while maintaining stakeholder alignment and project governance standards.