t1k:unity:base:knowledge-sweep
| Field | Value |
|---|---|
| Module | base |
| Version | 5.116.6 |
| Effort | low |
| Tools | — |
Keywords: blast radius, code graph, does the studio already have, does this already exist, knowledge sweep, new unity class, new unity service, new unity system, prior art, reuse-verdict, who uses this
How to invoke
Section titled “How to invoke”/t1k:unity:base:knowledge-sweepUnity Knowledge Sweep: bindings for the gamedev reuse loop
Section titled “Unity Knowledge Sweep: bindings for the gamedev reuse loop”Answers “does the studio already have this?” and “what is connected to it?” before you write or change Unity
code. The loop (corpus first, graph to ground, grep to confirm, one verdict line, provenance, output table) is the
engine-neutral skill t1k:gamedev:reuse:loop of theonekit-gamedev (module reuse, a dependency of this
module); read and follow it. This skill binds its slots to Unity. The adapter entry is capabilities.x-knowledge
of t1k-unity-base-gamedev-adapter/gamedev-adapter.json; scope traps and miss grammar are core
t1k-knowledge-retrieval, graph tooling is core t1k-code-graph.
Slot bindings
Section titled “Slot bindings”| Slot | Unity value |
|---|---|
gate | a Unity project (ProjectSettings/ProjectVersion.txt) with mcp__knowledge-retrieval__ and mcp__code-graph-unity__ / mcp__code-graph-unity-games__ tools present; a graph tool absent is graph: unavailable, never a negative |
corpus | doc_search with engine unity, 2-3 content words (at least one all-lowercase), assembly_prefix when known (for example DOTSEconomy); it dedupes vendored copies and names the canonical repo (duplicate_count, also_in); check doc_list_indexed_repos before trusting a miss, an indexed repo with 0 members is not a “no” |
libraryPass | none declared; search the studio libraries (TheOneFeature (TOF), TheOneRPG, unity-dots-library, gdk.core, UITemplate) first under grepRoots and in the corpus |
graph.servers | code-graph-unity (studio library), then code-graph-unity-games (games, demos); graph_stats first, then get_node, then get_neighbors; separate id spaces with no consumer-to-library join, do that by hand (references/dots-library.md) |
grepRoots | the working tree and Library/PackageCache, studio library packages first, then Assets/ |
sourceKinds | .cs, plus scenes, prefabs and ScriptableObject assets, which attach a type by serialized GUID with no import edge |
Caveats to apply to every graph number: references/graph-caveats.md.
Verdict gate
Section titled “Verdict gate”Before a NEW .cs under Assets/_Game/ or Assets/Scripts/, the turn carries the one-line verdict of the
neutral skill (Unity rule knowledge-sweep-unity.md; the core hook reuse-verdict-gate.cjs blocks the write
without it). One verdict word, then the dash: a REUSE|EXTEND|... alternation fails the gate regex, and NEW
stands for whatever the sweep found. A reuse-search: record also satisfies the gate:
reuse-search: not-found-after-corpus-and-grepreuse-search: CONTRIBUTE | symbol: <Type> | scope: <scope> | swept: <date>graph: <scope> · <N> nodes / <M> edges · built <date> · lower-boundgraph: unavailableVerdict outcomes: where the code lands
Section titled “Verdict outcomes: where the code lands”| Verdict | The code lands in |
|---|---|
CONTRIBUTE | The lib, not the game: t1k-lib-registry resolve --engine unity --category <c> picks the owner, /t1k:lib-contribute (skill t1k-lib-contribute, adapter t1k-unity-base-lib-packaging#contribute) opens the PR in the same task |
The game keeps only an adapter over the lib seam. Overlay the lib PR on the game and compile-gate it before
merging. Detail: docs/library-first-contribute-back.md. Never write “safe to change” or “unused” from a graph
result alone.