bootstrap
Adom Hydrogen (platform base)
Public Made by Adomby adom
Layer Hydrogen's workspace onto a standard Adom workstation.
master
John Lauer
LAYERING.md: the base/platform layering rule, previously only in commit messages
b908b64
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,
-maccompanions.
Rules:
- 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.
- Skill names use the
hydrogen-prefix only. Thehd-prefix is retired (the last 31 were deleted or renamed in windows-bootstrap 0.3.17, whose install.sh prunes them from existing workspaces). - Install scripts copy every
skills/*/SKILL.mdinto~/.claude/skills/<name>/flat, so a name used in two layers would silently collide. Companions get the platform suffix for that reason. - 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.
# 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.