What problem does it solve? Contributors to this repository waste sessions on avoidable build and test mistakes: running cargo from the wrong directory, building release binaries when a debug check would do, misreading advisory check output as a passing gate, and hitting toolchain-floor failures on clean checkouts. This Skill carries the correct invocation, the Rust 1.91 toolchain floor, and the five most costly mistakes so an agent gets the engine built and its verbs run correctly the first time. ## Core Features & Use Cases - Canonical build invocation: Build the headwater-cli binary from the repository root with --manifest-path engine/Cargo.toml --locked, or from engine/ with neither flag, and choose between --release and the cheaper dev-release profile depending on whether a hook or commit gate needs the binary. - Verb execution with --root: Run every headwater verb with an explicit --root so the binary reads the intended corpus rather than defaulting to the current directory. - Test suite guidance: Name the right cargo test scope (workspace, single crate, or single test file), re-record fixtures via the documented environment variable, and rebase onto main before blessing recorded artifacts. - Use Case: An agent starting a session that must modify the engine uses this Skill to build with the dev-release profile, run the workspace test suite from engine/, and avoid a stale-main bless that would turn main red on landing. ## Quick Start Ask the agent to build the headwater CLI from the repository root and run headwater check with --root pointed at your corpus.
