Use case

Intent-level conflict detection

Stacked intent blocks aligned along a single axis
By Tetherlab team
Updated 2026-05-29

Overview

A diff tells you what changed. It cannot tell you that the change broke a contract another module relied on. By the time a diff exists, the work is done and the conflict is expensive.

Intent-level conflict detection moves the check earlier. Each agent declares what it is about to do. The master spots the overlap, the dependency break, and the contradicting assumption before either agent writes a line.

Diffs catch conflicts too late

Git was built for humans typing slowly. It shows line changes. It cannot say this change broke the contract that module X relied on. Two agents can touch completely different files and still collide at the concept level.

Detection at merge time means the cost has already been paid: both agents finished, both diffs exist, and someone has to unwind one of them. The bottleneck moved from writing code to reconciling it.

Catching conflicts on the way in

The shim coaxes a plan out of the agent's natural turn-taking and submits it to the master as an intent: a natural-language summary plus steps. The agent never enumerates paths or symbols. It describes the work in sentences, and the master derives the concrete claims.

When the intent arrives, the master resolves concepts, derives the files and symbols the agent will likely touch, detects conflicts against all active intents, and returns a verdict plus the relevant world slice. The richer the intent, the smarter the verdict.

ConflictWhat it meansWhen detected
Hard conflictTwo intents modify the same conceptWhen the second plan lands
Soft conflictTwo in-flight implementations contradictFrom observed code (Phase 2)

How concept matching works

The master is LLM-driven from day one for one job: matching. It walks the linked-file memory to pull candidate concepts connected to the intent's area, reasons over the intent and the candidates, and decides matched-existing, propose-new, or refuse.

Every decision mutates the registry. A match adds realizations, refines names, and bumps contract checksums. Lexical similarity alone cannot read a natural-language intent, which is why the lookup plus reasoning loop is there from the first version, not bolted on later.

Rescopes as a first-class primitive

Plans drift. During execution the shim resolves the agent's file writes to concepts, a semantic diff rather than a line diff. When a write lands on a concept outside the plan's matched set, the shim asks the agent to explain, then submits that explanation as a rescope intent on the same code path.

Planned and unplanned intents run the same matching and conflict pipeline. The master sees one uniform primitive whether the work was declared up front or discovered mid-flight.

Next steps

See the semantic concept catalogue for the registry the matching loop reads from, or why a coordination layer beats more guardrails for the argument behind catching conflicts at the plan stage.

Frequently asked questions

How can two agents conflict if they edit different files?

At the concept level. If one agent deprecates a contract and another builds on it, the files never overlap but the work does. The master matches intents to concepts, so it catches the collision that a file diff would miss.

What are the master's possible verdicts?

Three actions: continue, stop, or revert. There is no soft pause, because agent completion times are non-deterministic and a time-based lock would deadlock or starve.

Is soft-conflict detection available today?

Hard-conflict detection (two intents modifying the same concept) runs today. Soft-conflict detection, which compares the in-flight code two agents are producing, is Phase 2.

/ ready to start

Wrap one agent.
See the difference.