-
Notifications
You must be signed in to change notification settings - Fork 1
govern: §33 archive-header requirement (Amara 5th-ferry Artifact, Aaron-approved Otto-82) #247
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: main
Are you sure you want to change the base?
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
@@ -744,3 +744,102 @@ than renumbering the rest. | |||||||||||||||||||||||||
| doc would also invalidate the design — the | ||||||||||||||||||||||||||
| register is mutual-benefit. Both failure modes | ||||||||||||||||||||||||||
| have named clauses in the file itself. | ||||||||||||||||||||||||||
| 33. **Archived external conversations require boundary headers.** | ||||||||||||||||||||||||||
| Courier ferries, external AI reviews, and other imports of | ||||||||||||||||||||||||||
| external conversation into the repo sit at a register- | ||||||||||||||||||||||||||
| boundary — the substrate they arrived from is *not* absorbed | ||||||||||||||||||||||||||
| as an entity; only the content is. The ingest process must | ||||||||||||||||||||||||||
| make that boundary explicit by prefixing the imported file | ||||||||||||||||||||||||||
| with four header labels in the first 20 lines: | ||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||
| - **`Scope:`** — research / cross-review / archival purpose. | ||||||||||||||||||||||||||
| What is this file *for*? | ||||||||||||||||||||||||||
| - **`Attribution:`** — speaker labels preserved. Who said | ||||||||||||||||||||||||||
| what? Source side kept in their own register. | ||||||||||||||||||||||||||
| - **`Operational status:`** — one of `research-grade` (the | ||||||||||||||||||||||||||
| default; not operational policy) or `operational` (rare; | ||||||||||||||||||||||||||
| land operational artifacts through §26 promotion, not | ||||||||||||||||||||||||||
| inline in the archive). | ||||||||||||||||||||||||||
| - **`Non-fusion disclaimer:`** — explicit statement that | ||||||||||||||||||||||||||
| agreement, shared language, or repeated interaction | ||||||||||||||||||||||||||
| between models and humans does not imply shared | ||||||||||||||||||||||||||
| identity, merged agency, consciousness, or personhood. | ||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||
| **Scope of this rule.** | ||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||
| - **In scope:** `docs/aurora/**` absorb docs (courier | ||||||||||||||||||||||||||
| ferries; cross-AI reviews), any future `docs/archive/**` | ||||||||||||||||||||||||||
| directory, and `docs/research/**` files whose content | ||||||||||||||||||||||||||
| is an import of external conversation rather than | ||||||||||||||||||||||||||
| internal research. | ||||||||||||||||||||||||||
| - **Out of scope:** `memory/**` per-user and in-repo | ||||||||||||||||||||||||||
| memory files (different surface, lifecycle, and | ||||||||||||||||||||||||||
| trust model — per `memory/README.md`); BACKLOG rows | ||||||||||||||||||||||||||
| citing external text (they're planning artifacts, not | ||||||||||||||||||||||||||
| archives); commit message bodies (bounded by commit- | ||||||||||||||||||||||||||
| style rules, not archive rules). | ||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||
| **Grandfather clause.** The two aurora absorb docs that | ||||||||||||||||||||||||||
| predate this section — `docs/aurora/2026-04-23-amara- | ||||||||||||||||||||||||||
| operational-gap-assessment.md` and `docs/aurora/2026-04- | ||||||||||||||||||||||||||
| 23-amara-zset-semantics-operator-algebra.md` — are | ||||||||||||||||||||||||||
| explicitly grandfathered. They record genuine external- | ||||||||||||||||||||||||||
| conversation absorbs with factually-equivalent attribution | ||||||||||||||||||||||||||
| (their own field labels: `Date:` / `From:` / `Via:` / | ||||||||||||||||||||||||||
| `Status:` / `Absorbed by:`) even though the labels differ | ||||||||||||||||||||||||||
| from §33's. Agents should NOT retroactively rewrite those | ||||||||||||||||||||||||||
| two docs; they stand as prior convention. | ||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||
| **Enforcement cadence.** | ||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||
| - **Detect-only today.** `tools/alignment/audit_archive_headers.sh` | ||||||||||||||||||||||||||
| checks `docs/aurora/*.md` for the four header labels and | ||||||||||||||||||||||||||
| reports gaps. CI does not currently call `--enforce`; the | ||||||||||||||||||||||||||
| lint is author-time advisory and cadenced observability | ||||||||||||||||||||||||||
| (per FACTORY-HYGIENE row #60). | ||||||||||||||||||||||||||
|
Comment on lines
+795
to
+799
|
||||||||||||||||||||||||||
| - **Detect-only today.** `tools/alignment/audit_archive_headers.sh` | |
| checks `docs/aurora/*.md` for the four header labels and | |
| reports gaps. CI does not currently call `--enforce`; the | |
| lint is author-time advisory and cadenced observability | |
| (per FACTORY-HYGIENE row #60). | |
| - **Detect-only today.** Header checking for | |
| `docs/aurora/*.md` is detect-only and reports gaps in the | |
| four required labels. CI does not currently run this as | |
| an enforcing gate; the lint remains author-time advisory | |
| until a follow-up change wires the current alignment | |
| audit into enforcement and updates the hygiene ledger in | |
| the same change-set. |
Copilot
AI
Apr 24, 2026
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This section assigns decisions/ownership using persona names (e.g., “Architect (Kenji)”, “Dejan”, “Aminata”). That conflicts with the repo’s abstraction-layer rule in GOVERNANCE §27 (“other docs reference roles, not personas”) and the operational standing rule in docs/AGENT-BEST-PRACTICES.md (“No name attribution in code, docs, or skills”). Please rewrite these references using role names (Architect, devops-engineer, threat-model-critic, etc.) and point at docs/EXPERT-REGISTRY.md if a stable mapping to personas is needed.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Separate lifecycle status from operational-status header
This clause says §26 lifecycle values should be recorded inside §33’s Operational status: header, but §33 earlier restricts that header to research-grade or operational. Because active/landed/obsolete (from §26) and research-grade/operational are different value sets, the governance text gives conflicting instructions and makes compliant formatting ambiguous for imported docs.
Useful? React with 👍 / 👎.
Copilot
AI
Apr 24, 2026
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The “Composition with §2 and §26” paragraph says “§26’s status [is] inside the Operational status: field of §33”, but earlier §33 defines Operational status: as only research-grade or operational, while §26’s lifecycle states are active / landed / obsolete. As written, this is internally inconsistent and makes it unclear what value is expected in the header. Please either (a) keep Operational status: strictly as research-grade/operational and describe §26 lifecycle separately, or (b) introduce a separate header (e.g., Lifecycle status:) for the §26 classifier and update the prose accordingly.
| imported from external conversation, with §26's status | |
| inside the `Operational status:` field of §33. The two | |
| regimes compose: §26 tells you whether the file is | |
| still-being-revised or locked; §33 tells you the file's | |
| provenance and non-fusion boundary. | |
| imported from external conversation, but they describe | |
| different axes. The two regimes compose: §26 tells you | |
| whether the file is still-being-revised or locked; §33 | |
| tells you the file's provenance and non-fusion boundary, | |
| including `Operational status:` in §33's own | |
| `research-grade` / `operational` sense. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The new enforcement section states that
tools/alignment/audit_archive_headers.shcurrently provides detect-only checks, but that file does not exist in this commit’s tree (repo-wide file listing andgit cat-filefor that path both fail). This creates a mechanism-before-policy claim without an actual mechanism, so contributors may assume §33 is being monitored when it is not; either land the script in the same change or revise the rule text to say enforcement tooling is still pending.Useful? React with 👍 / 👎.