repo-harness-setup

# repo-harness-setup Canonical rule owner for init, migrate, upgrade, repair, scaffold, and capability configuration. Router-only: shared preflight, mode selection, and cross-mode boundaries. Mode protocol lives under `references/`. ## Shared Preflight 1. Confirm the target repo path (`pwd`, or an explicit `--repo` argument). 2. Run `bun scripts/inspect-project-state.ts --repo <repo> --format text` when available. ## Mode Selection - No harness yet, or refreshing an existing install -> `references/init.md`. - Inspector reports legacy docs or stale harness artifacts -> `references/migrate.md`. - Harness present, needs latest contract/helpers/templates -> `references/upgrade.md`. - A specific workflow surface is broken -> `references/repair.md`. - New project/app/module skeleton, no existing repo workflow -> `references/scaffold.md`. - Add or sync one capability boundary only -> `references/capability.md`. ## Boundaries - Never write user-level (`HOME`) state from a repo-scoped mode; user-level setup is the separate `repo-harness update` command. - Preserve user-authored repo files unless the workflow contract owns the generated surface; remove only `ownership=known_generated` files. - Does not create an application stack from any mode except `scaffold`. - Does not expose internal helper scripts (`create-project-dirs`, direct `scripts/init-project.sh`, `hooks-init`, `docs-init`) as public commands. - Does not infer capability prefixes from broad directory globs; always u...