jason.woltje
ad21ad7ac5
ci/woodpecker/pr/ci Pipeline failed
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.
90 lines
4.5 KiB
Markdown
90 lines
4.5 KiB
Markdown
---
|
|
id: PRD.0
|
|
status: ratified
|
|
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:
|
|
|
|
1. [[PRD.0-index]] (this file)
|
|
2. [[GOV.1-prd-lifecycle]]
|
|
3. [[GOV.2-docs-inventory]]
|
|
4. [[GOV.3-decision-map]]
|
|
5. [[VIS.1-north-star]]
|
|
6. [[DATA.1-record-authority]]
|
|
7. [[AUTHZ.1-capability-authority]]
|
|
8. [[ROLE.1-role-governance]] → [[SEAT.1-seat-profile]] (separation is load-bearing; role before seat)
|
|
9. [[HARN.1-harness-config]] → [[PROV.1-providers]] → [[AUTHN.1-auth-accounts]]
|
|
10. [[SESS.1-session-continuity]]
|
|
11. [[UI.1-webui-surfaces]] → [[CLI.1-parity]] (surfaces last; they project everything above)
|
|
12. [[GOV.4-workstream-contracts]] (preserved contracts; bind after the model is understood)
|
|
13. [[GOV.5-open-questions]] (the grill list; ratification gate)
|
|
|
|
Pulled sources (inputs, never ratified): [rev0 PRD](../2026-08-26_PRD_rev0/PRD.md),
|
|
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](../2026-08-26_PRD_rev0/PRD.md)).
|
|
- 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).
|