t1k:unity:base:preflight
| Field | Value |
|---|---|
| Module | base |
| Version | 5.116.6 |
| Effort | low |
| Tools | Bash, 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
How to invoke
Section titled “How to invoke”/t1k:unity:base:preflightUnity 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/.
- Project facts. The session
.claudemust hold the unity kit (t1k-config-unity.json), the gate script must resolve, every.gitmodulespath the project depends on must be checked out, and asmdefs should reference a studio library./t1k:doctorcheck #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. Seereferences/project-facts.md. A worktree whoseLibrary/or submodule directories were copied from another checkout is not a checkout: a copied submodule.gitfile breaksgit status, and a badLibrarycopy looks like a missing asset. Re-seed per the “Seeded Library with no submodule content” section ofparallel-worktree-testing.mdint1k-unity-testing-workflow. - Batch gate. Never launch the editor raw.
source .claude/scripts/unity-batch-gate.sh, thenunity_batch_gate_runor, for tests,unity_batch_gate_run_tests. Exit 77 is NOT a pass: it meansno-results,zero-testsorall-skipped. Seereferences/batch-gate.md. - Reuse first. Search the studio libraries before writing a new
.cs, then state the outcome as areuse-search:record (grammar:docs/reuse-search-record.md). A verdict line with no search behind it is refused. Seereferences/reuse-first.md. A new Unity API member also needs its doc XML line first (same reference, last section). - Where libraries are.
.claude/t1k-libraries-unity.jsonmaps category to repo and package; resolve one witht1k-lib-registry. Pointers only, never a copied list.
Executed by
Section titled “Executed by”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.