Bullish-Design

Use for practical command recipes when agents operate Allium CLI commands on a folder of .allium specs.

Use when running deeper semantic and process-level analysis on a folder of .allium specs after allium check has passed.

Use when validating a folder of .allium specs with allium check. Resolves the folder to an entrypoint file, runs validation, interprets diagnostics, and defines the repair loop.

Use when defining or applying CI-quality command gates for a folder of .allium specs. Assumes allium is already available.

Use as a concise reference for Allium CLI commands when working on a folder of .allium specs. Assumes the CLI is already available and entrypoint resolution is required.

Use when an Allium CLI command fails on a folder of .allium specs. Classifies diagnostics, performs minimal repairs, and reruns the correct command against the resolved entrypoint.

Use when extracting or inspecting the structured domain model from a folder of .allium specs using allium model.

Use when summarizing, comparing, or acting on Allium CLI output from commands run against a folder of .allium specs.

Use when writing a scripts/tasks/processes entry or a manager module. Covers which surface to use, guarding enterShell echoes, and the 0/1/2/3 exit contract.

Use when editing devenv.yaml or adding an input/import. Covers flake:false for modules, nixpkgs-python for version pins, and transitive inputs.

Use when you edited a modules/ file, devenv.nix, or env.* and nothing changed. Resolves the lock + eval-cache staleness loop.

Use when starting a server or any long-running / heavy task. Use processes + devenv up; don't block the shell; poll logs instead of piping out of view.

Use on ModuleNotFoundError or import failures inside the devenv shell, or after a fresh venv. The venv exists but deps may not be installed.

Use when about to run pytest, python, uv, ruff, or any build/tooling command in this repo. Enforces running through the devenv shell.

Use on "command not found", the shell won't enter, or eval errors. A symptom→cause→fix decision tree for devenv repos.

Route ALL version control through gitman (jj + colocated git). Never run raw jj/git.

An LLM-native language for sharpening intent alongside implementation. Velocity through clarity.

Generate tests from Allium specifications. Use when the user wants to propagate tests, generate test files from a spec, write tests for a specification, create property-based tests, produce state machine tests, check test coverage against spec obligations, or understand what tests a specification requires.

Use when writing or editing a Typer CLI in this repo — declaring commands, arguments vs options, the 0/1/2/3 exit-code contract via typer.Exit, no_args_is_help, and testing with CliRunner. Curated for typer 0.12.

Use when verifying code changes in this repository — running tests, lint, formatting, or type checks, or checking whether a change is correct. This repo verifies through Testee, not by invoking pytest/ruff/ty directly.

Author or edit the scripted tyo3.nvim demo recordings (vhs .tape → .gif/.txt/.cast). Use when creating a new demo scene, editing an existing tour/context tape, changing the demo project or nvim init, fixing a racey/broken recording, adding a new demo variant, or re-rendering the GIFs. Covers editors/tyo3.nvim/demo/ (setup.sh, default/, context/), determinism rules, the pristine-nvim resolution, and the devenv demo-record entrypoints.

Review a tyo3.nvim demo recording by reading its .txt transcript frame-by-frame. Use when verifying a re-rendered demo, checking a recording landed correctly, diagnosing a broken/racey/half-typed GIF, confirming a scene shows the right panel/virtual-text/diagnostic/quickfix content, or reviewing a demo change in a diff without opening the GIF. Covers the editors/tyo3.nvim/demo/*/*.txt frame format and what to look for per scene.

Locate and extract authoritative documentation from this repository's local context/vendor materials when they exist.

Template workflow for diagnosing LSP chat-delivery regressions when pyagent introduces an LSP/runtime pipeline.

Route ALL version control through gitman (jj + colocated git). Never run raw jj/git.

Start here for any work in this repo. Routes to the right manager and owns the lifecycle order (verify before save, scaffold before change).

Locate and extract authoritative documentation and source code for the vendored xgrammar and vLLM materials stored under the repository's .context/ directory.

Run a repeatable Remora LSP chat-delivery recovery loop: simplify the latest server/client logs, investigate pipeline failures, write a hypothesis report with recommended fix and rationale, implement a minimal fix, commit it, and hand off verification steps. Use when debugging chat-delivery regressions, lock-contention storms, missing HumanChatEvent/execute_turn stages, or similar LSP runtime reliability issues.

Start here for all Allium work. Routes to the right skill based on your task and tells you where specs live in this project.

Run a repeatable Remora LSP chat-delivery recovery loop: simplify the latest server/client logs, investigate pipeline failures, write a hypothesis report with recommended fix and rationale, implement a minimal fix, commit it, and hand off verification steps. Use when debugging chat-delivery regressions, lock-contention storms, missing HumanChatEvent/execute_turn stages, or similar LSP runtime reliability issues.