Files

T

ci/woodpecker/pr/ci Pipeline failed

Details

docs: ratify PRD rev1 — consolidated bundle, permanent shim, rev0 archived

Ratifies the Mosaic Stack PRD rev1 (Jason Woltje, 2026-09-01) as project
source of truth and installs the GOV.1 lifecycle model:

- docs/PRD.md becomes a permanent shim (kind: shim, current_rev ->
  docs/PRDs/2026-08-31_PRD_rev1/). Its path never changes again.
- docs/PRDs/2026-08-26_PRD_rev0/PRD.md archives the 2026-08-26 North Star
  verbatim (sha256 60cc2f98...36afdf unchanged). Archive, never delete.
- docs/PRDs/2026-08-31_PRD_rev1/ is the frozen rev1 bundle: 18 sectioned
  documents (VIS, DATA, AUTHN, AUTHZ, SEAT, ROLE, HARN, PROV, SESS, UI, CLI,
  GOV.1-5) consolidating rev0 D1-D15, the fleet north star, the agent-runtime
  L1/L2 contracts and the control-plane-surfaces lane findings, with a single
  decision map (GOV.3) and a closed open-questions frontier (GOV.5, grill
  rounds 1-8). Drafting inputs (_source-* snapshots) are not shipped.

Consequences of the ratified rulings carried in the same change:

- Q-T1 (ruling B, "shipped but frozen"): D3 amended in GOV.3/VIS.1;
  federation M1-M3 acknowledged as shipped behind tier === 'federated',
  excluded from the v1 bar and frozen, with a security re-audit gate before
  any resumption. docs/MISSION-MANIFEST.md, docs/federation/MISSION-MANIFEST.md
  and docs/scratchpads/mvp-20260312.md get status: superseded + banners
  (content preserved verbatim); docs/guides/deployment.md gains a
  "Relationship to the PRD (D15)" section. NORTH_STAR.yaml adds dormant
  workstream M (projects no goals by design); NORTH_STAR.md regenerated.
- Q-G2 (distinct registry prefixes): every citation of the operator
  DECISION-REGISTER in the bundle reads OD-nn; the stack registry stays
  D1-D15; L1-Dnn/L2-Dnn untouched. Prefix rule recorded in GOV.1.

Follow-ups (not in this PR): CI parity drift-gate witness (Q-C1); brain-side
DECISION-REGISTER rename to OD- with redirect table on its next touch.

2026-09-01 18:32:14 -05:00

4.5 KiB

Raw Blame History

id, status, ratified

id	status	ratified
PRD.0	ratified	2026-09-01 (Jason Woltje; PRD rev1 ratification PR)

PRD.0 — Index: naming standard, domain registry, reading order

This file is the order authority for the PRD section documents. Lexical sort of the directory is not authoritative; this index is.

Naming standard (ratified 2026-08-31)

<DOMAIN>.<n[.n[.n]]>-<kebab-slug>.md — e.g. AUTHN.1.1-oidc.md

Domain code: short uppercase code from the registry below. Codes are append-only; a code is never reused or renamed.
Number: hierarchical, dotted, append-only at every level. A new subtopic under AUTHN.1 takes the next free number (AUTHN.1.3). Nothing ever renumbers; depth absorbs insertions. Added topics augment, never reshuffle.
Slug: kebab-case; names only what the number does not. The domain word is never repeated in the slug (AUTHN.1.1-oidc.md, not AUTHN.1.1-authentication-oidc.md).
Separators: dots between number levels only; one hyphen between number and slug; hyphens inside the slug. No underscores, no spaces.
ID in three places that must agree: filename, frontmatter id:, H1. Wikilinks use the basename, e.g. [[AUTHN.1.1-oidc]] (illustrative — no such section exists yet).
Flat directory: hierarchy lives in the number, not nested folders.

Domain registry (append-only)

Code	Domain
PRD	The PRD assembly itself: index, preamble, revision log
GOV	Governance: document lifecycle, decision registers, amendment process, ratification
VIS	Vision / north star: what the Stack is, premises, non-goals
AUTHZ	Authorization & enforcement: capabilities, role policy, mosaic-core, L2 contracts, gap register
AUTHN	Authentication: provider accounts, OAuth/API keys, renewal, deactivation, allowed harnesses
ROLE	Roles: manifests, role config surfaces, role/seat separation
SEAT	Seats: profiles, launch config, seat config surfaces, profile.json consolidation
HARN	Harnesses: install/enable, model availability, reasoning, linked auth
PROV	Providers: supported providers, local providers (Ollama, LM Studio), provider config
SESS	Sessions: Stack session identity, continuity, mid-stream harness/model/provider switching
UI	WebUI: pages, page-scope rules, interaction patterns, audit surfaces
CLI	mosaic CLI: command surface, CLI↔WebUI parity
DATA	Record classes & storage: J1 git/DB authority split, flat-file vs DB, reconciliation

New domains append below this line with a dated note.

Reading order

Order is by lifecycle of understanding, not by code:

PRD.0-index (this file)
GOV.1-prd-lifecycle
GOV.2-docs-inventory
GOV.3-decision-map
VIS.1-north-star
DATA.1-record-authority
AUTHZ.1-capability-authority
ROLE.1-role-governance → SEAT.1-seat-profile (separation is load-bearing; role before seat)
HARN.1-harness-config → PROV.1-providers → AUTHN.1-auth-accounts
SESS.1-session-continuity
UI.1-webui-surfaces → CLI.1-parity (surfaces last; they project everything above)
GOV.4-workstream-contracts (preserved contracts; bind after the model is understood)
GOV.5-open-questions (the grill list; ratification gate)

Pulled sources (inputs, never ratified): rev0 PRD, the operator DECISION-REGISTER (estate brain docs/guides/proposed/DECISION-REGISTER.md, snapshot 2026-08-28, sha256 2cc81be1…aabec; operator-only corpus, not shipped).

Sections are added to this list as they are authored; an unlisted file is a defect.

Structural rulings (2026-08-31, Jason)

The finished PRD is the project SOT. docs/PRD.md in the stack repo becomes a shim to the current dated revision. Missions reference the PRD, never usurp it. See GOV.1-prd-lifecycle.
The entire PRD lives in the stack repo (mosaicstack/stack, trunk next). Brain documents are operator-instance documents that cite it.
This work is the successor to the 2026-08-26 "North Star" PRD on origin/next (snapshot: rev0 PRD).
Revisions archive, never delete. Each ratified revision is a frozen bundle directory — docs/PRDs/YYYY-MM-DD_PRD_revN/ holding the PRD, this index, and every section doc as a set (layout: GOV.1-prd-lifecycle §Revision bundles).
Shim and revision immutability are convention, not enforcement (no hook or CI guard yet).

4.5 KiB Raw Blame History