docs: harness-agnostic doc names + naming principle in wiki #172

Merged

clawdie merged 1 commit from docs-rename-neutral into main

2026-06-24 16:40:01 +02:00

clawdie commented

2026-06-24 16:33:46 +02:00

Owner

Harness-agnostic + plainer doc names, and codifies the naming rule so we stop repeating the pi_* mistake.

ZOT-RPC-TRANSCRIPT.md → AGENT-EVENTS-REFERENCE.md — neutral, per-harness event reference (currently documents zot; pi uses pi --mode json). Doesn't bake the current default harness into the filename. Adds a "Developer reference — operators can skip" header (plain version: wiki/agent-harness).
VAULT-PROVISION-FIRST-PROOF.md → VAULT-PROVISION-RUNBOOK.md — it's a runbook; "first-proof" was redundant.
wiki/naming-decisions.md — new "Naming principle — harness-agnostic by default" section: neutral concept → neutral name + configurable value (COLIBRI_AUTOSPAWN_BINARY=zot, overridable); harness-specific → harness in the name, kept symmetric (zot_event_type ↔ pi_event_type).
Referrers updated (spawner.rs, wiki/agent-harness.md, docs/README.md); US/ISO prose dates → DD.mon.YYYY per AGENTS.md (literal JSON "time" timestamps in the captured transcript left as data).

Gates: wiki-lint --strict clean, markdown format clean.

⚠️ Follow-up: the on-hold feature/wiki-expansion branch's wiki/vault-provision.md still references VAULT-PROVISION-FIRST-PROOF — it must be repointed to VAULT-PROVISION-RUNBOOK before that branch merges (else wiki-lint will flag a dangling ref).

🤖 Generated with Claude Code

Harness-agnostic + plainer doc names, and codifies the naming rule so we stop repeating the `pi_*` mistake. - **`ZOT-RPC-TRANSCRIPT.md` → `AGENT-EVENTS-REFERENCE.md`** — neutral, per-harness event reference (currently documents **zot**; pi uses `pi --mode json`). Doesn't bake the current default harness into the filename. Adds a *"Developer reference — operators can skip"* header (plain version: `wiki/agent-harness`). - **`VAULT-PROVISION-FIRST-PROOF.md` → `VAULT-PROVISION-RUNBOOK.md`** — it's a runbook; "first-proof" was redundant. - **`wiki/naming-decisions.md`** — new **"Naming principle — harness-agnostic by default"** section: neutral concept → neutral name + configurable value (`COLIBRI_AUTOSPAWN_BINARY=zot`, overridable); harness-specific → harness in the name, kept symmetric (`zot_event_type` ↔ `pi_event_type`). - Referrers updated (`spawner.rs`, `wiki/agent-harness.md`, `docs/README.md`); **US/ISO prose dates → `DD.mon.YYYY`** per AGENTS.md (literal JSON `"time"` timestamps in the captured transcript left as data). Gates: `wiki-lint --strict` clean, markdown format clean. ⚠️ **Follow-up:** the on-hold `feature/wiki-expansion` branch's `wiki/vault-provision.md` still references `VAULT-PROVISION-FIRST-PROOF` — it must be repointed to `VAULT-PROVISION-RUNBOOK` before that branch merges (else `wiki-lint` will flag a dangling ref). 🤖 Generated with [Claude Code](https://claude.com/claude-code)

clawdie added 1 commit 2026-06-24 16:33:48 +02:00

docs: harness-agnostic + plainer doc names; codify naming principle

CI / rust (pull_request) Has been cancelled

Details

CI / markdown (pull_request) Has been cancelled

Details

CI / port (pull_request) Has been cancelled

Details

CI / agent-jail-pkgs (pull_request) Has been cancelled

Details

064079e3fc

- ZOT-RPC-TRANSCRIPT.md → AGENT-EVENTS-REFERENCE.md: neutral, per-harness event
  reference (currently documents zot; pi uses pi --mode json). Avoids baking the
  current default harness into a name — same lesson as the pi_* renames. Adds a
  'Developer reference — operators can skip' header.
- VAULT-PROVISION-FIRST-PROOF.md → VAULT-PROVISION-RUNBOOK.md: it's a runbook;
  'first-proof' was redundant.
- Updated referrers: spawner.rs, wiki/agent-harness.md, docs/README.md.
- wiki/naming-decisions.md: new 'Naming principle — harness-agnostic by default'
  section (neutral concept → neutral name + configurable value; harness-specific
  → harness in the name, kept symmetric zot_/pi_).
- Fixed US/ISO prose dates → DD.mon.YYYY (21.jun.2026) per AGENTS.md; left the
  literal JSON "time" timestamps in the captured transcript as-is (data).

Gates: wiki-lint --strict clean; markdown format clean.