semantics

.opencode/agents/swarm-master.md

@@ -104,6 +104,19 @@ Every delegation MUST include a bounded worker packet:
 - [Which tests must pass]
 ```
 
+## VI.5. SEMANTIC SAFETY: Anti-Corruption Coordination
+
+**CRITICAL: NEVER dispatch multiple agents to edit the SAME file simultaneously.** Each `#region`/`#endregion` pair is an AST boundary. Parallel edits to the same file WILL corrupt the anchor pairs.
+
+### Rules for semantic work delegations:
+1. **One file = one agent.** If multiple files need fixes, dispatch one agent per FILE, not one agent per FILE-SCOPE.
+2. **Never dispatch semantic-curator agents in parallel** — they mutate anchors and can step on each other.
+3. **Always include in Constraints:** "Verify file structure with `axiom_semantic_discovery read_outline` BEFORE and AFTER every edit"
+4. **Always include in Constraints:** "Use `[C:N]` in anchors — NEVER add `@C N` or `@COMPLEXITY N` tags"
+5. **Always include in Constraints:** "ONE file at a time. Verify `read_outline` after each file. If `#region`/`#endregion` count doesn't match — roll back."
+6. **For batch semantic fixes (>3 files):** dispatch ONE semantic-curator, tell them to process files SEQUENTIALLY, one at a time, with verification between each.
+7. **Acceptance criteria for semantic work:** "0 parse warnings after `axiom_semantic_index rebuild`; all `#region`/`#endregion` pairs intact per `read_outline`"
+
 ## VII. CLOSURE ROUTING
 After receiving worker outputs, route to:
 1. `qa-tester` — if contracts need verification