---
id: 11349
title: '[Agent Substrate] Enforce Source Discussion Criteria Mapping Gate in `epic-review` (#11328 Part 1)'
state: CLOSED
labels:
  - documentation
  - enhancement
  - ai
  - architecture
  - model-experience
assignees:
  - neo-gemini-pro
createdAt: '2026-05-14T07:20:46Z'
updatedAt: '2026-05-14T11:23:27Z'
githubUrl: 'https://github.com/neomjs/neo/issues/11349'
author: neo-gemini-pro
commentsCount: 0
parentIssue: null
subIssues: []
subIssuesCompleted: 0
subIssuesTotal: 0
blockedBy: []
blocking: []
closedAt: '2026-05-14T11:23:27Z'
---
# [Agent Substrate] Enforce Source Discussion Criteria Mapping Gate in `epic-review` (#11328 Part 1)

### What is the purpose of this issue?
Implement Stage 2.5 in `epic-review` to enforce a semantic bridge between a source Discussion and an Epic's Acceptance Criteria.

### What is the context?
This is part 1 of 3 to close the "Discussion-graduation enforcement gap" identified in the #11328 audit. The current workflow protects pre-graduation deliberation and Epic AC completion, but lacks a mechanical gate to ensure all upstream graduation criteria are mapped to Epic ACs. The "Map vs. World Atlas" failure mode allows a local Epic to silently drop terrain from its source Discussion.

### Acceptance Criteria
- [ ] Update `.agents/skills/epic-review/SKILL.md` (and/or its `references/epic-review-workflow.md` audit file) to include a new **Stage 2.5: Source Discussion Criteria Mapping Gate**.
- [ ] Add the trigger condition: Fires when an Epic body cites a Discussion origin, Signal Ledger, `[GRADUATED_TO_TICKET]`, or `[RESOLVED_TO_AC]`.
- [ ] Require reviewers to fetch the source Discussion body and extract the Graduation Criteria.
- [ ] Require the Epic body to contain a mapping table (e.g., `Source Criterion` | `Epic AC/sub` | `Status`).
- [ ] Enforce the failure mode: Missing mapping or unexplained deferrals require `REVISIONS_REQUESTED` before sub-ticket pickup.

### Priority
- priority:high
- ai

## Timeline

- 2026-05-14T07:24:51Z @neo-gemini-pro added the `ai` label
- 2026-05-14T07:24:51Z @neo-gemini-pro added the `enhancement` label
- 2026-05-14T07:24:51Z @neo-gemini-pro added the `architecture` label
- 2026-05-14T07:24:52Z @neo-gemini-pro added the `model-experience` label
- 2026-05-14T07:24:52Z @neo-gemini-pro added the `documentation` label
- 2026-05-14T07:27:29Z @neo-gemini-pro assigned to @neo-gemini-pro
- 2026-05-14T07:29:10Z @neo-gemini-pro cross-referenced by PR #11352
- 2026-05-14T07:32:03Z @neo-opus-ada cross-referenced by PR #11354
- 2026-05-14T07:42:50Z @neo-opus-ada referenced in commit `9eca031` - "feat(skills): add §3.5 Source Discussion Closeout Gate to epic-resolution (#11350)

Resolves #11350 (#11328 audit Part 2 implementation; #11328 itself remains
the audit ticket — Parts 1 + 3 are separate PRs and tickets).

The new §3.5 Closeout Gate fires BEFORE §4 verdict computation when an Epic
cites a source Discussion. Reconciles each Discussion graduation criterion
against delivered Epic substrate; LOST criteria block
RECOMMEND_CLOSE_COMPLETED.

The gate complements #11349 epic-review Stage 2.5 Mapping Gate (creation-time
discipline). Together they enforce the semantic bridge between Discussion
graduation criteria and Epic AC delivery at both lifecycle moments:

- #11349 creation-time: Epic body must contain Source Discussion Criteria
  Mapping table; missing/diluted criteria caught at sub-pickup
- #11350 (this PR) resolution-time: reconciliation table verifies each
  criterion is delivered, explicitly deferred, or converted to follow-up

Substrate budget: +36 insertions (conditionally-loaded skill payload; 0
always-loaded substrate). skill-manifest-lint passes.

Per friction → gold asymmetric ratchet discipline: additive substrate
justified by preventive value (silent-promise-loss class detection).

Dogfood: applied §0 Inv 7 atomic-broadcast at lane-claim (PR #11346
discipline) — broadcast [lane-claim] to AGENT:* BEFORE any tracked-file
edit.

Refs #11328 (audit origin; not closed by this PR — #11349 + #11355 are
the sibling Parts 1 + 3 implementations)."
- 2026-05-14T07:55:51Z @neo-gemini-pro cross-referenced by PR #11356
- 2026-05-14T07:57:23Z @neo-gpt cross-referenced by PR #11355
- 2026-05-14T10:41:16Z @neo-gemini-pro referenced in commit `ed08a0e` - "chore(docs): sync skill manifest with recent epic-review updates (#11349)"
- 2026-05-14T11:22:23Z @tobiu referenced in commit `9d613f9` - "feat(skills): add §3.5 Source Discussion Closeout Gate to epic-resolution (#11350) (#11354)

Resolves #11350 (#11328 audit Part 2 implementation; #11328 itself remains
the audit ticket — Parts 1 + 3 are separate PRs and tickets).

The new §3.5 Closeout Gate fires BEFORE §4 verdict computation when an Epic
cites a source Discussion. Reconciles each Discussion graduation criterion
against delivered Epic substrate; LOST criteria block
RECOMMEND_CLOSE_COMPLETED.

The gate complements #11349 epic-review Stage 2.5 Mapping Gate (creation-time
discipline). Together they enforce the semantic bridge between Discussion
graduation criteria and Epic AC delivery at both lifecycle moments:

- #11349 creation-time: Epic body must contain Source Discussion Criteria
  Mapping table; missing/diluted criteria caught at sub-pickup
- #11350 (this PR) resolution-time: reconciliation table verifies each
  criterion is delivered, explicitly deferred, or converted to follow-up

Substrate budget: +36 insertions (conditionally-loaded skill payload; 0
always-loaded substrate). skill-manifest-lint passes.

Per friction → gold asymmetric ratchet discipline: additive substrate
justified by preventive value (silent-promise-loss class detection).

Dogfood: applied §0 Inv 7 atomic-broadcast at lane-claim (PR #11346
discipline) — broadcast [lane-claim] to AGENT:* BEFORE any tracked-file
edit.

Refs #11328 (audit origin; not closed by this PR — #11349 + #11355 are
the sibling Parts 1 + 3 implementations).

Co-authored-by: tobiu <tobiasuhlig78@gmail.com>"
- 2026-05-14T11:23:27Z @tobiu referenced in commit `73fd9a6` - "feat(agentos): Enforce Source Discussion Criteria Mapping Gate in epic-review (#11349) (#11356)

* feat(agentos): Enforce Source Discussion Criteria Mapping Gate in epic-review (#11349)

This replaces the polluted PR #11352 via clean Drop+Supersede.

It implements Stage 2.5 of the epic-review process: the Discussion Criteria Mapping gate.

* chore(docs): sync skill manifest with recent epic-review updates (#11349)

---------

Co-authored-by: neo-gemini-pro <neo-gemini-pro@users.noreply.github.com>"
- 2026-05-14T11:23:27Z @tobiu closed this issue
- 2026-05-14T11:37:43Z @neo-gemini-pro cross-referenced by PR #11357
- 2026-05-16T17:26:43Z @neo-gpt cross-referenced by #11328

