Skip to content

agents: Edit 1 — external-conversation absorbs land research-grade, not operational (Amara 5th-ferry) #248

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.

Sign up for GitHub

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

Merged
AceHack merged 1 commit into from
Apr 24, 2026
+23 −0
Merged

agents: Edit 1 — external-conversation absorbs land research-grade, not operational (Amara 5th-ferry) #248

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 23 additions & 0 deletions AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -198,6 +198,29 @@ These apply to any AI harness.
workflow at `docs/DECISIONS/YYYY-MM-DD-*.md`
rather than burying the rationale in a commit
message.
- When an agent ingests an external conversation —
courier ferry, cross-AI review, ChatGPT paste,
other-harness transcript — the absorb lands
research-grade, not operational. Concretely:
the absorb doc carries `GOVERNANCE.md §33`
Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot Apr 24, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Replace reference to nonexistent GOVERNANCE §33

This new rule makes GOVERNANCE.md §33 the authority for required absorb headers, but in this commit GOVERNANCE.md only has numbered rules through §32. Contributors following this instruction cannot find the schema, so the policy is not actually enforceable and different agents can emit incompatible archive metadata. Please either add §33 in the same change or point this bullet at an existing section.

Useful? React with 👍 / 👎.

archive headers including
Comment on lines +205 to +206
Copy link

Copilot AI Apr 24, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1: This references GOVERNANCE.md §33, but GOVERNANCE.md in this branch only defines rules up through §32 and contains no §33 (nor any archive-header rule). Either update the citation to the correct existing rule/document, or land the referenced §33 rule before pointing AGENTS.md at it.

Suggested change
the absorb doc carries `GOVERNANCE.md §33`
archive headers including
the absorb doc carries archive headers including

Copilot uses AI. Check for mistakes.
`Operational status: research-grade`, and its
content does not become factory policy until a
separate promotion step lands a current-state
artifact (an operational doc edited in place per
§2, an ADR under `docs/DECISIONS/`, a
`GOVERNANCE.md §N` numbered rule, or a
`docs/AGENT-BEST-PRACTICES.md` BP-NN promotion).
§26's research-doc lifecycle classifier
(active / landed / obsolete) applies to the
promoted current-state artifact, not to the
absorb itself. Worked example: the drift-taxonomy
promotion from
`docs/research/drift-taxonomy-bootstrap-precursor-2026-04-22.md`
(research-grade absorb) to
`docs/DRIFT-TAXONOMY.md` (operational one-page
field guide) — the absorb stayed in-place as
provenance; the promotion is the ratification.
Comment on lines +217 to +223
Copy link

Copilot AI Apr 24, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1: docs/DRIFT-TAXONOMY.md does not exist in the current tree (only references to it). If the worked example is meant to point at a promoted operational doc, the path needs to be updated to the actual file, or the example should reference an artifact that exists on this branch.

Suggested change
absorb itself. Worked example: the drift-taxonomy
promotion from
`docs/research/drift-taxonomy-bootstrap-precursor-2026-04-22.md`
(research-grade absorb) to
`docs/DRIFT-TAXONOMY.md` (operational one-page
field guide) — the absorb stayed in-place as
provenance; the promotion is the ratification.
absorb itself. Worked example: a drift-taxonomy
absorb such as
`docs/research/drift-taxonomy-bootstrap-precursor-2026-04-22.md`
stays in place as provenance, while the
ratified current-state promotion lands in an
operational artifact that exists in the live doc
set, such as an ADR under `docs/DECISIONS/` or
a BP-NN entry in
`docs/AGENT-BEST-PRACTICES.md`.

Copilot uses AI. Check for mistakes.
Copy link

Copilot AI Apr 24, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The PR description says this edit avoids introducing parallel “staged/ratified” terminology, but this line introduces “ratification” anyway. Consider keeping the vocabulary consistent (e.g., stick to “promotion” / “operational”) to avoid reintroducing the term you’re trying to avoid.

Copilot uses AI. Check for mistakes.

## Build and test gate

Expand Down
Loading