Instructions for mehdiforoozandeh/crux, a project described as: A scientific-method lab notebook your AI agent drives — research as a tree of questions and falsifiable hypotheses in plain markdown, with an LLM literature wiki and a browser GUI cockpit.
Launch and manage the crux cockpit — the read-only browser GUI over a crux research vault (crux serve). This skill runs it beginning to finish: locate the vault, start the server fresh on localhost, verify it actually serves, and hand the user one clickable URL — plus status / stop / restart, and a setup-or-demo path…
Write the Requirements Document for a crux node — the design detail that does not fit, and should not fit, inside a 400-word question or hypothesis. An RD is one immutable design document per node, living in rd/ beside the tree, linked from the node, outside the roll-up: the estimand and its bound, the probe ladder…
A literature wiki for a crux research vault — Andrej Karpathy's LLM-wiki pattern applied to a crux project. The PI curates immutable sources under raw/; you (the agent) compile them into a persistent, interlinked wiki/ of background, prior methods, SOTA, baselines, datasets, and definitions, and draw on it to ask…
An agentic research companion — a scientific-method lab notebook for a research program. Organize work as a tree of Questions (what we don't know) and falsifiable Hypotheses (testable leaves), each with pre-registered verifiables and findings; a deterministic engine derives verdicts, rolls them up, and trips a human…
Evolve crux itself — add a capability or fix a recurring flaw in the crux tool, end to end: ideate → build → validate → ship. Turns a feature idea or a "crux keeps doing X" annoyance into a signed-off PRD, a tests-first implementation, a hard validation gate (selftest green · stdlib-only · existing vaults still load ·…
Turn one crux anchor node and everything under it into a minimal, professional, self-contained HTML slide deck — the "here's what we found" update a research group gives — where every number on a slide is an address into the vault, not a photocopy of one, and crux deck --verify can prove it still matches. Drives the…