agent-config-sync · diff
v0.3.0 to v0.3.0
16 added, 120 removed. Audit A to A.
---
name: agent-config-sync
version: 0.3.0
type: protocol
author: Lukas Geiger + Claude + Codex
created: 2026-06-20
updated: 2026-07-27
- description: >
- Anbieterneutraler Sync-Planer für MCP-Konfigurationen, Skills und Regeldateien
- über Agent-Anbieter und App-Klassen. Er inventarisiert live erkennbare
- Möglichkeiten, bietet Auswahlachsen an und lässt den User Quelle der Wahrheit,
- Ziele, Richtung und Konfliktstrategie bestimmen. Truth kann eine Endpoint-
- Konfiguration, eine Datei oder eine geordnete Menge mehrerer Dateien sein.
+ description: Provider-neutral planner for synchronizing MCP configuration, skills and rule files across agent providers and app classes. It discovers evidenced local options and lets the user choose truth, targets, direction and conflicts.
+
standalone: true
anthropic_compatible: true
bach_compatible: true
bach_origin: false
category: infrastructure
tags: [mcp, skills, rules, sync, provider-neutral, discovery, multi-agent]
language: de
status: active
aliases: [mcp-skill-sync, multi-agent-sync, tool-config-sync, agent-sync]
- dependencies:
- tools: [python]
- services: []
- protocols: []
- python: []
- provenance:
- origin: "custom"
- origin_path: "skills/infrastructure/agent-config-sync/"
- origin_version: "0.3.0"
- last_sync_from_origin: null
- last_sync_to_origin: null
- local_changes_since_sync: false
+ dependencies: {'tools': ['python'], 'services': [], 'protocols': [], 'python': []}
+ provenance: {'origin': 'custom', 'origin_path': 'skills/infrastructure/agent-config-sync/', 'origin_version': '0.3.0', 'last_sync_from_origin': None, 'last_sync_to_origin': None, 'local_changes_since_sync': False}
---
- <img src="banner.png" width="100%" alt="agent-config-sync banner">
-
- # Agent Config Sync
-
- Der Skill trennt drei Entscheidungen:
-
- 1. **Endpoints:** Welche installierten Agenten, CLIs, IDEs oder Desktop-Apps?
- 2. **Ressourcen:** MCP, Skills, Regeln oder eine explizite Teilmenge?
- 3. **Truth:** Welche Quelle(n), Richtung und Konfliktregel?
+ > **Deutsch** — Offizielle Deutsch-Version / Documento Oficial en Deutsch.
- Keine dieser Entscheidungen wird aus dem Anbieter des aufrufenden Agenten
- abgeleitet.
- ## Ablauf
+ # Agent Config Sync (Deutsch)
- ### 1. System inventarisieren
+ The skill separates endpoint selection, resources and truth. Run:
```bash
python scripts/sync.py --discover
python scripts/sync.py --offer
```
- `--discover` prüft bekannte CLI-Kommandos und konfigurierte Oberflächen.
- „Bekannt“ bedeutet nur im Katalog geführt; „erkannt“ benötigt lokale Evidenz.
- `--offer` bildet daraus:
-
- - Anbieterachse: ein Anbieter über mehrere App-Klassen,
- - App-Klassenachse: eine Klasse über mehrere Anbieter,
- - Gesamtachse: alle erkannten Endpoints.
-
- ### 2. User-Auswahl erfassen
-
- Der User darf konkrete Namen oder eine Achse nennen. Danach explizit festhalten:
-
- - Mitglieder/Ziele,
- - Ressourcen (`mcp`, `skills`, `rules`),
- - Modus (`push`, `pull`, `bidirectional`),
- - Truth-Quelle(n),
- - Konfliktstrategie.
-
- Ohne gewählte Truth-Quelle bleibt der Plan blockiert.
-
- ### 3. Truth modellieren
-
- Eine Truth kann sein:
-
- - ein Endpoint, etwa eine existierende MCP-Konfiguration,
- - eine frei gewählte Datei,
- - mehrere geordnete Dateien, etwa globale `AGENTS.md` plus Projektregeln,
- - ein Verzeichnis für Skills.
-
- Mehrere Regeldateien brauchen eine explizite Strategie:
- `ordered-overlay`, `generated-loader`, `copy` oder `redirect`. Konflikte werden
- nicht geraten. `CLAUDE.md`, `AGENTS.md`, `GPT.md` oder andere Namen sind
- gleichberechtigte mögliche Quellen; keine davon ist global voreingestellt.
-
- ### 4. Plan, Apply, Verifikation
-
- ```bash
- python scripts/sync.py --status
- python scripts/sync.py --plan
- python scripts/sync.py --apply --yes
- ```
-
- `--apply` unterstützt derzeit MCP-Block-Transfers und Skill-Verzeichnisse.
- Regeldatei-Topologien werden geplant, aber nur über einen vom User gewählten
- Adapter umgesetzt; dadurch wird keine mehrteilige Truth versehentlich
- plattkopiert.
-
- ## Registry
-
- Die publizierte `registry.example.json` enthält keine aktive Relation und keinen
- Hub. Eine lokale, gitignorierte `registry.json` hält nur die User-Entscheidung.
- Selektoren dürfen Provider und App-Klassen kombinieren:
-
- ```json
- {
- "name": "selected-cli-sync",
- "selection": {
- "providers": ["openai", "anthropic"],
- "app_classes": ["cli"]
- },
- "mode": "push",
- "source": "codex-cli",
- "scope": "mcp"
- }
- ```
-
- Siehe `REGISTRY.md` für Datei-Truth und Mehrfachquellen.
-
- ## Abgrenzung
-
- - `mcp-config-sync` ist der MCP-spezifische Einstieg in diesen Skill.
- - `agents-bridge` erzeugt Bootstrap-/Redirect-Regeln für fremde Agenten.
- - `ellmos-agent-bridge` routet und koordiniert Partner zur Laufzeit.
- - ControlCenter kann ein Adapter sein, ist aber keine notwendige zentrale Truth.
-
- ## Sicherheit
-
- - Discovery, Offer und Plan sind read-only für Agent-Konfigurationen.
- - `--apply` braucht `--yes`, Backups und Re-Read-Verifikation.
- - Unverifizierte Formate und Pfade bleiben gesperrt.
- - Lokale Registry/Cache-Dateien bleiben privat und gitignored.
-
- ## Changelog
-
- ### 0.3.0 (2026-07-27)
+ The user can select an explicit endpoint list, one provider across app classes,
+ one app class across providers, or all detected endpoints. Detection is
+ evidence, not authorization.
- - Anbieter- und App-Klassenachsen sowie lokale Discovery/Offers.
- - Kein voreingestellter Claude-Hub.
- - Frei wählbare einzelne oder mehrere Truth-Dateien.
- - Regeldateien als eigener Scope; Apply bleibt bis zur Adapterwahl fail-closed.
+ Truth can be one endpoint, one file, an ordered set of files such as multiple
+ `AGENTS.md` layers, or a skills directory. No filename or provider is the
+ implicit hub. Without a selected truth source, plans stay blocked.
+ Review `--status` and `--plan`; only use `--apply --yes` after approval.
+ MCP blocks and skill directories are implemented. Rule-file topologies remain
+ fail-closed until the user selects a merge/redirect adapter.