← Commit history

wiki pillars: repo, pkg, release, hero, issues, breadcrumbs

John Lauer ·6070d5005b ·3mo ago ·parent 66e51ca
1 file changed +12−8
README.md+12−8
@@ -38,14 +38,18 @@ Canonical glossary of Adom platform terms. Use these definitions consistently in | **Skill tiers** | `skills/` (user skills — ship in the install tarball), `dev-skills/` (build/debug — source repo only), `publish-skills/` (app→wiki publishing — source repo only). Only user skills reach installed containers. | | **Discovery metadata** | `discovery_triggers` / `discovery_pitch` / `sample_prompts` in a package manifest — how AIs find and auto-install a tool. Required for apps/skills. | -## The Wiki (two layers — not synced)--| Term | Definition |-|------|-----------|-| **Package layer** | The install payload (manifest + scripts + bundled user skills), published with `adom-wiki pkg publish`. What `pkg install` delivers. |-| **Page repo layer** | The page's git repo (Files tab, README, hero assets), pushed with `adom-wiki repo push`. Publishing a package does NOT sync the page repo, and vice versa — update both. |-| **Hero** | The 16:10 billboard image + headline/subhead on a wiki page — reused on the page header, homepage, installer, and screensaver. Required to publish apps/skills. |-| **Release** | Per-platform binaries attached to a package version (`adom-wiki release upload`) — the "Download for your machine" buttons. |+## The Wiki — pillars++Every wiki page is built from these pillars (each is a tab on the page and a verb family in aw):++| Pillar | Definition |+|--------|-----------|+| **repo** | The page's own git repo (Files tab) — README, source files, hero assets. Pushed with `aw repo push`; cloned with `aw repo clone`. Host SOURCE here (never tarballs). |+| **pkg** | The package registry pillar — the versioned install payload (manifest + scripts + bundled user skills). `pkg publish` / `pkg install` / `pkg update`; dependency trees make bootstraps possible. NOTE: publishing a pkg does NOT sync the repo pillar, and vice versa — update both. |+| **release** | Per-platform binaries attached to a version (`aw release upload`) — the "Download for your machine" buttons. How humans get CLIs without the registry. |+| **hero** | The 16:10 billboard — headline, subhead, screenshot — reused on the page header, homepage grid, HD installer, and screensaver. A page's face; required to publish apps/skills. Design rules: the adom-wiki-hero skill. |+| **issues** | Per-page issue tracker (`aw issue create` / Issues tab) — bugs, proposals, coordination. How work on someone else's page gets requested (e.g. adom/core#1). |+| **breadcrumbs** | Third-party "a path leads here" links: attach a small trail marker to SOMEONE ELSE's page announcing a related thing you built (a new bridge, an add-on) without editing their page — so it's discoverable from where people already look. |  ## CLI Tools