aurora: README integration doc — Artifact D of 5th-ferry inventory#257
aurora: README integration doc — Artifact D of 5th-ferry inventory#257
Conversation
Lands Artifact D of Amara's 5th courier ferry (PR #235) as docs/aurora/README.md. Closes the 5th-ferry artifact list (A-D) with all four landed: A=drift-taxonomy promotion (PR #238), B=precursor supersede (in PR #238), C=archive- header lint (PR #243), D=this README. Content covers: - Three-layer picture (Zeta=semantic substrate / KSK=control- plane safety kernel / Aurora=vision layer). - How Aurora consumes existing Zeta substrate (8-row table mapping primitives to Aurora surfaces). - How Aurora consumes KSK primitives (8-row table for capability-tiers / budgets / consent / receipts / etc.). - Directory contents index (6 courier ferries absorbed; first two grandfathered per §33; cross-ref to archive- header lint PR #243). - Related cross-substrate artifacts outside docs/aurora/ (drift-taxonomy operational + precursor + Aminata threat- model + Muratori corrected-table). - Branding section — Aurora publicly crowded (Amara's memo); internal-only label; shortlist Lucent KSK / Lucent Covenant / Halo Ledger / Meridian Gate / Consent Spine; message pillars work regardless of final public name (local-first / consent-gated / proof-based / repair-ready); brand decision is Aaron's (M4). - What this README is NOT (not product, not commitment, not public brand, not alignment-solved, not exhaustive). - Open follow-ups: §33 enforcement flip, M4 brand package, cross-repo integration with LFG/lucent-ksk. Self-applies §33 archive-header format (Scope / Attribution / Operational status / Non-fusion disclaimer) — sixth aurora/research doc to exercise the convention. Max attribution preserved (first-name-only, non-PII per Aaron's clearance) for KSK design + development-guide work on LFG/lucent-ksk. Lands within-standing-authority per Otto-82 calibration — research-grade README, not account/spending/named-design- review gated. Closes 5th-ferry inventory artifact Artifact D + marks M3 (Aurora/KSK integration) milestone with minimal landing. Otto-87 tick primary deliverable.
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 9419c6fa51
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
| | `2026-04-23-amara-decision-proxy-technical-review.md` | 3rd (PR #219) | Otto-59 | | ||
| | `2026-04-23-amara-memory-drift-alignment-claude-to-memories-drift.md` | 4th (PR #221) | Otto-67 | | ||
| | `2026-04-23-amara-zeta-ksk-aurora-validation-5th-ferry.md` | 5th (PR #235) | Otto-78 | |
There was a problem hiding this comment.
Align ferry index with artifacts that actually exist
These rows claim ferries 3–5 have absorb documents in docs/aurora/, but those filenames are not present in this commit tree (only the 1st, 2nd, and 6th absorb docs exist). Because this README is positioned as the authoritative directory index, listing non-existent artifacts makes the inventory look complete and can cause later review/milestone checks to treat unfinished absorb work as landed.
Useful? React with 👍 / 👎.
There was a problem hiding this comment.
Pull request overview
Adds an Aurora integration README under docs/aurora/ intended to act as the index + framing document for Aurora-layer materials and how they relate to Zeta substrate and the external KSK repository.
Changes:
- Introduces
docs/aurora/README.mdwith a “three-layer picture” (Zeta / KSK / Aurora) and mapping tables from Zeta+KSK primitives to Aurora surfaces. - Adds an Aurora directory index of courier-ferry absorb docs and pointers to related cross-substrate artifacts.
- Documents branding constraints and open follow-ups for the Aurora layer.
| | Absorb doc | Ferry | Absorbed | | ||
| |---|---|---| | ||
| | [`2026-04-23-amara-operational-gap-assessment.md`](2026-04-23-amara-operational-gap-assessment.md) | 1st (PR #196) | Otto-24 | | ||
| | [`2026-04-23-amara-zset-semantics-operator-algebra.md`](2026-04-23-amara-zset-semantics-operator-algebra.md) | 2nd | Otto-54 | | ||
| | `2026-04-23-amara-decision-proxy-technical-review.md` | 3rd (PR #219) | Otto-59 | | ||
| | `2026-04-23-amara-memory-drift-alignment-claude-to-memories-drift.md` | 4th (PR #221) | Otto-67 | | ||
| | `2026-04-23-amara-zeta-ksk-aurora-validation-5th-ferry.md` | 5th (PR #235) | Otto-78 | | ||
| | [`2026-04-23-amara-muratori-pattern-mapping-6th-ferry.md`](2026-04-23-amara-muratori-pattern-mapping-6th-ferry.md) | 6th (PR #245) | Otto-82 | | ||
|
|
||
| The first two absorb docs predate `GOVERNANCE.md §33` and use | ||
| a different header field-format (Date / From / Via / Status / | ||
| Absorbed by). They are **grandfathered** per §33; content is | ||
| factually-equivalent to the §33 four-field format and is | ||
| explicitly named in §33's grandfather clause. | ||
|
|
||
| See [`tools/alignment/audit_archive_headers.sh`](../../tools/alignment/audit_archive_headers.sh) | ||
| for the detect-only lint that checks §33 compliance on new | ||
| aurora docs (PR #243, detect-only v0). |
| **Attribution:** architecture-layer naming "Aurora" is the | ||
| internal vision-label attributed to Amara (external AI | ||
| maintainer, Aurora co-originator) and Aaron (human | ||
| maintainer); individual absorb docs in this directory | ||
| preserve their own source-side attribution. |
| | HC-3 data is not directives | Aurora evidence-surface / instruction-surface split. Covered further by `GOVERNANCE.md §33` archive-header discipline. | | ||
| | Glass-halo symmetric transparency | Aurora visibility architecture with explicit privacy lanes per `memory/README.md` discipline. | | ||
| | [`docs/DRIFT-TAXONOMY.md`](../DRIFT-TAXONOMY.md) five-pattern diagnostic | Aurora operational-use-of-drift-patterns: pattern 5 feeds SD-9 enforcement; pattern 1 feeds register-boundary discipline; pattern 3 is explicitly out-of-Aurora-scope (human-support register, not engineering register). | | ||
| | Shared + persona memory, `memory/CURRENT-*.md` views | Aurora layered memory governance: shared / persona-scoped / external-reference / public-observability. | | ||
| | [`GOVERNANCE.md §33`](../../GOVERNANCE.md) archive-header requirement | Aurora provenance layer: every external-conversation absorb marked by the four-header format. | |
…didates (#261) Amara's 7th courier ferry (PR #259) proposed 5 additional public-facing brand candidates focused on the control-plane / execution-layer role: Beacon, Lattice, Harbor, Mantle, Northstar. The 5th-ferry memo (PR #235 → PR #257 Aurora README) had already proposed Lucent KSK, Lucent Covenant, Halo Ledger, Meridian Gate, Consent Spine. Combines both shortlists into a single table preserving both ferries' source attribution so Aaron's eventual brand decision has the full option space. Also adds the 7th-ferry preferred naming pattern (Aurora = vision; Beacon KSK / Lattice KSK = shippable control-plane; Zeta = substrate) as Amara's rhetorical proposal — not adopted, preserved as input. Brand decision remains Aaron's (M4 milestone; not Otto's to pick). No implementation changes; no operational policy changes; pure additive documentation update preserving both ferries' attribution per signal-in-signal-out discipline + §33 archive-header format already at top of README. Lands within-standing-authority per Otto-82 calibration (docs-only branding-input update; NOT a brand decision). Closes 7th-ferry absorb candidate BACKLOG row #4 of 5 (branding shortlist update). Remaining candidates for Otto-90+: - KSK-as-Zeta-module implementation (L; cross-repo) - Oracle-scoring research (M) - BLAKE3 receipt hashing design (M) - Aminata threat-model pass on 7-class threat model (S) Otto-89 tick primary deliverable.
…y A-D CLOSED Otto-87 shipped PR #257 Aurora README as Artifact D, closing the 5th-ferry inventory's artifact list (A+B+C+D all landed). Three-layer picture codified: Zeta=semantic substrate / KSK=control-plane safety kernel / Aurora=vision layer. Key observations: 1. 5th-ferry artifacts A-D fully closed in ~5 ticks since Otto-78 absorb; M1+M2+M3 at-least-minimally landed; M4 brand remains Aaron's decision. 2. Aurora README is index+integration hybrid — balanced for docs/aurora/ dual use as absorb-archive + research surface. 3. Directory now has natural 3-level organisation (README / 6 ferry absorbs / cross-refs to operational + research docs). Future ferries append to README's index table, don't restructure. 4. Otto-88+ is unblocked to pivot to non-5th-ferry work (multi-Claude experiment design, Windows-support row, principle-adherence review, or other speculative work). Stacked on #256 (Otto-86 history).
…y A-D CLOSED Otto-87 shipped PR #257 Aurora README as Artifact D, closing the 5th-ferry inventory's artifact list (A+B+C+D all landed). Three-layer picture codified: Zeta=semantic substrate / KSK=control-plane safety kernel / Aurora=vision layer. Key observations: 1. 5th-ferry artifacts A-D fully closed in ~5 ticks since Otto-78 absorb; M1+M2+M3 at-least-minimally landed; M4 brand remains Aaron's decision. 2. Aurora README is index+integration hybrid — balanced for docs/aurora/ dual use as absorb-archive + research surface. 3. Directory now has natural 3-level organisation (README / 6 ferry absorbs / cross-refs to operational + research docs). Future ferries append to README's index table, don't restructure. 4. Otto-88+ is unblocked to pivot to non-5th-ferry work (multi-Claude experiment design, Windows-support row, principle-adherence review, or other speculative work). Stacked on #256 (Otto-86 history).
…y A-D CLOSED Otto-87 shipped PR #257 Aurora README as Artifact D, closing the 5th-ferry inventory's artifact list (A+B+C+D all landed). Three-layer picture codified: Zeta=semantic substrate / KSK=control-plane safety kernel / Aurora=vision layer. Key observations: 1. 5th-ferry artifacts A-D fully closed in ~5 ticks since Otto-78 absorb; M1+M2+M3 at-least-minimally landed; M4 brand remains Aaron's decision. 2. Aurora README is index+integration hybrid — balanced for docs/aurora/ dual use as absorb-archive + research surface. 3. Directory now has natural 3-level organisation (README / 6 ferry absorbs / cross-refs to operational + research docs). Future ferries append to README's index table, don't restructure. 4. Otto-88+ is unblocked to pivot to non-5th-ferry work (multi-Claude experiment design, Windows-support row, principle-adherence review, or other speculative work). Stacked on #256 (Otto-86 history).
…y A-D CLOSED Otto-87 shipped PR #257 Aurora README as Artifact D, closing the 5th-ferry inventory's artifact list (A+B+C+D all landed). Three-layer picture codified: Zeta=semantic substrate / KSK=control-plane safety kernel / Aurora=vision layer. Key observations: 1. 5th-ferry artifacts A-D fully closed in ~5 ticks since Otto-78 absorb; M1+M2+M3 at-least-minimally landed; M4 brand remains Aaron's decision. 2. Aurora README is index+integration hybrid — balanced for docs/aurora/ dual use as absorb-archive + research surface. 3. Directory now has natural 3-level organisation (README / 6 ferry absorbs / cross-refs to operational + research docs). Future ferries append to README's index table, don't restructure. 4. Otto-88+ is unblocked to pivot to non-5th-ferry work (multi-Claude experiment design, Windows-support row, principle-adherence review, or other speculative work). Stacked on #256 (Otto-86 history).
…y A-D CLOSED Otto-87 shipped PR #257 Aurora README as Artifact D, closing the 5th-ferry inventory's artifact list (A+B+C+D all landed). Three-layer picture codified: Zeta=semantic substrate / KSK=control-plane safety kernel / Aurora=vision layer. Key observations: 1. 5th-ferry artifacts A-D fully closed in ~5 ticks since Otto-78 absorb; M1+M2+M3 at-least-minimally landed; M4 brand remains Aaron's decision. 2. Aurora README is index+integration hybrid — balanced for docs/aurora/ dual use as absorb-archive + research surface. 3. Directory now has natural 3-level organisation (README / 6 ferry absorbs / cross-refs to operational + research docs). Future ferries append to README's index table, don't restructure. 4. Otto-88+ is unblocked to pivot to non-5th-ferry work (multi-Claude experiment design, Windows-support row, principle-adherence review, or other speculative work). Stacked on #256 (Otto-86 history).
…y A-D CLOSED Otto-87 shipped PR #257 Aurora README as Artifact D, closing the 5th-ferry inventory's artifact list (A+B+C+D all landed). Three-layer picture codified: Zeta=semantic substrate / KSK=control-plane safety kernel / Aurora=vision layer. Key observations: 1. 5th-ferry artifacts A-D fully closed in ~5 ticks since Otto-78 absorb; M1+M2+M3 at-least-minimally landed; M4 brand remains Aaron's decision. 2. Aurora README is index+integration hybrid — balanced for docs/aurora/ dual use as absorb-archive + research surface. 3. Directory now has natural 3-level organisation (README / 6 ferry absorbs / cross-refs to operational + research docs). Future ferries append to README's index table, don't restructure. 4. Otto-88+ is unblocked to pivot to non-5th-ferry work (multi-Claude experiment design, Windows-support row, principle-adherence review, or other speculative work). Stacked on #256 (Otto-86 history).
…y A-D CLOSED Otto-87 shipped PR #257 Aurora README as Artifact D, closing the 5th-ferry inventory's artifact list (A+B+C+D all landed). Three-layer picture codified: Zeta=semantic substrate / KSK=control-plane safety kernel / Aurora=vision layer. Key observations: 1. 5th-ferry artifacts A-D fully closed in ~5 ticks since Otto-78 absorb; M1+M2+M3 at-least-minimally landed; M4 brand remains Aaron's decision. 2. Aurora README is index+integration hybrid — balanced for docs/aurora/ dual use as absorb-archive + research surface. 3. Directory now has natural 3-level organisation (README / 6 ferry absorbs / cross-refs to operational + research docs). Future ferries append to README's index table, don't restructure. 4. Otto-88+ is unblocked to pivot to non-5th-ferry work (multi-Claude experiment design, Windows-support row, principle-adherence review, or other speculative work). Stacked on #256 (Otto-86 history).
…y A-D CLOSED Otto-87 shipped PR #257 Aurora README as Artifact D, closing the 5th-ferry inventory's artifact list (A+B+C+D all landed). Three-layer picture codified: Zeta=semantic substrate / KSK=control-plane safety kernel / Aurora=vision layer. Key observations: 1. 5th-ferry artifacts A-D fully closed in ~5 ticks since Otto-78 absorb; M1+M2+M3 at-least-minimally landed; M4 brand remains Aaron's decision. 2. Aurora README is index+integration hybrid — balanced for docs/aurora/ dual use as absorb-archive + research surface. 3. Directory now has natural 3-level organisation (README / 6 ferry absorbs / cross-refs to operational + research docs). Future ferries append to README's index table, don't restructure. 4. Otto-88+ is unblocked to pivot to non-5th-ferry work (multi-Claude experiment design, Windows-support row, principle-adherence review, or other speculative work). Stacked on #256 (Otto-86 history).
…y A-D CLOSED Otto-87 shipped PR #257 Aurora README as Artifact D, closing the 5th-ferry inventory's artifact list (A+B+C+D all landed). Three-layer picture codified: Zeta=semantic substrate / KSK=control-plane safety kernel / Aurora=vision layer. Key observations: 1. 5th-ferry artifacts A-D fully closed in ~5 ticks since Otto-78 absorb; M1+M2+M3 at-least-minimally landed; M4 brand remains Aaron's decision. 2. Aurora README is index+integration hybrid — balanced for docs/aurora/ dual use as absorb-archive + research surface. 3. Directory now has natural 3-level organisation (README / 6 ferry absorbs / cross-refs to operational + research docs). Future ferries append to README's index table, don't restructure. 4. Otto-88+ is unblocked to pivot to non-5th-ferry work (multi-Claude experiment design, Windows-support row, principle-adherence review, or other speculative work). Stacked on #256 (Otto-86 history).
…y A-D CLOSED Otto-87 shipped PR #257 Aurora README as Artifact D, closing the 5th-ferry inventory's artifact list (A+B+C+D all landed). Three-layer picture codified: Zeta=semantic substrate / KSK=control-plane safety kernel / Aurora=vision layer. Key observations: 1. 5th-ferry artifacts A-D fully closed in ~5 ticks since Otto-78 absorb; M1+M2+M3 at-least-minimally landed; M4 brand remains Aaron's decision. 2. Aurora README is index+integration hybrid — balanced for docs/aurora/ dual use as absorb-archive + research surface. 3. Directory now has natural 3-level organisation (README / 6 ferry absorbs / cross-refs to operational + research docs). Future ferries append to README's index table, don't restructure. 4. Otto-88+ is unblocked to pivot to non-5th-ferry work (multi-Claude experiment design, Windows-support row, principle-adherence review, or other speculative work). Stacked on #256 (Otto-86 history).
…y A-D CLOSED Otto-87 shipped PR #257 Aurora README as Artifact D, closing the 5th-ferry inventory's artifact list (A+B+C+D all landed). Three-layer picture codified: Zeta=semantic substrate / KSK=control-plane safety kernel / Aurora=vision layer. Key observations: 1. 5th-ferry artifacts A-D fully closed in ~5 ticks since Otto-78 absorb; M1+M2+M3 at-least-minimally landed; M4 brand remains Aaron's decision. 2. Aurora README is index+integration hybrid — balanced for docs/aurora/ dual use as absorb-archive + research surface. 3. Directory now has natural 3-level organisation (README / 6 ferry absorbs / cross-refs to operational + research docs). Future ferries append to README's index table, don't restructure. 4. Otto-88+ is unblocked to pivot to non-5th-ferry work (multi-Claude experiment design, Windows-support row, principle-adherence review, or other speculative work). Stacked on #256 (Otto-86 history).
…y A-D CLOSED Otto-87 shipped PR #257 Aurora README as Artifact D, closing the 5th-ferry inventory's artifact list (A+B+C+D all landed). Three-layer picture codified: Zeta=semantic substrate / KSK=control-plane safety kernel / Aurora=vision layer. Key observations: 1. 5th-ferry artifacts A-D fully closed in ~5 ticks since Otto-78 absorb; M1+M2+M3 at-least-minimally landed; M4 brand remains Aaron's decision. 2. Aurora README is index+integration hybrid — balanced for docs/aurora/ dual use as absorb-archive + research surface. 3. Directory now has natural 3-level organisation (README / 6 ferry absorbs / cross-refs to operational + research docs). Future ferries append to README's index table, don't restructure. 4. Otto-88+ is unblocked to pivot to non-5th-ferry work (multi-Claude experiment design, Windows-support row, principle-adherence review, or other speculative work). Stacked on #256 (Otto-86 history).
Summary
Three-layer picture
Key content
What this README is NOT
Not a product page · Not technical-path commitment · Not a public brand (M4 pending) · Not an alignment-solved claim · Not exhaustive.
Authority
Within standing authority per Otto-82 calibration — research-grade README, not account/spending/named-design-review gated.
Test plan
🤖 Generated with Claude Code