rlefko

Add a new MCP tool to the shared registry so the chat agent and external MCP clients can both call it.

Add a new FastAPI endpoint with router, schema, integration test scaffold, and a reminder to regenerate frontend types.

Add a shadcn/ui primitive correctly into the frontend.

Walk a new contributor (or a fresh dev environment) through getting My Family Tree running locally end-to-end.

Generate and hand-review a new Alembic migration after editing SQLModel tables.

Chess-correctness review for ChessBeast analysis changes. Use when a diff touches packages/core/src/classifier, packages/core/src/exploration, packages/core/src/storage, packages/pgn/src, packages/llm/src/explorer, packages/cli/src/orchestrator, or services/. Also use when the user says things like "chess correctness", "check the notation change", "review the classifier change", or "are these plies right". Reads docs/analysis-conventions.md as the source of truth.

Review annotation output quality against the annotation conventions. Use when a change touches packages/llm/src/narration, packages/llm/src/annotation, packages/llm/src/themes, or packages/pgn/src/transformer, when prompt text changes anywhere in the repo, or when reviewing a sample annotated PGN. Trigger phrasings include "review the narrator change", "check these prompt edits", "does this comment output look right", "review annotation quality", "check the density change", or "read this annotated game". Reads docs/annotation-conventions.md as the source of truth.

Performance review for ChessBeast pipeline changes. Use when a diff touches packages/core/src/exploration, packages/core/src/storage, packages/llm/src/narration/narrator.ts, packages/llm/src/client, packages/cli/src/orchestrator, packages/debug-gui/src/server, or a pool.py under services/. Also use when the user says things like "perf review this", "did we regress throughput", "is this loop too slow", "check the engine budget", "review LLM fan-out", or "is the GUI slowing the pipeline". Reads docs/performance-conventions.md as the source of truth.

Build and run rycraft with Metal validation, use deterministic diagnostics to locate features, capture real PNG frames, inspect cubic terrain, adaptive far LOD, mipmapped textures, culling, HDR effects, partial water, flora, and fauna, and report what the game actually shows. Use for player-visible changes, rendering reviews, world-generation acceptance, menus, fauna, fluids, culling, LOD, textures, or screenshot requests.

Review a rycraft diff against frame and tick budgets, sparse cubic active-set limits, adaptive far-terrain LOD and culling bounds, mipmapped texture cost, unified-memory limits, cache and solver bounds, queue backpressure, lock discipline, deterministic generation, fluid work and geometry, and fauna caps. Use before committing changes to rendering, simulation, world generation, cubic or far streaming, meshing, persistence, fluids, entities, caches, worker pools, or mutexes. Reads docs/performance-conventions.md as the source of truth.

Review a rycraft rendering diff for C++ and MSL layout parity, HDR pass compatibility, cubic and far-tile origins, 18-cube-edge halos, six-face seams, partial water, adaptive far LOD, mipmapped textures, frustum and conservative horizon culling, back-face winding, residency, unified-memory limits, and Metal validation evidence. Use before committing changes under src/render, include/render, shaders, mesh snapshots, fluid rendering, far terrain, textures, GPU-shared structs, or Metal call sites. Reads docs/rendering-conventions.md as the source of truth.

Review a diff or feature against Pixel Hoops' performance conventions (battery, CPU, tap-to-paint responsiveness). Use for the pre-commit performance agent check, when the user asks for a "perf review" / "performance check" / "battery check", when investigating jank, heat, drain, or unresponsive taps, or before committing changes that touch animations, audio, reducers, scrolling, lists, or the sim. Reads docs/performance-conventions.md as the source of truth.

Review a diff or feature against Pixel Hoops' feel conventions (the 8-bit presentation language; visual, audio, and haptic juice; celebration honesty; watch pacing; degradation semantics). Use for the pre-commit feel agent check, when the user asks for a "feel review" / "juice check" / "visual review" or whether something "lands" or "reads right", or before committing changes that touch screens, components, src/feel, src/components/fx, anything under src/audio or assets/audio (recipes, music tracks, the synth, baked WAVs), the audio baker (scripts/generate-sfx.ts), new sfx or haptics call sites, the theme, or the watch's presentation. Reads docs/feel-conventions.md as the source of truth.

Score a proposed Pixel Hoops gameplay feature against the addictive-gameplay blueprint. Use when the user asks whether a feature, mechanic, screen, or change "follows the blueprint", "is addictive / engaging / sticky", "earns its place", or wants a design review of a gameplay idea against the roguelike addiction principles. Reads docs/addictive-blueprint.md as the source of truth.

Review a diff or feature against Sleek Coach's AI conventions (provider factory boundary, model config, tool registry, safety policy coverage, the token/tool_start/tool_end/done/error streaming contract, session and history caps, required tests). Use for the pre-commit AI agent check, when the user asks for an "AI review" / "coach review" / "safety check" on the coach, or before committing changes that touch apps/api/app/coach_ai or the mobile coach streaming client (apps/mobile/src/services/api/coachService.ts, apps/mobile/src/services/hooks/useCoach.ts). Reads docs/AI_CONVENTIONS.md as the source of truth.

Review a diff or feature against Sleek Coach's design conventions (theme tokens, color and spacing scales, typography, component reuse, dark mode, accessibility). Use for the pre-commit design agent check, when the user asks for a "design review" / "UI review" / "token check" or whether a screen "matches the design system", or before committing changes that touch apps/mobile/src/components, apps/mobile/src/screens, apps/mobile/src/theme, or any .tsx UI surface. Reads docs/DESIGN_CONVENTIONS.md as the source of truth.