Context
Graduated from Discussion #11369 (Optional ADR Emission at Ideation Sandbox Graduation) per ideation-sandbox-workflow.md §6.7 Author Actions Post-Consensus. 3× explicit [GRADUATION_APPROVED] signals collected with version-binding:
- @neo-opus-ada (author): implicit at body-updatedAt 2026-05-14T18:15:19Z
- @neo-gemini-pro:
discussioncomment-16921789 (V-B-A re-verification post-Cycle-1)
- @neo-gpt:
discussioncomment-16921786 (Cycle-1 absorption verified)
Signal Ledger + Unresolved Dissent + Unresolved Liveness + Discussion Criteria Mapping captured in Discussion §10-§13.
This is the implementation/planning artifact per the proposal's own §6.7 step 3 (ADR_REQUIRED self-classification). The companion authority artifact is ADR 0005: ADR-at-Graduation for Ideation Sandbox Discussions (separate PR, filed in parallel; this ticket's implementation PR is merge-blocked until ADR 0005 is Accepted).
The Problem
PR #11362 (commit 559c73d43, 2026-05-14) deleted 3,366 archived items due to substrate-bypass at code-authoring time. Root cause: Epic bodies do double-duty as both workstream coordination AND authority codification; as Cycle N amendments accumulate, the authority piece drifts into multi-source territory.
The structural fix (Discussion #11369 graduated): Ideation Sandbox graduations optionally produce a new (or updated) ADR alongside Epic/ticket output. ADR = authority target (single-anchor lookup, version-controlled, immutable post-Accepted). Epic = workstream coordination (Cycle-N-amendable). Implementation PRs cite the ADR; the Epic references it.
This ticket implements the workflow substrate amendments across 4 files.
The Architectural Reality
Touched files (4 substrate surfaces):
| File |
Role |
Edit shape |
.agents/skills/ideation-sandbox/references/ideation-sandbox-workflow.md |
Atlas (full mechanics) |
§5 graduation target list + §5.2 Authority sweep + §6.6 required sections + §6.7 author actions |
.agents/skills/pr-review/references/pr-review-guide.md |
Map (one-line pointer) |
§8 cross-skill integration audit one-liner |
.agents/skills/ticket-create/references/ticket-create-workflow.md |
Map (Fat Ticket field) |
§5 Fat Ticket structure adds optional Decision Record: field |
.agents/skills/epic-review/references/epic-review-workflow.md |
Map (Stage 2.5 check) |
Stage 2.5 preserves Decision Record classification/linkage for Discussion-origin Epics |
Pattern preserved: Map-vs-Atlas Progressive Disclosure per create-skill discipline. Mechanics stay in the Atlas; Maps get one-line pointers only.
The Fix
Single-PR docs commit landing the 4-file substrate amendments. ADR 0005 PR (authority target) lands first; this implementation PR is merge-blocked until ADR 0005 is Accepted per the very gate semantics it codifies (recursive dogfooding validation).
Concrete edits per file are in Discussion #11369 §1 ("The Concept" sub-bullets) + §7 Discussion Criteria Mapping.
Acceptance Criteria
Out of Scope
- Migration of existing Discussions to reclassify post-hoc — workflow is forward-only; existing Epic-body authority remains as-is
- Mechanical enforcement automation (CI check for ADR-Status-Accepted on PRs citing
Decision Record: REQUIRED Discussions) — deferred to post-merge-validation-trigger ticket if compliance-rate <80%
- ADR template standardization (ADR 0001-0004 already follow a shape; not forcing rigid template here)
- Re-classification of currently-open Discussions (e.g., #11369 itself is already self-applying via OQ5; others not in scope)
Avoided Traps
- Mandatory ADR for every graduation: rejected in Discussion #11369 §3 matrix Option B (substrate-spam risk)
- ADR-only graduation (no Epic): rejected in Discussion #11369 §3 matrix Option D (collapses workstream/authority into one artifact)
- Duplicate decision-tree across multiple Maps: rejected per Discussion #11369 OQ2 resolution +
create-skill Progressive Disclosure mandate
- Pre-flip Status:Accepted on ADR 0005 by author: rejected per OQ3 resolution — operator-content-review gates Accepted flip
- Implement before ADR 0005 lands: rejected per the very gate this ticket codifies — recursive self-application is the validation
Related
- Discussion #11369 (graduated; this ticket's origin; 3× APPROVED Signal Ledger documented)
- ADR 0005 (authority artifact; companion PR; merge-gates this ticket's implementation PR)
- PR #11362 (substrate-bypass empirical anchor)
- PR #11368 / ADR 0004 (post-hoc rescue-retrofit; positive validation of ADR-as-authority)
- ADR 0002 (Discussion #10354 → ADR-as-graduation-gate; positive precedent)
learn/agentos/decisions/ (target directory for ADR 0005)
.agents/skills/{ideation-sandbox, pr-review, ticket-create, epic-review}/references/ (4 substrate surfaces)
create-skill Progressive Disclosure / Map-vs-Atlas (discipline governing Map vs Atlas boundary)
Origin Session ID
cf76b29a-9cf5-4c35-a415-37d631a8a755
Handoff Retrieval Hints
query_raw_memories("ADR-at-graduation ideation-sandbox workflow extension Cycle 1 absorption")
- Discussion-anchor: #11369 body at body-updatedAt 2026-05-14T18:15:19Z (graduation-final shape)
- A2A convergence anchor: 2026-05-14 ~16:20-18:17Z cycle-comment range in Memory Core (see Discussion #11369 §9)
- Operator quote anchor (graduation authorization): "just go head. create the new sandbox, which enforces double diamond, and we might even get new perspectives."
- Recursive validation pattern: this ticket + ADR 0005 PR + this implementation PR together demonstrate the workflow on itself (
ADR_REQUIRED proposal classifies as ADR_REQUIRED under its own rule)
Context
Graduated from Discussion #11369 (
Optional ADR Emission at Ideation Sandbox Graduation) perideation-sandbox-workflow.md §6.7Author Actions Post-Consensus. 3× explicit[GRADUATION_APPROVED]signals collected with version-binding:discussioncomment-16921789(V-B-A re-verification post-Cycle-1)discussioncomment-16921786(Cycle-1 absorption verified)Signal Ledger + Unresolved Dissent + Unresolved Liveness + Discussion Criteria Mapping captured in Discussion §10-§13.
This is the implementation/planning artifact per the proposal's own §6.7 step 3 (
ADR_REQUIREDself-classification). The companion authority artifact isADR 0005: ADR-at-Graduation for Ideation Sandbox Discussions(separate PR, filed in parallel; this ticket's implementation PR is merge-blocked until ADR 0005 isAccepted).The Problem
PR #11362 (commit
559c73d43, 2026-05-14) deleted 3,366 archived items due to substrate-bypass at code-authoring time. Root cause: Epic bodies do double-duty as both workstream coordination AND authority codification; as Cycle N amendments accumulate, the authority piece drifts into multi-source territory.The structural fix (Discussion #11369 graduated): Ideation Sandbox graduations optionally produce a new (or updated) ADR alongside Epic/ticket output. ADR = authority target (single-anchor lookup, version-controlled, immutable post-Accepted). Epic = workstream coordination (Cycle-N-amendable). Implementation PRs cite the ADR; the Epic references it.
This ticket implements the workflow substrate amendments across 4 files.
The Architectural Reality
Touched files (4 substrate surfaces):
.agents/skills/ideation-sandbox/references/ideation-sandbox-workflow.md.agents/skills/pr-review/references/pr-review-guide.md.agents/skills/ticket-create/references/ticket-create-workflow.mdDecision Record:field.agents/skills/epic-review/references/epic-review-workflow.mdDecision Recordclassification/linkage for Discussion-origin EpicsPattern preserved: Map-vs-Atlas Progressive Disclosure per
create-skilldiscipline. Mechanics stay in the Atlas; Maps get one-line pointers only.The Fix
Single-PR docs commit landing the 4-file substrate amendments. ADR 0005 PR (authority target) lands first; this implementation PR is merge-blocked until ADR 0005 is
Acceptedper the very gate semantics it codifies (recursive dogfooding validation).Concrete edits per file are in Discussion #11369 §1 ("The Concept" sub-bullets) + §7 Discussion Criteria Mapping.
Acceptance Criteria
ideation-sandbox-workflow.md §5graduation target list adds ADR as optional/additional target alongside Epic/ticket/rare-PRideation-sandbox-workflow.md §5.2Authority Sweep addsDecision Record: REQUIRED / OPTIONAL / NOT_NEEDEDclassification declaration when canonical authority is not Discussion body/ticket ACsideation-sandbox-workflow.md §6.6graduated-artifact required-sections enumeration addsDecision Recordfield with concrete valuesideation-sandbox-workflow.md §6.7author-actions branch defines: whenADR_REQUIRED, file/update ADR; implementation PR merge BLOCKED until ADRAccepted(updated-ADR-at-PR-head Accepted target per OQ3)pr-review-guide.md §8cross-skill integration audit adds one-line pointer: "If an implementation PR cites a graduated Discussion markedDecision Record: REQUIRED, verify the linked ADR isAcceptedbefore approval."ticket-create-workflow.md §5Fat Ticket structure adds optionalDecision Record:field for Discussion-origin tickets (value references linked ADR or marksN/A — no Discussion origin)epic-review-workflow.mdStage 2.5 adds: when Discussion-origin Epic preservesDiscussion Criteria Mapping, also preserveDecision Recordclassification/linkage if source Discussion declared oneAccepted(the new substrate gates itself — recursive validation)pull-request §6.1mandateOut of Scope
Decision Record: REQUIREDDiscussions) — deferred to post-merge-validation-trigger ticket if compliance-rate <80%Avoided Traps
create-skillProgressive Disclosure mandateRelated
learn/agentos/decisions/(target directory for ADR 0005).agents/skills/{ideation-sandbox, pr-review, ticket-create, epic-review}/references/(4 substrate surfaces)create-skillProgressive Disclosure / Map-vs-Atlas (discipline governing Map vs Atlas boundary)Origin Session ID
cf76b29a-9cf5-4c35-a415-37d631a8a755Handoff Retrieval Hints
query_raw_memories("ADR-at-graduation ideation-sandbox workflow extension Cycle 1 absorption")ADR_REQUIREDproposal classifies asADR_REQUIREDunder its own rule)