omniscitus-migrate

Omniscitus Migrate — Bring Any Existing Project Into Omniscitus

Analyze an existing codebase and bootstrap the full .omniscitus/ structure from what already exists: docs, git history, test code, and conversation with the user.

When to Use

• User types /omniscitus-migrate
• Applying omniscitus to a project that already has code, docs, and tests

Instructions

Pre-check A: Git Repo Required (uninstall safety)

Omniscitus writes to a few files outside .omniscitus/ (e.g., CLAUDE.md, member docs). The ability to cleanly uninstall later depends on a git repo — we record a pre-migration anchor commit SHA so those files can be reverted surgically. Without git, rollback is entirely manual.

git rev-parse --show-toplevel 2>/dev/null

If this fails (non-zero exit / empty output):

Use AskUserQuestion:

• question: "Omniscitus's clean uninstall depends on a git repo. How to proceed?"

• options:

  • "git init first (Recommended)"
  • "Proceed without rollback safety"
  • "Abort"

• "init first" → run git init && git add -A && git commit -m "baseline: pre-omniscitus" then continue.

• "proceed without" → continue but flag git_project: false in anchor.yaml. Uninstall will be entirely manual.

• "abort" → stop here.

If git repo is present but dirty (git status --porcelain non-empty):

Warn: "You have uncommitted changes. The anchor SHA will record the last committed HEAD, so uncommitted edits will NOT be covered by rollback. Commit or stash first for the safest migration."

Use AskUserQuestion:

• options: "Commit first" / "Continue anyway"

Pre-check B: Record the Anchor

Before any file is written (outside .omniscitus/ or inside), create .omniscitus/migrate/anchor.yaml:

version: 1

# Pre-migration git state — the point /omniscitus-uninstall reverts to.
anchor:
  sha: {git rev-parse HEAD}
  branch: {git branch --show-current or "HEAD detached"}
  timestamp: {now ISO 8601}
  git_project: true          # false if user chose "Proceed without"

# Plugin version that last wrote the canonical footprint content
# (CLAUDE.md block, statusline block, README, …). Bumped by /migrate and
# /omniscitus-update. SessionStart's version-check compares this against
# the installed plugin version to nag the user about staleness.
migrate_version: {plugins/omniscitus/.claude-plugin/plugin.json → version}

# Files modified OUTSIDE .omniscitus/ by any omniscitus skill.
# Every external write must append an entry here so uninstall can
# surgically reverse them. Paths are relative to the project root.
footprint: []