2 min read
Config Sync Protocol
kevin-wikiowns agent config. Bootstrap projects that config into each agent's native home through symlinks and preset files.
This page is the operator checklist. Agent Config Sync is the reference architecture; scripts/lib/agent-config-links.ts is the executable source of truth. Keep both pages: this one answers "what command and checklist do I run?", while Agent Config Sync answers "why is the harness shaped this way?" Source: Agent Config Sync; scripts/lib/agent-config-links.ts
Source of Truth
| Source | Owns |
|---|---|
skills/{engineering,productivity,personal,misc}/ |
shared executable skill source taxonomy |
skills/{in-progress,deprecated}/ |
draft and retired executable skill source taxonomy |
skills/.runtime/all/ |
generated flat AgentSkills runtime index |
skills/.system/ |
hidden bundled/system skills projected into the runtime index |
config/cursor/rules/ |
global Cursor rules |
config/cursor/hooks/ and hooks.json |
global Cursor hooks |
config/cursor/mcp.json |
global Cursor MCP |
config/claude/CLAUDE.md |
global Claude Code preset |
config/codex/AGENTS.md |
global Codex preset |
config/dedalus/ |
reference mirror of Dedalus agent config |
Bootstrap
cd ~/Documents/GitHub/kevin-wiki
npm run bootstrap
Bootstrap should:
- back up real files at symlink targets
- create symlinks
- initialize submodules
- install git hooks
- verify links
Run the config doctor after manual changes:
npx tsx scripts/doctor.ts --only config-sync
When Config Changes
- Edit the canonical file in
kevin-wiki. - Update wiki reference docs if behavior changed.
- Update Cross-Agent Harness Portability when a new agent runtime or mapping changes.
- Update
wiki/SKILL-RESOLVER.mdwhen skill/tool routing changes. - Run bootstrap or doctor to verify symlinks.
- Rebuild index/qmd and log the change.
- Follow Generated Surface Contract when config changes require generated packs, runtime skill links, skill registry output, or qmd to refresh.
What Not To Sync
Do not put machine-local state into the wiki:
- plugin caches
- extensions
- per-project IDE state
- secrets or credential values
- runtime logs
- local browser sessions
Env var names and setup instructions are okay. Values are not.
Timeline
- 2026-07-01 | Clarified the intentional split between this operator checklist and Agent Config Sync, and added generated-surface closeout for config-related projections. Source: User request, 2026-07-01
- 2026-06-18 | Expanded config sync protocol with source-of-truth table, bootstrap expectations, change flow, and no-sync boundaries. Source: User request, 2026-06-18; Agent Config Sync
- 2026-05-31 | Protocol page created as operator checklist alongside config-sync reference. Source: Agent Config Sync
- 2026-06-03 | Expanded symlink checklist to seven targets and documented repo-scoped
.cursor/layer. Source: User, 2026-06-03