Skip to content

t1k:unity:base:preflight

FieldValue
Modulebase
Version5.116.6
Effortlow
ToolsBash, Glob, Grep, Read

Keywords: batch gate, before writing unity code, exit 77, implement unity system, new unity feature, reuse-search record, unity preflight, unity-health

/t1k:unity:base:preflight

Unity Preflight: four checks before you touch a project

Section titled “Unity Preflight: four checks before you touch a project”

Core hooks name this skill when they block or warn: the [t1k:unity-health ...] SessionStart line, a denied new .cs, a denied raw editor launch. Do the checks, then work. Detail lives in references/.

  1. Project facts. The session .claude must hold the unity kit (t1k-config-unity.json), the gate script must resolve, every .gitmodules path the project depends on must be checked out, and asmdefs should reference a studio library. /t1k:doctor check #109 prints all of it; a [t1k:unity-health missing=...] line is the short form. Fix with the command the line gives (t1k modules update, git submodule update --init <path>), or restart the session in the Unity folder that holds the kit. See references/project-facts.md. A worktree whose Library/ or submodule directories were copied from another checkout is not a checkout: a copied submodule .git file breaks git status, and a bad Library copy looks like a missing asset. Re-seed per the “Seeded Library with no submodule content” section of parallel-worktree-testing.md in t1k-unity-testing-workflow.
  2. Batch gate. Never launch the editor raw. source .claude/scripts/unity-batch-gate.sh, then unity_batch_gate_run or, for tests, unity_batch_gate_run_tests. Exit 77 is NOT a pass: it means no-results, zero-tests or all-skipped. See references/batch-gate.md.
  3. Reuse first. Search the studio libraries before writing a new .cs, then state the outcome as a reuse-search: record (grammar: docs/reuse-search-record.md). A verdict line with no search behind it is refused. See references/reuse-first.md. A new Unity API member also needs its doc XML line first (same reference, last section).
  4. Where libraries are. .claude/t1k-libraries-unity.json maps category to repo and package; resolve one with t1k-lib-registry. Pointers only, never a copied list.

Runs inline in the main session or an inline sub-agent: it is a checklist read, no sub-agent fan-out, no script of its own. The facts come from core hooks and /t1k:doctor; the reasoning over them stays with the caller.