adopt

What problem does it solve? You already have a knowledge base, notes repo, or Obsidian vault, and you want it managed under the kb system without risking any modification to its contents. This Skill registers that existing tree, reports how it diverges from the expected contract, and optionally migrates trees still on the old layout. ## Core Features & Use Cases - Zero-write registration: Runs kb adopt <path> to register an existing tree while guaranteeing nothing is written into it, treating divergence as a finding rather than an error. - Divergence reporting: Detects .kb/base.yml, runs the full lint as a divergence report, and honours the most-restrictive audience rule so a shared tree cannot be registered as private. - Old-layout migration: Detects a root BASE.yaml with no .kb/ directory and, with user agreement, runs kb migrate --base <path> which moves files with git mv so history follows each file. - Use Case: During bootstrap you point the agent at your existing Obsidian vault ('adopt ~/my-vault'); it registers the vault, shows which contract files are missing, and outlines the convergence path without touching a single note. ## Quick Start Ask your agent to adopt your existing knowledge base, for example: adopt ~/my-kb as a base and tell me how it diverges from the expected layout.