resolve-spec-conflict

Analyze plain spec files to identify conflict root causes and suggest resolution strategies.

Updated Jul 3, 2026
One-click install
npx skills add https://github.com/Codeplain-ai/onboarding-flow --skill resolve-spec-conflict
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: resolve-spec-conflict
Source: https://github.com/Codeplain-ai/onboarding-flow/tree/main/.claude/skills/resolve-spec-conflict
Command: npx skills add https://github.com/Codeplain-ai/onboarding-flow --skill resolve-spec-conflict

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps resolve conflicts between two functional specs in a plain spec file. It's useful when conformance tests fail after a new spec is added or when potential conflicts are detected.

Core Features & Use Cases

  • Conflict Detection: Automatically identify conflicts between specs based on conformance test failures.
  • Root Cause Analysis: Diagnose whether conflicts arise from implementation issues, incorrect tests, or true contradictions.
  • Resolution Strategies: Provide strategies to resolve conflicts, including disambiguation, revising specs, or merging them.
  • Validation: Validate the resolution by checking for new conflicts, respecting LOC limits, and maintaining chronological order.

Quick Start

To resolve a spec conflict, use the skill resolve-spec-conflict with the command: 'resolve-conflict --specs spec1.plain spec2.plain'

Frequently Asked Questions about resolve-spec-conflict

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I resolve functional spec conflicts in plain spec files?

To resolve functional spec conflicts, analyze the plain spec files to identify root causes and generate resolution strategies. This process diagnoses whether failures stem from implementation issues, incorrect tests, or true contradictions between the specs.

What causes conflicts between functional specs during software development?

Conflicts between functional specs typically arise when a newly added spec contradicts an existing one, which is often detected through conformance test failures. Root causes include actual specification contradictions or underlying implementation issues.

How do I analyze the root cause of failing conformance tests in spec files?

Analyzing failing conformance tests involves reviewing the plain spec files to diagnose the conflict source. The analysis determines whether the failure is caused by an incorrect test, an implementation bug, or a genuine functional spec contradiction.

What strategies are used to resolve conflicts between functional specs?

Strategies to resolve functional spec conflicts include disambiguating the requirements, revising the existing specs, or merging the conflicting specifications. The chosen strategy is validated by checking for new conflicts and maintaining chronological order.

Can I automate conflict resolution for plain spec files without manual review?

Automating conflict resolution for plain spec files identifies contradictions and suggests resolution strategies, but validation requires checking for new conflicts, respecting LOC limits, and maintaining chronological order to ensure correctness.

What are the limitations of automated spec conflict resolution?

Limitations of automated spec conflict resolution include the necessity to validate that suggested resolutions do not introduce new conflicts, exceed LOC limits, or disrupt the chronological order of the plain spec files.