Skip to content

Phase 3 — Inception Process Skill (workflow-inception-process)#268

Open
leeovery wants to merge 14 commits into
idea/inception-pr-2-entry-bridgefrom
idea/inception-pr-3-process
Open

Phase 3 — Inception Process Skill (workflow-inception-process)#268
leeovery wants to merge 14 commits into
idea/inception-pr-2-entry-bridgefrom
idea/inception-pr-3-process

Conversation

@leeovery
Copy link
Copy Markdown
Owner

@leeovery leeovery commented May 9, 2026

Summary

Third PR in the inception/discovery-map initiative. Phase 2 built the inception door (entry skill, bridge route, discovery awareness); this PR builds the room behind it — the conversational inception session that runs after /workflow-inception-entry invokes it.

After this phase, invoking /workflow-inception-entry epic {wu} works end-to-end if invoked manually:

  • Curatorial conversation surfaces topics from the work-unit description.
  • Routing inferred from cues (research vs. discussion); user can flip.
  • Single STOP gate at confirm-and-persist; manifest writes batch into one commit alongside the finalised session log.
  • Bridges back to /continue-epic via the existing inception-continuation route.

start-epic still doesn't auto-route to inception (Phase 4); refinement re-entry is still stubbed (Phase 6).

Files

New — skills/workflow-inception-process/ (1 backbone + 8 references, pure addition):

  • SKILL.md — backbone with 10 steps (resume → init → guidelines → knowledge → query → loop → persist → review → compliance → conclude). Mirrors discussion-process structure; no background-agent step.
  • references/initialize-inception.md — creates inception/ directory, seeds draft session log. No manifest writes (deferred).
  • references/inception-guidelines.md — curatorial moves + hard rules + worked examples.
  • references/routing-inference.md — cue lists + worked examples + how-to-propose discipline.
  • references/session-loop.md — open → surface → infer → anchor → convergence-signal. No agents.
  • references/confirm-and-persist.md — single STOP gate; per-topic init-phase + 3 sets; finalised log; one commit.
  • references/document-review.md — lighter than discussion's (~30 lines): topics persisted, dropped recorded, no rationale drift.
  • references/conclude-inception.md — bridge invocation. No `knowledge index` (inception is not a KB-indexed phase).
  • references/template.md — initial session-log template per design.md "Session log shape".

Also resolves the dangling forward references on Phase 2's branch:

  • workflow-inception-entry/references/invoke-skill.mdworkflow-inception-process now exists.
  • workflow-bridge/references/inception-continuation.md is reachable from conclude-inception.md.

Test plan

  • Phase 1 manifest test suite still passes (214/214 — bash tests/scripts/test-workflow-manifest.sh).
  • discovery.cjs runs cleanly on an empty dir (`no active epics`).
  • Synthetic epic with two inception items renders correctly under `continue-epic` discovery output, items shape matches design (`status: in-progress`, `summary`, `routing`, `source: inception`).
  • Manual end-to-end smoke: invoke `/workflow-inception-entry epic test-epic`, surface 2-3 topics, walk to confirm-and-persist gate, verify on-disk shape + commit + bridge.
  • Manual resume smoke: kill mid-loop after `session-001.md` partly written; re-invoke; Step 0 detects + offers continue/restart.
  • Manual refinement-stub regression: seed an inception item; entry skill's `validate-phase.md` still fires the Phase-6 stub.

Stacking

🤖 Generated with Claude Code

leeovery and others added 14 commits May 9, 2026 17:09
…tialize/template

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
…ences

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Removes Step 3 (Knowledge Usage) and Step 4 (Contextual Query) from
the inception backbone — wrong granularity for a curatorial phase.
Per-topic KB queries at research/discussion entry capture the
cross-work-unit awareness benefit with focused signal. Inception
querying the work-unit description was broad, mostly returned zero
results, and risked anchoring framing to prior-epic shape.

Also drops the duplicate Hard Rules block from SKILL.md (it lives
canonically in inception-guidelines.md, matching discussion-process
precedent), and trims a redundant curatorial-mode echo in
session-loop.md.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
…gence

Match the investigation-process precedent — Keep going stays a prompt
option so the user states what to adjust in the same turn, rather
than a command option that would force a follow-up clarification.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Drops file-purpose preambles, section-intro labels, and content
duplicated across reference files (template.md sub-sections that
already lived in initialize/session-loop/confirm-and-persist).

Removes the redundant re-render-and-confirm gate in
confirm-and-persist — the convergence gate in session-loop is the
persistence approval; re-prompting was wasted ceremony.

Converts H3 sub-headings inside reference files to bold labels per
CONVENTIONS (H3 reserved for early-setup sub-steps).

Restores load-bearing content: KB-index/phase-status anti-patterns
in conclude-inception, routing note in confirm-and-persist,
context-refresh consequence in session-loop, length-permission in
template.

Net: 80 lines removed, no instructional content lost.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Section D was unreachable via routing — claude only saw it because
the file was loaded whole. Moves the two load-bearing guardrails
into section B at the points they protect: manifest-defer rule into
step 5 (where wrong manifest writes would happen), context-refresh
consequence into step 6 (where deferred writes lose state).

Every section now reachable: A → B → C, with C exiting to caller or
back to B.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Removing sections when empty creates ambiguity — was content
skipped on purpose or forgotten? Keeping the heading and writing
(none) makes intentional emptiness explicit. Updates four files:
initialize-inception (Imports), confirm-and-persist (general
rule), document-review (Considered and Discarded), template
(general rule).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Persistence was running before review — manifest writes from a
draft log that hadn't been reconciled against the conversation. If
review found drift, the manifest was already wrong. Mirrors the
correct ordering in discussion-process.

New order: Session Loop (3) → Document Review (4) → Confirm and
Persist (5) → Compliance (6) → Conclude (7).

Document review now also catches phantom topics — entries added
during the session but dropped during refinement, removed from the
log so persistence sees a clean source. Confirm-and-persist's log
finalisation simplifies to just populating the Conclusion section.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
- session-loop A.Open: drop the narrating-the-prompt sentence; the
  prompt itself does the inviting.
- session-loop C 'If keep going': restated B/C instructions verbatim;
  routing arrow alone does the job.
- confirm-and-persist B: drop the meta-context first sentence about
  why the section is short.
- document-review C: 'Proceeding to final compliance check' was
  stale after the step swap (next step is now persist). Trim.

Net 4 lines down. No content lost; only narration that didn't
instruct.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
…ef on resume

Two related issues with the resume path:

1. SKILL.md Step 0 'If continue' routed to Step 3 (Session Loop),
   skipping Step 2 (Load Guidelines). On resume, claude entered
   the loop with no curatorial moves or routing-inference loaded.
   Now routes to Step 2.

2. session-loop A. Open always opened with 'Tell me about what
   you want to build' — wrong on resume. A now branches: if the
   draft log has topics in Topics Identified, brief the user on
   the working list and ask where to pick up; otherwise fresh
   start.

Mirrors discussion-process precedent: resume routes through the
guidelines-load step before entering the session.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant