2 min read
Bootstrap Sync
Portable setup quickref for syncing Kevin's canonical agent config and executable skills into Cursor, Claude, Codex, and the universal
~/.agents/skillsbridge.
Open this page on a fresh machine, after a pull that changes config/skills, or when a harness cannot see Kevin's current rules or skills. Canonical protocol: Config Sync Protocol.
Commands
npm run bootstrap
# or
scripts/bootstrap-agent-config.sh
Verify only:
npx tsx scripts/apply-agent-config.ts --verify
npx tsx scripts/doctor.ts --only config-sync
What Bootstrap Owns
| Step | Contract |
|---|---|
| Backup | Back up existing real files at symlink targets; existing symlinks are replaced. |
| Link | Create symlinks from config/ and skills/ into agent homes. |
| Skills | Expose category skill sources through runtime projections and ~/.agents/skills. |
| Hooks | Install git hooks so pulls/branch switches re-run sync. |
| Verify | Fail closed if expected links do not resolve to this repo. |
Projection Layers
| Layer | Location | Scope |
|---|---|---|
| Global Cursor rules | config/cursor/rules/ -> ~/.cursor/rules |
All Cursor repos. |
| Wiki workspace rules | .cursor/rules/ |
kevin-wiki only. |
| Runtime skills | skills/.runtime/all |
Flat runtime view consumed by agents. |
| Universal skill bridge | ~/.agents/skills |
Shared AgentSkills-compatible harness path. |
Closeout
After changing config links, skills, generated runtime links, or harness projections, run npm run bootstrap, npm run skills:check or the owning skill-registry check, npx tsx scripts/doctor.ts --only config-sync, npm run build-index, and qmd update && qmd embed.
Timeline
- 2026-07-01 | Rebuilt as a portable config-sync quickref tied to Config Sync Protocol, runtime skill projections, and generated-surface closeout. Source: User request, 2026-07-01
- 2026-06-29 | Clarified
~/.agents/skillsas the universal skill bridge: most harnesses read it directly, and bespoke harness skill directories should symlink or point there. Source: User correction, 2026-06-29 - 2026-06-27 | Bootstrap skill validation now checks executable skills against Skill Registry and family pages instead of one wiki article per skill. Source: User request, 2026-06-27
- 2026-06-24 | Bootstrap validated the old skill taxonomy completeness model where a fresh clone failed if a catalog page lacked an executable skill or an executable skill lacked a catalog page. Superseded by the 2026-06-27 registry model. Source: User request, 2026-06-24
- 2026-06-03 | Bootstrap refactored to
scripts/apply-agent-config.tswith canonical symlink map inscripts/lib/agent-config-links.ts; self-verify on exit; doctor checked the then-current symlink set. Source: User, 2026-06-03 - 2026-05-31 | Agent doc created from bootstrap script and config-sync. Source: Agent Config Sync, 2026-05-31