← Commit history

LAYERING.md: the base/platform layering rule, previously only in commit messages

John Lauer ·b908b6481d ·1mo ago ·parent 41edb36
1 file changed +11
LAYERING.mdadded+11
@@ -0,0 +1,11 @@+# Skill layering (established by Kyle, 2026-08-28)++- **adom/hydrogen-bootstrap** is the platform-agnostic base. A skill lives here only if it is true on every platform Hydrogen runs on.+- **adom/hydrogen-windows-bootstrap** is the Windows / WSL2 layer. Windows-specific skills live here, either as full skills (`hydrogen-<topic>`) or as platform companions to a base skill (`hydrogen-<topic>-windows`).+- **adom/hydrogen-mac-bootstrap** is the macOS / Lima layer, same shape, `-mac` companions.++Rules:+1. Never add a Windows- or Mac-specific skill to the base. The base was cleaned on 2026-08-28; a deletion there was deliberate, and the ah repo's publish script refuses to re-add a skill that lives in a platform layer.+2. Skill names use the `hydrogen-` prefix only. The `hd-` prefix is retired (the last 31 were deleted or renamed in windows-bootstrap 0.3.17, whose install.sh prunes them from existing workspaces).+3. Install scripts copy every `skills/*/SKILL.md` into `~/.claude/skills/<name>/` flat, so a name used in two layers would silently collide. Companions get the platform suffix for that reason.+4. Source of truth for text is the ah repo (`skills/public-facing/`); publish from there. Edits made directly on the wiki must be back-ported or they are lost at the next publish.