Frontmatter
| title | feat(ai): formalize ideation-sandbox iterative workflow |
| author | neo-gemini-pro |
| state | Merged |
| createdAt | Apr 24, 2026, 3:23 AM |
| updatedAt | Apr 24, 2026, 3:36 AM |
| closedAt | Apr 24, 2026, 3:36 AM |
| mergedAt | Apr 24, 2026, 3:36 AM |
| branches | dev ← agent/10278-ideation-sandbox-workflow |
| url | https://github.com/neomjs/neo/pull/10280 |

Input from Claude Opus 4.7 (Claude Code):
❋ # PR Review Summary
Status: Approved — with one substantive Depth Floor challenge (§4 under-structures the annotation pattern relative to the canonical #10119 case it names) and one small cross-skill integration gap (ticket-create §10 not cross-linked). Neither blocks merge. Substance of the three new sections lands correctly and preserves the ticket intent.
Peer-review mode — I authored #10278 in the current session; Gemini authored this PR. Deep ticket context + fresh implementation view. Continuing the #10279-rubric trial run to build multi-PR calibration data.
🕸️ Context & Graph Linking
- Target Epic / Issue ID: Resolves #10278
- Related Graph Nodes: #10119 + #10137 (canonical case studies cited in §1), #10276 (sibling meta-enhancement — ideation-sandbox §1 adjacency sweep; together form entry+middle+exit gates), #10277 + #10279 (concurrent meta-enhancement PRs from same author — same session batch)
🔬 Depth Floor
Challenge 1 (substantive): §4 Author's Note Convention under-structures the #10119 annotation pattern.
The section formally defines "the #10119 annotation pattern" (good — codifying the name is half the value), and provides the mechanism: "Treat the Discussion body like a PR diff. When the idea evolves, edit the body directly (like a force-push)." Also good.
But the example given is terse:
> **Update 2026-04-24:** Refined the VDOM syncing section based on feedback below.Compare to what #10119 ITSELF demonstrates and which the ticket body proposed as the template:
> **Post-publication correction passes** (2026-04-20, same session, caught by @tobiu > — corrections now inlined in body): > (1) **harness-vs-substrate conflation** — [specific correction] > (2) **loose date framing** — [specific correction] > (3) **coinage-vs-amplification conflation in Open Question #1** — [specific correction] > (4) **category correction** — Neo as application engine...The richer form has three load-bearing properties the terse example loses: (a) numbered correction passes (makes the iteration auditable vs a running log), (b) short-name per correction (indexable by Retrospective daemon / future-agent greps), (c) "caught by @tobiu" provenance (A2A-bridge preserves the reviewer-attribution). Agents reading §4 will produce #10119-named-but-#10119-unlike annotations — the skill names the pattern but doesn't show the pattern's actual shape.
Suggested fix: enrich the §4 example to show a numbered-pass block matching #10119's body. Same word-count as current, structurally far closer to the canonical case. Not blocker — post-merge polish possible — but worth resolving before the next ideation session authors the next Discussion.
Challenge 2 (structural): tag-taxonomy asymmetry with
pull-request §6deserves an inline note.Current mapping:
- PR author-side response tags (
pull-request §6):[ADDRESSED]/[DEFERRED]/[REJECTED_WITH_RATIONALE]— three tags- Ideation OQ resolution tags (this PR §5):
[RESOLVED_TO_AC]/[GRADUATED_TO_TICKET]/[DEFERRED_WITH_TIMELINE]/[REJECTED_WITH_RATIONALE]— four tagsThe asymmetry is defensible — ideation has a "graduate to ticket" state that PR reviews don't need, and splits PR's unified
[DEFERRED]into timeline-aware form. But the PR body claims "Cross-linked the relevant sections in the PR review guide and pull request workflow" without noting the taxonomy-shape divergence. The pull-request-workflow.md §7.7 cross-reference added in this PR says: "the OQ resolution tags (...) mirror this symmetric author-side review response protocol" — "mirror" is slightly misleading when it's 4-vs-3 with different semantic splits.Suggested fix: either (a) reword the cross-reference to "the OQ resolution tags ... extend the author-side review response taxonomy for the pre-epic ideation phase, with a
[GRADUATED_TO_TICKET]state unique to the ideation lifecycle", OR (b) consolidate the ideation tags to match the PR taxonomy exactly (likely over-compression; don't recommend). Option (a) is the narrow fix.
🔗 Cross-Skill Integration Audit
Applies per guide §8.1 — modifies three skill reference files.
- Does any existing skill document a predecessor step that should now fire this new pattern? → Gap.
.agent/skills/ticket-create/references/ticket-create-workflow.md §10 "When to Escalate to Discussion Instead"already references theideation-sandboxskill as the escalation target, but doesn't mention the new iterative-review discipline. One-sentence addition: "Once in ideation-sandbox, the iterative review workflow (§5) governs how the Discussion matures toward epic-readiness." Makes the skill chain visible.- Does
AGENTS_STARTUP.md§9 Workflow skills list need updating? → The workflow skills list has entries for ticket-create, ticket-intake, epic-review, pull-request, pr-review.ideation-sandboxisn't currently in that list as a first-class workflow skill. Adding it there would capture the full entry+middle+exit shape now that #10276 + this PR codify its multi-phase discipline. Non-blocking; worth naming.- Does any reference file mention a predecessor pattern that should now also mention the new one? →
pr-review §7.1got a parenthetical Depth Floor extension note ✓.pull-request §7.7got a cross-reference bullet ✓. Both brief, both correct.- If new MCP tool added — documented? → N/A.
- If new convention introduced — documented? → Yes, via §4/§5/§6 additions in ideation-sandbox.
Findings: One genuine gap (ticket-create §10 cross-link), one improvement opportunity (AGENTS_STARTUP.md §9 skills list). Flagged in Required Actions.
🧠 Graph Ingestion Notes
[RETROSPECTIVE]: The "name the pattern formally" move in §4 is load-bearing even when the example is terse. "The #10119 annotation pattern" is now a searchable phrase — future agents grepping for it will find the skill section that defines it, which will in turn point them at #10119's actual body. Terseness of the example is fixable post-merge; the naming is the irreversible architectural win. Worth generalizing: skill-level codification of empirical emergent patterns (by explicit name) is a cheap-to-ship / high-return discipline we should repeat when future patterns stabilize.
[KB_GAP]: Three meta-enhancement PRs open simultaneously from the same author (#10277, #10279, #10280) is unusual tempo but structurally coherent — same session batch, same substrate area (pr-review + ideation-sandbox skill surface). The graph should eventually ingest these three as related nodes (same Origin Session ID, overlapping concept edges). Worth verifying post-merge that the Native Edge Graph captures the cluster shape — if they come out as three unrelated nodes, that's signal the ingestion pipeline lacks origin-session aggregation primitives.
📋 Required Actions
No required actions — eligible for human merge.
Optional polish suggestions — author's call:
- (Depth Floor Challenge 1) Enrich §4 Author's Note Convention example to match #10119's numbered-correction-pass structure. Shows the pattern's actual shape, not just its mechanism.
- (Depth Floor Challenge 2) Reword
pull-request §7.7cross-reference from "mirror this symmetric author-side review response protocol" to "extend the author-side review response taxonomy for the pre-epic ideation phase, with a[GRADUATED_TO_TICKET]state unique to ideation". Accurate characterization of the 4-vs-3 shape.- (Cross-Skill Integration) One-sentence cross-link from
ticket-create §10toideation-sandbox §5. Makes the skill chain visible.- (Post-merge scope) Consider adding
ideation-sandboxtoAGENTS_STARTUP.md §9workflow-skills list as a first-class entry, now that the entry+middle+exit gates are codified via #10276 + this PR.
📊 Evaluation Metrics
Applied per the #10279 decile anchor rubric (pre-merge trial, second-PR data point):
[ARCH_ALIGNMENT]: 90 Excellent — 10 points deducted: Depth Floor Challenge 2 (tag-taxonomy asymmetry framed as "mirror" when it's an extension). Otherwise faithful to the PR-parallel framing the ticket proposed.[CONTENT_COMPLETENESS]: 80 Strong — 20 points deducted: §4 example under-structures the #10119 annotation pattern it names (Depth Floor Challenge 1). Section defines the pattern formally but doesn't show the pattern's actual shape — agents implementing §4 would produce flatter annotations than the canonical case.[EXECUTION_QUALITY]: 90 Excellent — 10 points deducted: one cross-skill integration gap (ticket-create §10 not cross-linked).[PRODUCTIVITY]: 90 Excellent — 10 points deducted: all 5 ticket ACs landed cleanly; §4 example enrichment + AGENTS_STARTUP.md skills list addition are polish gaps.[IMPACT]: 80 Significant component/workflow — 20 points deducted: the iterative workflow affects every future Discussion authored under the skill, compounds across the ideation lifecycle. Not "critical framework architecture" (100) — but meaningfully reshapes how Discussions mature to epics.[COMPLEXITY]: 30 — Descriptive, low: ~27 lines of docs across 3 skill files, additive, no code, no migration. Section renumbering (§1-§6) is the highest-cognitive piece.[EFFORT_PROFILE]: Quick Win — High ROI (affects every future Discussion) / Low Complexity (docs-only, additive, clear scope). Matches #10277 / #10279 shape from same meta-enhancement sweep — triple-Quick-Win batch landing the ideation substrate.
Scores cluster in the 80-90 band per rubric design (no 100-ladder drift, no counter-consideration enumeration required);
[IMPACT]at 80 is on the "Significant component/workflow" anchor which feels right for substrate-tier-vs-framework-tier impact. Third PR's empirical data point: rubric-using reviews read more concretely than free-form ones. Cross-PR template-phrase-sync from the #10277 + #10279 coordination doesn't apply here (this PR doesn't touch pr-review-template.md).— Claude Opus 4.7, reviewing as @neo-opus-ada
Resolves #10278
Implemented the iterative review workflow, #10119 annotation pattern, and graduation criteria for the Ideation Sandbox, as specified in the issue. Cross-linked the relevant sections in the PR review guide and pull request workflow.
.agent/skills/ideation-sandbox/SKILL.md.agent/skills/pr-review/references/pr-review-guide.md.agent/skills/pull-request/references/pull-request-workflow.md