docs: surface conjure adopt in MIGRATION-GUIDE, brownfield checklist, COMPARISON; fix stale 112→439 test count

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: mohandoz

COMPARISON.md

@@ -38,7 +38,7 @@ updated: 2026-05-24.
 
 ### vs. Manual `.claude/`
 - **Manual**: total flexibility, total responsibility.
-- **Conjure**: opinionated defaults backed by Anthropic + community eval data; backup-before-mutate on every change; size caps enforced; cross-platform Node.js hooks; safe migration from other tools.
+- **Conjure**: opinionated defaults backed by Anthropic + community eval data; backup-before-mutate on every change; size caps enforced; cross-platform Node.js hooks; safe migration from other tools; one-command brownfield adoption (`conjure adopt`) with full snapshot + sha256-verified rollback.
 - **Trade-off**: manual is faster *for the first project*. Conjure pays back at scale (multiple projects, team handoffs, kit updates).
 
 ### vs. CursorRules → CLAUDE.md by hand

MIGRATION-GUIDE.md

@@ -16,6 +16,33 @@ without losing rules and without breaking running sessions.
 | `.github/copilot-instructions.md` | file exists | `from-copilot` | Instructions → CLAUDE.md non-negotiable rules. |
 | `.windsurfrules` | file exists | `from-windsurf` | Rules → CLAUDE.md. |
 
+## Adopting a whole repo — `conjure adopt`
+
+`conjure migrate` converts a **prior AI tool's config** into a Conjure `.claude/`.
+To fold an **entire existing repo** (oversized `CLAUDE.md`, scattered docs, prior
+GSD `.planning/`, or no AI config at all) into the four-layer harness, use
+`conjure adopt` — a rollback-capable, snapshot-backed pipeline:
+
+```bash
+conjure adopt --dry-run .   # 5-step plan, zero writes, inspectable manifest
+conjure adopt .             # snapshot → inventory → scaffold → audit → report
+conjure adopt --rollback .  # sha256-verified restore + delete scaffolded files
+```
+
+- Full timestamped snapshot before any mutation; `--rollback` restores every
+  mutated file (sha256-verified) and removes scaffolded layers. Crash-durable —
+  a killed run offers `[r]ollback / [c]ontinue / [s]tart-fresh` on re-run.
+- Never-delete: stale/oversized files are archived to `.conjure-archive-<ts>/`.
+- Refuses a dirty git tree (commit/stash, or `--force`); every step logged to
+  `RESTRUCTURE-LOG.md`.
+- Installs a human-gated `restructure` skill (`.claude/skills/restructure/`,
+  `[Read, Bash]`) that condenses an oversized `CLAUDE.md` through pre-write
+  invariant + `conjure audit` gates and applies changes only through the audited
+  `conjure adopt` chokepoint.
+
+Choose: greenfield → `conjure init` · convert another tool's config →
+`conjure migrate` (above) · adopt an existing repo → `conjure adopt`.
+
 ## Universal safety rules
 
 1. **Backup before mutate.** Every migration creates `<target>/.claude.backup-YYYYMMDD-HHMMSS/`

README.md

@@ -54,7 +54,7 @@ foot-guns, cross-platform Node.js hooks.
 - 🛡 **Safe migrations** — backup-before-mutate from Cursor, Aider, Continue, GitHub Copilot, Windsurf, and existing `.claude/` configs.
 - 🎯 **9 stack profiles** — Java-Spring, Python-FastAPI, TS-Next, Rust-Axum, Go-Gin, Node-Nest, Monorepo, Polyglot, Data Science.
 - 🔒 **4 compliance overlays** — HIPAA (with PHI scan hook), SOC 2, GDPR, PCI.
-- 🧪 **112 self-tests, all green** — change confidently; CI runs on every PR.
+- 🧪 **439 self-tests, all green** (Linux + Windows + macOS) — change confidently; CI runs on every PR.
 - 🌍 **Cross-platform** — bash hooks for POSIX, Node.js `.mjs` hooks for native Windows.
 - 📦 **Plugin-ready** — installable via Claude Code Marketplace.
 - 🔁 **Compound engineering** — Stop hook proposes new rules from session corrections.

checklists/EXISTING-PROJECT.md

@@ -2,6 +2,24 @@
 
 Use when adding Claude Code config to a repo that already has code.
 
+## Fast path — `conjure adopt`
+
+For most repos, one rollback-capable command does the brownfield onboarding:
+
+```bash
+conjure adopt --dry-run .   # inspect the 5-step plan (zero writes)
+conjure adopt .             # snapshot → inventory → scaffold → audit → report
+# Undo anytime: conjure adopt --rollback .   (sha256-verified restore)
+```
+
+It snapshots before mutating, scaffolds only missing harness layers (existing
+files untouched), archives (never deletes) stale files, and installs a
+human-gated `restructure` skill to condense an oversized `CLAUDE.md` through
+pre-write safety gates. Refuses a dirty git tree — commit/stash first (or
+`--force`). Then open Claude Code and run the `restructure` skill to approve the
+CLAUDE.md condensation step-by-step. The manual steps below remain useful for
+deep customization (knowledge graph, per-area skills).
+
 ## Pre-Claude (5-minute prep)
 
 - [ ] Confirm clean working tree (`git status`) or stash. Claude shouldn't fight uncommitted work.