semantic-conflict-prediction

Predicts semantic conflicts from concurrent code modifications using AST-based analysis and symbol-level claims.

2|Updated Feb 11, 2026
One-click install
npx skills add https://github.com/curiositech/port-daddy --skill semantic-conflict-prediction
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: semantic-conflict-prediction
Source: https://github.com/curiositech/port-daddy/tree/main/skills/semantic-conflict-prediction
Command: npx skills add https://github.com/curiositech/port-daddy --skill semantic-conflict-prediction

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Detects semantic conflicts that textual merges miss by analyzing code structure and intent so concurrent agent edits do not produce build or runtime breakages after merging. It finds mismatches like signature changes, transitive dependency breaks, and renames that standard git merges cannot surface.

Core Features & Use Cases

  • AST-based symbol extraction: Use tree-sitter to identify functions, methods, classes, and exported symbols across polyglot repositories.
  • Symbol-level claims: Model agent intent as read/modify/add/delete/rename claims at the function/method level to enable fine-grained coordination.
  • Incremental dependency graphs and call/type edges: Build and update dependency graphs lazily to estimate blast radius and transitive impact of changes.
  • Conflict prediction & scoring: Classify direct, dependency, and transitive conflicts with severity and confidence scores and produce suggested resolutions.
  • Integration scenarios: Ideal for coordination daemons, Arbiters enforcing SymbolClaimConsistency, and multi-agent task assignment before work begins.

Quick Start

Ask the system to analyze two agents' pending symbol claims and report blocking or warning conflicts with explanations and confidence scores.

Frequently Asked Questions about semantic-conflict-prediction

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

FAQPage Schema
How do I detect semantic code conflicts that git merges miss in a multi-agent codebase?

To detect semantic code conflicts that textual merges miss, analyze code structure and agent intent using AST-based parsing and symbol-level claims. This approach surfaces signature changes, transitive dependency breaks, and renames that standard git merges cannot identify.

What is semantic conflict prediction and how does tree-sitter help identify code breakages?

Semantic conflict prediction identifies mismatches like signature changes and dependency breaks before merging. Tree-sitter enables AST-based symbol extraction, parsing functions, methods, and classes across polyglot repositories to model agent intents and estimate transitive impact.

How do I coordinate multiple agents modifying the same codebase without causing build breakages?

You coordinate concurrent agents by modeling their intents as read, modify, add, delete, or rename claims at the function level. Analyzing these symbol claims against an incremental dependency graph predicts blocking conflicts and prevents build breakages before work begins.

Can I use dependency graph analysis to estimate the blast radius of function signature changes?

Yes, you can build and update incremental dependency graphs lazily to estimate the blast radius of function signature changes. By mapping call and type edges, the analysis calculates the transitive impact and scores conflict severity with confidence metrics.

What is the best way to prevent transitive dependency conflicts during concurrent code modifications?

The best way to prevent transitive dependency conflicts is to classify direct, dependency, and transitive conflicts using AST-based analysis before merging. This scoring mechanism evaluates severity and confidence, producing suggested resolutions to avoid runtime breakages.

Does semantic conflict prediction work for polyglot repositories with multiple programming languages?

Yes, semantic conflict prediction works for polyglot repositories by using tree-sitter to identify functions, methods, classes, and exported symbols across multiple languages. This AST-based extraction standardizes symbol-level claims for consistent conflict analysis.