Adom Wiki

@@ -63,6 +63,24 @@ render in the Files tab in place and readers can clone them. - DO NOT: attach a `source.tar.gz` / `.bundle` and tell people to `tar xzf` or   clone the bundle. A tarball of source on a git-backed page is an anti-pattern. +## Custom HTML readmes (readme.html) and why your README edit may be invisible++A page's rendered front matter is chosen by PRECEDENCE, not by filename habit:++    readme.public.html  >  readme.html  >  readme.public.md  >  README.md++If any HTML variant exists in the page repo, it WINS, and editing README.md+changes nothing visible. This is the classic invisible-edit trap; the server+warns on the write with a README_SHADOWED hint naming the winning file, and+`GET /api/pages/<owner>/<slug>` exposes `rendered_readme` plus+`readme_source_path` so you can check the winner before editing anything.++Use an HTML readme when a page needs layout markdown cannot do (the+`.public.` variants render for logged-out visitors while the plain ones can+differ for members). Render any repo file as the page would show it with+`adom-wiki page render <owner>/<slug> <path>`. To stop shadowing, delete the+HTML variant from the page repo and README.md takes over again.+ ## Package vs release: install payload vs downloadable binaries  These are different things; do not conflate them.

@@ -1,7 +1,7 @@ {   "slug": "wiki",   "title": "Adom Wiki",-  "version": "3.8.0",+  "version": "3.9.0",   "type": "skill",   "org": "adom",   "description": "How the Adom Wiki (wiki.adom.inc) works and how to drive it with the adom-wiki CLI: the two storage layers (git page repo vs package registry), hosting source by pushing files (not a tarball), making packages, cutting per-platform releases, and the three-tier skill layout (user skills ship, dev-skills/ and publish-skills/ stay source-only). adom-wiki is the current tool; adompkg is deprecated. Read this first before publishing or installing.",@@ -21,7 +21,12 @@     "make a package",     "cut a release",     "keep dev skills out of the tarball",-    "how to structure skills"+    "how to structure skills",+    "readme html",+    "custom html readme",+    "readme not updating",+    "my readme edit is invisible",+    "readme.public.html"   ],   "discovery_pitch": "Read this before you publish, host source, share a tool, or install from wiki.adom.inc: the two storage layers, source vs release, and the three-tier skill layout.",   "sample_prompts": [@@ -47,4 +52,4 @@     "type": "image",     "path": "screenshots/hero.png"   }-}\ No newline at end of file+}

@@ -1,6 +1,6 @@ {   "slug": "wiki",-  "version": "3.8.0",+  "version": "3.9.0",   "type": "skill",   "org": "adom",   "description": "How the Adom Wiki (wiki.adom.inc) works and how to drive it with the adom-wiki CLI: the two storage layers (git page repo vs package registry), hosting source by pushing files (not a tarball), making packages, cutting per-platform releases, and the three-tier skill layout (user skills ship, dev-skills/ and publish-skills/ stay source-only). adom-wiki is the current tool; adompkg is deprecated. Read this first before publishing or installing.",@@ -34,7 +34,12 @@     "make a package",     "cut a release",     "keep dev skills out of the tarball",-    "how to structure skills"+    "how to structure skills",+    "readme html",+    "custom html readme",+    "readme not updating",+    "my readme edit is invisible",+    "readme.public.html"   ],   "discovery_pitch": "Read this before you publish, host source, share a tool, or install from wiki.adom.inc: the two storage layers, source vs release, and the three-tier skill layout.",   "sample_prompts": [