lvlup-sw/exarchos/discover

Discovery Workflow Skill

A workflow type for tasks whose deliverable is a document, not code. It carries no verification gates (nothing to test), so the verification ladder does not apply.

When to Use

• Competitive analyses and market research
• Architecture comparisons and ADR scaffolding
• Literature reviews and vendor evaluations
• Design research that does NOT feed into implementation planning

When NOT to Use

• If the deliverable includes code changes → use /exarchos:oneshot or /exarchos:ideate
• If you need TDD enforcement → use any other workflow type
• If the research feeds directly into implementation → use /exarchos:ideate (which authors the Design & Rationale section of the unified docs/specs/ artifact)

Discover bridge (the deep-rung escalation)

At the deep planning rung, /exarchos:ideate can escalate to this workflow as an event-linked research pre-pass. The bridge is opt-in and never auto-runs. No next_actions affordance offers it: the ideate author escalates by hand, and only after the user confirms. The author then calls the discover_bridge orchestrate action with confirm: true. It stitches this discovery run to the originating spec by a deterministic correlationId, recorded as a state.patched link event on the feature stream. When you run a discovery escalated this way, init this workflow with the discoverFeatureId that the bridge returns. Cite the report path and the correlationId in the spec's ## Design & Rationale → Exploration section so provenance spans both documents.

Phases

Phase 1: Gathering (initial)

Collect sources, references, and raw material for the deliverable.

1. Define the research question or deliverable scope
2. Identify and collect sources (URLs, documents, code references)
3. Record sources in workflow state:

exarchos:exarchos_workflow({
  action: "update", featureId: "<id>",
  updates: { "artifacts.sources": ["<source1>", "<source2>", "..."] }
})

1. Create an outline of the deliverable

Transition: When artifacts.sources is a non-empty array → synthesizing

Phase 2: Synthesizing

Draft the deliverable document from gathered sources.

1. Write the document based on gathered sources and outline
2. Commit the document to the repo (typically under docs/research/ or docs/designs/)
3. Record the report path:

exarchos:exarchos_workflow({
  action: "update", featureId: "<id>",
  updates: { "artifacts.report": "<path-to-document>" }
})

Transition: When artifacts.report is set → completed

Optional: Escalation to Implementation

If discovery surfaces an implementation need:

1. Note the finding in the report
2. After completing the discovery workflow, start a new workflow:

``bash ideate <implementation-topic> `` Reference the discovery report as design input.