conflict-resolution
Use when two or more agents produce conflicting outputs, recommendations, or decisions. This skill provides a structured process for resolving disagreements between agents, ensuring conflicts are reso
SKILL.mdskills/shared/conflict-resolution/SKILL.md
GitHubConflict Resolution
Overview
This skill handles situations where multiple agents produce conflicting information, recommendations, or decisions. Unresolved conflicts can cause downstream errors, wasted work, and system inconsistency. Use this skill whenever conflicting outputs are detected.
When to Use
- When two agents give contradictory analysis or recommendations
- When code from different agents conflicts (different styles, approaches, versions)
- When research findings contradict each other
- When different companies have incompatible standards or approaches
- When knowledge base entries conflict with each other
- Don't use when: Differences are preferences with no functional impact, or one source is clearly superseded
Core Procedures
Step 1: Identify the Conflict
Document specifically what conflicts:
- Agent A states: [what A says]
- Agent B states: [what B says]
- Conflict point: [exactly what disagrees]
Step 2: Assess Conflict Type
| Type | Description | Resolution Approach |
|---|---|---|
| Factual | Different claims about reality | Source verification against authoritative source |
| Technical | Different technical approaches | Evaluate against requirements, test both |
| Standards | Different standards or conventions | Follow project/team standard, or agree on one |
| Priority | Different decisions about what matters | Escalate to decision-maker with both options |
| Temporal | One is outdated, one is current | Verify dates, supersede outdated information |
Step 3: Resolve Conflict
Based on conflict type:
FACTUAL CONFLICTS:
- Apply source-verification skill to both claims
- Determine which claim has higher confidence
- If both are HIGH confidence from credible sources, note context where each applies
TECHNICAL CONFLICTS:
- List requirements both approaches must meet
- Evaluate each approach against requirements
- If both meet requirements, choose simpler/more maintainable
- If neither clearly wins, escalate to domain specialist
STANDARDS CONFLICTS:
- Check project/team documentation for stated standards
- If standard exists, follow it
- If no standard exists, propose one and escalate for decision
- Document the decision for future reference
PRIORITY CONFLICTS:
- Document both positions clearly
- Evaluate trade-offs of each choice
- Escalate to appropriate decision-maker (CEO, Council, project owner)
- Implement the decision and document rationale
Step 4: Document Resolution
CONFLICT RESOLUTION
===================
Conflict: [brief description]
Parties: [which agents or sources disagree]
Type: [factual/technical/standards/priority/temporal]
RESOLUTION:
[what was decided and why]
EVIDENCE:
[what supported the decision]
SUPERSEDES:
[which conflicting entry is now invalid - mark it as superseded]
APPLIES TO:
[scope of this resolution - what future situations this covers]
Step 5: Propagate Resolution
- Update any affected deliverables with the resolved position
- Mark superseded/conflicting information as outdated
- Notify affected agents of the resolution
- Capture as knowledge for future conflicts
Quality Checklist
- Conflict clearly identified with specific disagreement points
- Conflict type correctly classified
- Resolution based on evidence and clear reasoning
- Superseded information marked as such
- Resolution documented for future reference
- Affected parties notified
Error Handling
- Error: Cannot determine authoritative source Response: Escalate to governance body (Council) with both positions documented
- Error: Resolution creates new conflicts with other information Response: Expand scope of resolution to cover all conflicting information
- Error: Parties reject the resolution Response: Escalate to their manager with full documentation of process used
- Error: Conflict is blocking critical work Response: Make interim decision based on best available information, flag for formal resolution
Cross-Team Integration
Related Skills: source-verification, escalation-management, knowledge-capture, decision-logging Used By: ALL agents, especially QualityForge (Guardian, Standards, Council) and governance agents