nourish: Skill for Claude Code

add-crate

Scaffold a new member crate into a Cargo workspace using y5-template (on PATH at ~/.cargo/bin/y5-template; source in environment/toolkit/y5-template/). Do NOT hand-create Cargo.toml/lib.rs by hand — use the tool so naming and the template stay correct.

ALWAYS run compositor.workspace/link.all.sh from the repo root after creating a crate (step 5) — the crate is not wired into the workspaces until you do.

The naming convention (chain-prefix)

A crate is created exactly two levels below a workspace root, and each level's directory name chains off its parent: {parent_tail}.{own_segment}.

compositor/                  workspace root  (Cargo.toml [workspace] members glob has ≥2 `*`)
  compositor.action/         L0   (root_tail "compositor" + "action")
    action.window/           L1 = the target directory
      window.{Name}/         L2 = what the tool CREATES

• root_tail = last dot-segment of the workspace dir name (compositor → compositor).
• A valid L0 is {root_tail}.{seg}, a valid L1 is {seg}.{sub}.
• The created dir is {L1_own_segment}.{Name} and must not already exist.

Steps

1. Find valid targets (the L1 dirs you can add into):

   y5-template --scan /workspace --list
   

   This prints every valid <workspace> › <L0> › <L1> with its absolute path.

2. Create the crate non-interactively. The picker needs a TTY, so use --dir (which skips the picker when the dir validates) and pipe the Name to stdin:

   printf 'NAME\n' | y5-template --dir /workspace/compositor/compositor.action/action.window
   

   • NAME becomes the crate suffix → creates window.NAME/.
   • Batch: printf 'a, b, c\n' | y5-template --dir <L1_DIR> creates window.a, window.b, window.c atomically (aborts if any already exists).
   • Extra template vars: if the chosen template declares vars beyond Name, they are prompted after Name — feed them as additional lines: printf 'NAME\nval1\nval2\n' | y5-template --dir <L1_DIR>. Check first with: y5-template --template <NAME> --help is not enough — inspect the template under <workspace>/y5.template/<tpl>/ for $${var}$$ placeholders.
   • --template <NAME> selects a non-default template (default is default).