qol-project

Use when adding any new piece of host <-> plugin communication in qol-tools (a new event, new request, new capability bit). Picks the right channel and stops re-deriving infra that already lives in qol-runtime.

Use when authoring or modifying CI / release workflows (`.github/workflows/*.yml`) or `Cargo.toml` files in the qol-monorepo. Encodes the cross-platform infrastructure contract that prevents the "compiles on CI today, breaks on release tomorrow" class of failure: platform matrices derived from `plugin.toml` `platforms`, warning parity between CI and release builds, conditional dependencies expressed as `[target.'cfg(target_os = ...)'.dependencies]` rather than as cfg gates in source. Triggers on edits to workflow YAML, on changes to `Cargo.toml` `[dependencies]` / `[target...]` sections, on the words "release pipeline", "plugin CI", "matrix build", "RUSTFLAGS". For the code patterns the matrix exists to catch, see `qol-arch-code` and `qol-arch-cross-platform`.

Use when designing or refactoring Rust plugins/libs that need cross-platform support, capability-specific backend splits, or headless-first CLI/plugin contracts. Defines strategy-pattern compartmentalization (platform/ subfolders, trait + per-OS impls), capability-local backend boundaries for display/windowing, service managers, hardware/protocol adapters, and rendering/capture paths, headless binary layering, mandatory help/doctor commands, and plugin doctor output contracts. Triggers on platform-specific code, multi-OS support, plugin platform modules, OS-named files, Linux X11/Wayland/compositor splits, DBus/systemd/protocol backend splits, headless CLI design, plugin runtime action design, doctor commands, or any time you see

Use when adding or refactoring symbols (functions, types, constants, use statements) that *might* be consumed by only one platform's backend, even when the symbol itself looks platform-neutral. Prevents the most common qol-tools cross-platform regression: code that compiles green on Linux but emits dead_code / unused_imports / unused_mut errors on macOS or Windows under `-D warnings`. Triggers on edits to shared modules that border `platform/` directories, on `#[allow(dead_code)]` / `#[allow(unused_mut)]` reaches, on `#[cfg(target_os)]` attributes attached to `use` statements, and any time you find yourself "quieting a lint" on one OS. For the strategy-pattern code layout that this skill builds on, see `qol-arch-code`. For CI-side enforcement that catches the failures across all three OSes, see `qol-arch-cicd`.

Use when authoring or modifying CI, versioning, or release workflows in the qol-monorepo (.github/workflows/*.yml, .github/scripts/*), or when a release or version bump does not behave as expected.

5 hooks across 3 events