commit ab5d4fae7d8cc8c4796443b32cbc1885e5aa529f
parent de7687df19eb897b22eb90fcc062bb8f6b31da41
Author: I Mean I'm Just Saying <imeanimjustsaying@kiwifarms.st>
Date: Wed, 30 Sep 2026 18:44:35 -0400
plans: release 16 slice DX — the ruling as amended: the setup lives on the homepage's AI and MCP doc alone; the sites' Use-with-AI page is removed and its links point there; the READMEs stay their own copies
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Diffstat:
1 file changed, 18 insertions(+), 10 deletions(-)
diff --git a/plans/release-16.md b/plans/release-16.md
@@ -42,18 +42,26 @@ slice's prompt carries its ruling, and this record carries what was built. Rules
`nop` either); a `qt=` link a visitor opens reads with the visitor's own row.
- The hub's search gets the row through the shared components; nothing hub-specific.
-## Slice DX — the ruling (2026-09-30)
+## Slice DX — the ruling (2026-09-30, amended by the operator the same evening)
-- A visitor who only wants to run Claude Code against a public instance is told, in one block,
- on the homepage's **AI and MCP** doc and on every site's **Use with AI** page: get the source
+- **The setup lives in ONE place: the homepage's AI and MCP doc** (`/docs/ai-and-mcp/`). It tells a
+ visitor who only wants to run Claude Code against a public instance, in one block: get the source
(the mirror clone or the tarball on `/downloads/`), `pnpm install`, register the MCP server **as
- `archilyzer`** against the instance, start `claude`, try `/ask`. Windows → WSL2, one line.
-- The server is registered as `archilyzer` in every example; the reason (the shipped `/ask` and
- `/sweep` call `mcp__archilyzer__…`) is one sentence beside it. `mcp/README.md`'s example changes
- to match.
-- The block is the same words in both places (one source of truth in `common/` if the two pages
- can share it; otherwise the same text, and the record says so).
-- Nothing else on those pages changes; no code path changes.
+ `archilyzer`** against the instance of their choice (`TRANSCRIPT_SITE_URL`; `TRANSCRIPT_HUB_URL` to
+ federate), start `claude`, try `/ask`. Windows → WSL2, one line. The optional editor lines for
+ `fetch_clip`, one sentence. The reason for the name (the shipped `/ask` and `/sweep` call
+ `mcp__archilyzer__…`) sits beside it. What that page already says about the published contract
+ (`/corpus.json`, `/llms.txt`), the MCP server and the honesty features stays.
+- **The sites' `/use-with-ai` page is removed** (export and hub). Its footer entry, its header entry
+ and the link on Ask AI point at the homepage doc instead (`PROJECT_URL` + `/docs/ai-and-mcp/`, same
+ tab), keeping the label **Use with AI**. Nothing a site said there is lost: the contract lines are on
+ the homepage doc, and a site's own `/llms.txt` still describes the site. Specs that used the page as
+ "another page" (`first-search`, `restore-no-refire`, `responsive`) use `/changelog/` instead.
+- **The READMEs are their own copies**: `README.md` §1/§4 and `mcp/README.md` say the same steps in
+ the same order and register `archilyzer`; the record notes that the homepage doc and the READMEs are
+ two places to change together (there is no shared source between markdown in `homepage/content` and
+ the repo's READMEs this release).
+- No code path other than the removed page and its links changes.
## Record
