post-ideation-workflow.md
155 lines · skills/ce-ideate/references/post-ideation-workflow.md at 3449230
Most marks come from matching words in the file, so treat them as pointers.
Post-Ideation Workflow
Read this file after Phase 2 ideation agents return and the orchestrator has merged and deduped their outputs into a master candidate list. Do not load before Phase 2 completes.
Raw lines 1 to 4Phase 3: Adversarial Filtering
Review every candidate idea critically. Critique runs in two layers — a fresh-context verifier first, then orchestrator arbitration. Fresh-context verification outperforms self-critique: the orchestrator synthesized some of these candidates itself and carries the full generation history, so it is anchored in ways a verifier that never saw the generation is not.
- **Basis verification (one generation-tier sub-agent — see the model tiers in
references/grounding.md).** Dispatch a verifier whose payload is only the consolidated grounding summary (including any user-supplied research dossier paths — it reads those files itself as needed) and the merged candidate list — none of the generation history. Prompt it to refute: for each candidate, check that the stated basis actually supports the claimed move, thatdirect:quotes exist where cited (spot-check by reading the file in repo mode), thatexternal:prior art is real and relevantly analogous, and thatreasoned:arguments hold. It returns a per-candidate verdict (sound / weak / refuted) with a one-line reason. Undergo deep(Phase 0.5), dispatch a second, ceiling-tier critic focused on novelty and feasibility with the same fresh-context payload.
Meeting-test in the verifier payload — state the floor explicitly, either way. By default, also have it judge whether each idea genuinely passes the meeting-test; because the verifier did not write the ideas, that judgment supersedes the generators' self-attestation. When tactical scope is active (Phase 0.5), tell the verifier the floor is waived and have it judge basis only. The verifier runs on a fresh context with none of the generation history, so a waiver it is not told about does not reach it — omitting this turns a tactical run's every candidate weak.
- Orchestrator arbitration. The orchestrator makes the final cut, weighing verifier verdicts without being bound by them — overrule a verdict when evidence in context contradicts it, and say so in the rejection reason.
If verifier dispatch fails for a reason that survives correcting the invocation, fall back to orchestrator-only filtering and note the degradation in the rejection summary.
Do not generate replacement ideas in this phase unless explicitly refining.
For each rejected idea, write a one-line reason.
Rejection criteria:
- too vague
- not actionable
- duplicates a stronger idea
- not grounded in the stated context
- too expensive relative to likely value
- already covered by existing workflows or docs
- interesting but better handled as a brainstorm variant, not a product improvement
- unjustified — no articulated basis (sub-agent failed to provide
direct:,external:, orreasoned:justification, or the stated basis does not actually support the claimed move) - basis refuted by verification (the verifier found a cited quote absent, prior art mischaracterized, or a reasoned argument unsound — and the orchestrator concurs)
- below ambition floor (fails the meeting-test: would not warrant team discussion — except when tactical scope is active (Phase 0.5), in which case this criterion is waived)
- subject-replacement (abandons or replaces the subject of ideation rather than operating on it — e.g., "pivot to an unrelated domain," "become a different organization")
- scope overrun (expands beyond the asked scope rather than ideating within it — e.g., proposes changes to the whole product when the user asked about one flow, stage, or section). Allowed only when the basis explicitly justifies the expansion; default is reject or downgrade.
Score survivors using a consistent rubric weighing: groundedness in stated context, basis strength (direct: > external: > reasoned:; none excluded, but direct-evidence ideas score higher all else equal), expected value, novelty, pragmatism, leverage on future work, implementation burden, overlap with stronger ideas, and axis spread (when Phase 1.5 produced an axis list) — survivor sets that cover the topic's axes outscore sets that cluster on one axis, all else equal.
Axis coverage as a list-level concern. When axes were defined, axis spread is evaluated across the survivor set, not per-idea. After per-idea filtering, check the survivor set: if axis coverage is uneven and stronger candidates exist on under-represented axes, prefer the spread when promoting borderline candidates. Phase 2's recovery dispatch should already have produced candidates for empty axes; this is a polish step on the survivor selection. If an axis ends up with zero survivors despite recovery (or because recovery hit the 2-axis cap), note it in the rejection summary as a deliberate gap rather than an oversight.
Target output:
- an explicit survivor count in the prompt wins outright —
top 3, or a total too small to spread across the frames; absent one, keep 5-7 survivors - if too many survive, run a second stricter pass
- if fewer than that count survive — five, on a default run — report that honestly rather than lowering the bar
Phase 4: Write and Present the Deliverable
The ideation artifact is produced automatically — persistence is not opt-in. After filtering, write the deliverable, show a concise summary, and open it. The full content lives in the file; the session shows only an orienting summary, so the rich format is what the reader actually engages with.
Survivors checkpoint. Before writing the deliverable, write <scratch-dir>/survivors.md (absolute path from Phase 1) containing the survivor list plus key context (focus hint, grounding summary, rejection summary). Best-effort: if the write fails, log a warning and proceed; the run does not depend on the checkpoint. Reuses the same <run-id> / <scratch-dir> generated in Phase 1.
4.1 Write the Deliverable (automatic, both modes)
OUTPUT_FORMAT (resolved per references/output-mode.md; default html) sets the extension. Write the file every run — do not wait for the user to ask.
- Resolve the target directory and extension.
- Extension follows
OUTPUT_FORMAT(.htmldefault,.mdon override). - Repo mode: ensure
<root>/ideation/exists (create if absent). - **Elsewhere mode with
<root>/ideation/already present:** use it. - **Otherwise (no repo, or elsewhere with no
<root>/ideation/):** write into the run's CE temp area — the<scratch-dir>resolved in Phase 1 (<scratch-root>/ce-ideate/<run-id>/). Do not write into the user's current working directory, and do not create a<root>/ideation/tree for a subject unrelated to the repo. Announce the absolute path and note it is temporary (/tmpis cleared on reboot — move it to keep it). - Choose the file path:
<dir>/YYYY-MM-DD-<topic>-ideation.<ext>(or<dir>/YYYY-MM-DD-open-ideation.<ext>when no focus exists). - Load the section contract and rendering reference (deferred from Phase 0.0): read
references/ideation-sections.mdand the format-rendering reference matchingOUTPUT_FORMAT—references/markdown-rendering.mdformd,references/html-rendering.mdforhtml. - Write the document per those references.
ideation-sections.mddefines the section contract (metadata, Grounding Context, Topic Axes, Ranked Ideas with per-idea fields, Rejection Summary); the rendering reference defines how the resolved format presents it. Content is identical across formats; only presentation differs. - On write failure (no writable path, permissions): announce the failure and offer a custom path (validate writable; create parent dirs). Never lose the survivors silently.
Resume: update the existing file in place, in its existing format (per the resume precedence in references/output-mode.md); carry the prior ideas and rejection summary forward, adding to them rather than overwriting.
4.2 Present a Concise Summary (not the full deliverable)
The full cards, rationale, downsides, diagrams, and the rejection table live in the file. Do not reproduce them in the session — reprinting the whole deliverable as chat text defeats the rich format and leads the reader through plain text before they ever see it. Show a tight orientation instead:
- One line with counts and the path: e.g.
Wrote 7 ranked ideas (36 raw, 13 cut) across 5 axes → <absolute path>. - A ranked list, one line per survivor:
1. <Title> · <axis> · Conf <High/Med/Low> · Cx <S/M/L>. - The top pick called out in a sentence.
- Any axis with zero survivors noted in one line (the deliberate gap).
This ranked list doubles as the index the user references when choosing an idea in Phase 5. Terminal-only readers still get a usable view; depth is one open away.
Raw lines 66 to 764.3 Open It
- HTML: in an interactive session, best-effort open the file in the browser via the platform's open primitive (
openon macOS,xdg-openon Linux,starton Windows); always print the absolute path so it can be reopened or shared. Skip auto-open in headless / pipeline runs (there is no interactive session to open a browser in). - Markdown: print the path. Publishing a copy is a network action reached through the Phase 5 menu, never auto-invoked.
Phase 5: Next Steps
Ask what to do next through the host's blocking question tool, with the fallback SKILL.md Boundary 4 states. Free-text answers are accepted.
The deliverable already exists (Phase 4), so the menu is purely what next — there is no "save" step.
Stem: "Your ideation is saved to <path>. What next?"
Offer up to four options (self-contained labels with the distinguishing word front-loaded so they stay distinct when truncated):
- Open or share the saved file. The option's label is the destination
references/publishing.mdchooses: Publish a copy to <destination> for a publisher the user named or the host's artifact tool, or Open in browser for the local HTML file. Omit this option on a markdown run when no publisher or host artifact tool applies; Phase 4.2 already printed the path. - **Brainstorm one idea with
ce-brainstorm** — commit a chosen idea to a requirements-only unified plan under<root>/plans/; leaves ce-ideate. Asks which idea first. - Discuss or refine the ideas first — stay here to think across the set before committing: adjust or interrogate one idea, compare several, or combine/merge them. Asks what you want to work on.
- Done — keep the file and stop.
Adjacent nudge (prose, not a slot): "Don't want it kept? Say 'discard' and the agent deletes the file." Handled via free text (see §5.5); it is create-only and never deletes a resumed or pre-existing doc.
If the user already named what they want to work on inline (e.g. "brainstorm the table tool", "tighten the highlighter idea", "merge the table and highlighter ideas"), skip the follow-up that asks what to work on for §5.2 / §5.3.
Raw lines 82 to 1005.1 Open or Share the Saved File
Read references/publishing.md and follow it. The Phase 4 file already exists and stays the authoritative record. Pass a publisher the doc title Ideation: <topic> or the doc's H1. Show the user the resulting URL or path, then return to the Phase 5 menu.
5.2 Brainstorm One Idea
- Identify the idea by number or name (skip if the user already named it). Match against the ranked list from Phase 4.2.
- Build a focused seed from the idea's substance already in the orchestrator's context. Do not pass the whole file — wasteful and noisy (the other survivors, grounding, and rejection table are irrelevant to defining this one idea, and an HTML file carries CSS/SVG chrome). Do not pass only a file pointer — that forces
ce-brainstormto re-open and re-extract the idea the orchestrator already holds. The seed is feature-description-shaped:
<title> — <description>. Basis: <basis/evidence>. Why it matters: <rationale>. Known tradeoffs: <downsides>.The basis/evidence directly feeds ce-brainstorm's product-pressure-test, so it won't re-derive what we already know. Append a one-line provenance pointer: (Seeded from ce-ideate: <path>, idea "<title>") — it records origin and lets brainstorm pull adjacent detail if it wants, without being forced to read anything.
- **Load the
ce-brainstormskill** with that seed. The saved file is already the record — no extra write step.OUTPUT_FORMATdoes not propagate: ce-brainstorm re-resolves its ownbrainstorm_outputconfig independently. Asymmetric output (ideation.htmlplus a markdown unified plan) is expected; a user who wants HTML for both sets both keys in CE config (config.local.yamlthenconfig.yaml).
Repo mode only: do not skip brainstorming and go straight to ce-plan — ce-plan wants a brainstorm-grounded Product Contract. In elsewhere modes, ideation is a legitimate terminal state; brainstorming is optional deeper development of one idea, not a required next rung on an implementation ladder that does not exist in these modes.
5.3 Discuss or Refine the Ideas First
This stays in ce-ideate — no skill handoff. It is the "think across the set before committing" step, and a normal outcome of ideation. The orchestrator still holds the full grounding and generation context, so it can reason across every survivor.
- Scope comes from the user. Infer it from their phrasing when given; otherwise ask one open question ("What do you want to work on?"). It may be one idea, a subset, or the whole set, and cross-idea discussion — comparing, finding overlap, combining — never requires naming a single idea first.
- Ground the work in the ideas' bases and the Phase 1 grounding.
- Rewrite the saved file only when idea content changes — an adjustment, a merge, or added analysis the user wants kept. Answers and comparisons alone leave the file untouched.
- A merge replaces its source entries with one combined entry. Write a unified title, description, and basis that draws on each source (carry the strongest basis forward; union their evidence), remove the originals, renumber the ranked list, and re-evaluate the combined idea's axis and confidence rather than copying one source's. If the combined idea leaves out a source's substance, say so in the rejection summary.
Then return to the Phase 5 menu. Typically the user next brainstorms a sharpened or merged idea (§5.2), discusses more, opens it, or finishes.
Raw lines 117 to 1275.4 Done
The file is already written, so there is no save step.
- Inside a git repo: offer to commit only the ideation doc (do not create a branch, do not push; if the user declines, leave it uncommitted).
- Temp-area or non-repo file: skip the commit offer.
Then narrate the path and end the session — do not return to the menu.
Raw lines 128 to 1365.5 Discard (free text)
Only when the file was created fresh this run: delete it, confirm the deletion, and end. On a resume run (a pre-existing file was updated in place), do not delete — tell the user the existing doc at <path> remains and offer no destructive action. Discard is never a default; it happens only on an explicit request.
Do not delete the run's scratch directory (<scratch-dir>) on completion — it holds the web-research cache reused across run-ids by later ideation invocations in the same session (see references/web-research-cache.md), the raw-candidates and survivors checkpoints, any research dossiers, and (in the no-repo case) the deliverable itself. OS handles eventual cleanup.
Quality Bar
Before finishing, check:
- every surviving idea has an articulated basis (
direct:,external:, orreasoned:) that actually supports the claimed move — speculation dressed as ambition was rejected, with reasons - the
direct:bases that surviving ideas rest on were verified against the repo (or the supplied context) — by the generating agent's verification reads or the Phase 3 verifier — not taken on faith - every surviving idea passes the meeting-test unless tactical scope was active (Phase 0.5) and waived the floor
- no surviving idea replaces the subject rather than operating on it
- when Phase 1.5 produced an axis list, the survivor set spreads across axes rather than clustering on one — and any axis with zero survivors is noted as a deliberate gap in the rejection summary, not silently absent
- every rejected idea has a reason
- the deliverable was written automatically in both modes (Phase 4) — to
<root>/ideation/when present, else the CE temp area, never the user's CWD - the session showed a concise summary, not a reproduction of the full deliverable
- acting on an idea routes to
ce-brainstorm(with a substance seed, not the whole file), not directly to implementation