Setup Prompt

# Agent Context — Setup & Update

> **Usage:** This prompt is fetched remotely from the latest release tag — it is NOT deployed locally to target projects.
> It auto-detects SETUP vs. UPDATE mode and handles both flows.

## Global Constraint: Knowledge Map Sources

**This rule applies everywhere in this prompt — no exceptions.**

A file may only appear in `knowledge-map.md` if ALL of the following are true:

1. It is tracked or staged by git, or untracked but not gitignored (`git ls-files --cached --others --exclude-standard`)
2. It contains project knowledge — documentation, architecture decisions, conventions, domain facts
3. It is NOT agent-managed infrastructure (skills, agents, rules, plugins, or any tooling the agent self-indexes)

## File Classification: AI Docs vs Real Docs

This classification is used in UPDATE mode (Migration Cleanup step) and SETUP mode (cleanup and verification phases).

### AI Docs (migratable — safe to delete/replace)

Built-in directories and files always treated as AI docs:

- `.ai/`
- `.agent-context/` (only migrate away from it when replacing with a newer structure — never delete the current destination)
- `AGENTS.md` (Agent-Context entry point — never delete during migration, only referenced)
- `CLAUDE.md` (root)
- `GEMINI.md` (root)
- `.claude/CLAUDE.md` (bootstrap pointer — never delete during migration, only referenced)
- `.cursorrules`
- `.cursor/rules/`
- `.github/copilot-instructions.md`

If the prompt was invoked with an `--ai-dirs` argument (injected by `install.sh`), those directories extend this built-in list.

### Real Docs (never modify, move, or delete)

Any file **not** in a built-in AI-doc path or a directory supplied via `--ai-dirs` is automatically a **Real Doc**. Only treat classification as uncertain for files **inside** those candidate AI-managed locations when it is unclear whether they are agent-managed infrastructure or project knowledge; in that case, default to **Real Doc** (conservative) and add it to the `UNRESOLVED` list in the post-migration report.

---

## Step 0: Interactive Mode Detection (MUST run first, before anything else)

**This is the very first action. Run it immediately before reading or acting on any other step.**

Run this bash command and store the result: