Ybx-jp

track-open-work

File unfinished work as a GitHub issue instead of writing a Thread mid-session — the boundary a session may not cross, what belongs in the tracker versus the graph, and the register an issue body must be written in. Use when work is found that this session will not finish, when a defect is measured but out of scope, and before reaching for any graph write to record it.

author-repo-diagram

Authoring hand-written SVG diagrams that ship in a repo and render on GitHub — the contrast ceiling that decides whether an aid may paint its own surface, GitHub's two rendering facts, palette closure including the non-text 3:1 rule, and the render-and-look and desc-drift disciplines. Use BEFORE drawing or revising any SVG committed to the repo, when picking a diagram's colours at all, when a diagram must read in both light and dark, and before claiming a figure is accessible.

add-roster-expert

The end-to-end procedure for adding a Thalamus expert to the roster without breaking the tmux roster or the console's phone PWA. Use BEFORE creating any config/experts/ manifest or running `thalamus roster` with a new scope, when a roster/console surface misbehaves after a roster change (e.g. the PWA stuck at "connecting"), or before touching pin.py window mechanics or console server behavior.

consult-an-expert

How to run a consultation with a Thalamus roster expert so it produces both a good answer and a smarter expert — the operator-interview gate that precedes the first mint, round structure, demand-driven feeding, verifying what the expert tells you, and what to do when the operator overrules it. Use BEFORE minting a `consult_request` for any scope declared in `config/experts/`, when a first consultation comes back thin or generic, and when a consultation is substantial enough that one round will not settle it.

gremlin-python

The fine details agents get wrong when writing Gremlin against the Thalamus graph — terminal steps (lazy traversals that silently do nothing), the gremlin-lang vs gremlin-python dialect split, Python's renamed steps, and the house connection idiom. Use BEFORE writing any gremlin-python code (lab scripts, eval/substrate code, ad-hoc Bash python), when a traversal "ran" but returned nothing or a GraphTraversal repr, when memory_query rejects a dialect slip, or before writing a new ad-hoc query at all — proven ones live in RECIPES.md.

ground-in-literature

Consult the technical-literature expert before designing any new feature, component, schema change, or eval metric, and when writing or reviewing tests for one. Use BEFORE writing a design doc, starting implementation of a new component, or writing the word "novel"/"first"/"unique" anywhere. Recalls tier-2 literature claims from the Thalamus graph, closes coverage gaps via `thalamus ingest`, produces a cited "Prior work" paragraph for designs and a findings list for test critiques.

recall-strategy

How to retrieve from Thalamus memory without wasting context, and how to keep a query result from becoming a wrong conclusion — query shapes, the lexical-vs-traversal decision, tested memory_query recipes, and the falsify-before-you-commit checklist. Use BEFORE issuing a mid-session memory_recall, when a recall came back noisy or empty, when the question is relational (provenance, thread history, consultation audits, the eval loop's own verdicts), when you catch yourself re-recalling broader, and — binding — BEFORE any number from a traversal becomes a claim in a doc, a written finding, or a consult_answer.

Web & Frontend Listed

ship-a-browser-surface

How to take a change to one of this repo's browser surfaces — the console PWA, the graph viewer, pulse — from edit to believed-working, and how to verify an accessibility claim by measuring the rendered DOM rather than reading the stylesheet. Use BEFORE editing anything under src/thalamus/console/static/, src/thalamus/viewer/ or frontend/, BEFORE claiming a colour or target size conforms, when a change is correct on disk and wrong on the phone, and when adding a renderer that draws a session row.