dotfiles

Maintain the knowledge/ OKF bundle — the repo's authored knowledge layer (patterns, decision records, playbooks, component catalog). Use after adding or changing modules/packages/hosts, when making a non-obvious design decision worth recording, or when asked to "update the knowledge bundle", "add a decision record", "validate the bundle", or "regenerate the knowledge graph".

Extract an in-tree Nix package/derivation into its own flake-parts sub-flake (under flakes/<name>/) that the root flake consumes via a relative-path input — the stepping stone to later splitting it into a separate repo with a one-line URL swap. Use this skill whenever the user wants to modularize or split a Nix flake or reorganize packages: "turn this derivation into its own flake", "extract <pkg> into a sub-flake", "make <pkg> a standalone / in-repo flake", "split pkgs/<x> out", "prep <pkg> to move to its own repo", "modularize the flake", or is moving things from pkgs/ into flakes/. Covers the whole procedure end to end — scaffold, wire the root (relative-path input + follows), test (standalone build + parity + flake check), adversarial quality review, and documentation. Bundled bun/TypeScript scripts (inventory.ts, scaffold.ts, verify.ts) do the rote steps.

Update or fix the ccglass Nix derivation for a new upstream release. Clone the latest upstream tag, scan the source for bun-compile hazards, write/test the fork patch, then build and verify the flake's ccglass package (binary + MCP + dashboard) on aarch64-darwin. Use when bumping ccglass, regenerating its patch, or troubleshooting its build.