Migration Guide

Move from manual CLAUDE.md / AGENTS.md to 0dai-managed configs.

Before you start

0dai preserves your existing content. AGENTS.md gets a managed block prepended — your custom content stays below. .claude/settings.json user preferences (model, permissionMode) are preserved during sync.

Step 1: Install CLI

npm install -g @0dai-dev/cli

Step 2: Initialize

cd your-project
0dai init

This detects your stack, generates ai/ layer and native configs. Existing files are merged, not overwritten.

Step 3: Verify

0dai doctor   # check health
0dai detect   # verify stack detection

Step 4: Review generated files

  • ai/manifest/commands.yaml — are build/test commands correct?
  • AGENTS.md — is your custom content preserved below the managed block?
  • .claude/settings.json — is your model/permissionMode intact?

Step 5: Keep in sync

0dai sync

Run after editing files in ai/ or when 0dai updates. Safe to run repeatedly — only changed files are updated.

What to commit

Commit everything in ai/ except volatile files (already in .gitignore): codebase-map.json, audit.jsonl, backups, swarm active/done.