ramza-discover

RAMZA — DISCOVER Skill (pre-CLARIFY elicitation)

Use this skill when the request's objective itself is unknown or latent — not merely when the spec details are ambiguous. DISCOVER runs BEFORE CLARIFY and hands CLARIFY a structured elicitation summary.

When to run DISCOVER (vs CLARIFY)

	DISCOVER	CLARIFY
Precondition	Goal is unknown / latent	Goal is known; spec details ambiguous
Intent types	IDEA, STRATEGIC, any under-GOALED request	REQUEST, CHANGE, BUG_SPEC
Question style	Open-ended discovery of goals, stakeholders, success	≤3 plan-shape disambiguation questions
Output	Elicitation summary → handed to CLARIFY	WHO/WHAT/WHY/CONSTRAINTS parse → Scope

Boundary rule: DISCOVER = "what are we even trying to achieve, and for whom?" CLARIFY = "the goal is clear; which of these plan shapes do you want?" Do NOT run DISCOVER on a well-GOALED request — go straight to CLARIFY.

Why this exists: specification/system-design is the dominant multi-agent failure category (MAST — ~43.8% of failures), and multi-agent systems collapse toward ~30% accuracy when latent stakeholder knowledge is never actively elicited (HiddenBench). CLARIFY alone cannot close this — its ≤3 plan-shape contract assumes the goal is already known. This sub-mode is inherited unchanged from SPECTRA (see DESIGN-RATIONALE.md D2 — the discipline spine is the part the audits praised; DISCOVER's failure mode was never its elicitation design).

Elicitation protocol (bounded, read-only)

Surface, do not assume. For each axis, record what is known and emit a [GAP] marker for each unknown rather than inventing an answer:

1. Stakeholders — Who requests this? Who is affected? Who approves/reviews? Map the approval chain. [GAP] for each unidentified party.
2. Latent goals — What is the underlying outcome (not the surface ask)? What is the "job to be done"? Distinguish the stated request from the real goal.
3. Success metrics — How will we know it worked? Target metric + current baseline (e.g. "p95 < 200ms, currently 800ms"). [GAP] when no measurable criterion exists.
4. Hard constraints — Budget, deadline, tech-stack lock-in, compliance, platform.
5. Non-goals — What is explicitly OUT of scope? Surface these early to prevent scope creep downstream.

Bound (no unbounded interview loop)

DISCOVER is elicitation + synthesis, NOT an interactive multi-turn interview agent.

• Produce ONE elicitation summary in a single pass from available context + the host conversation. Do not loop.
• If coverage is low (≥2 of the 5 axes are [GAP] with no resolution path), escalate to the human with the gap list — do not fabricate goals to proceed.
• DISCOVER NEVER produces a plan and NEVER writes code. Its sole output is the elicitation summary handed to CLARIFY.

Mechanical coverage contract

The 5 axes are line items a host can count mechanically — no re-reading DISCOVER's reasoning required:

• Each axis line in the summary below is exactly one of two states: resolved (the line contains no [GAP] token) or unresolved (the line contains the literal token [GAP]).
• unresolved_count = the number of axis lines (Stakeholders / Latent goal / Success metrics / Hard constraints / Non-goals — the first 5 checklist lines only, not the Open gaps / Coverage lines that restate them) containing [GAP].
• Contract: unresolved_count >= 2 ⇒ ESCALATE to human, do not hand off to CLARIFY. unresolved_count <= 1 ⇒ hand off to CLARIFY normally.
• This is a mechanical count (e.g. grep -c '\[GAP\]' over the 5 checklist lines), not a model self-assessment — a host or lint step can enforce the ≥2-unresolved rule without re-deriving DISCOVER's judgment, exactly the same posture as ramza-lint's grep-level structural checks.

Output: elicitation summary

A compact structured checklist (lives under .spectra/ like all RAMZA output). Each of the first 5 lines is the mechanically-countable unit described above:

## DISCOVER — Elicitation Summary
- [ ] Stakeholders: <list | [GAP]>
- [ ] Latent goal: <restated outcome | [GAP]>
- [ ] Success metrics: <metric + baseline | [GAP]>
- [ ] Hard constraints: <list>
- [ ] Non-goals: <list>
- Open gaps: [GAP] <each unknown, repeated from above for visibility>
- Coverage: <n/5 axes resolved> → handing to CLARIFY | ESCALATE to human

Check the box (- [x]) for a resolved axis (no [GAP] on that line); leave it unchecked (- [ ]) when the line still carries [GAP]. unresolved_count is the number of unchecked boxes, and MUST match the coverage line's arithmetic (5 - n = unresolved_count).

Hard constraints (P0)

1. READ-ONLY. No code, no file edits, no mutations.
2. Bounded — single-pass synthesis, [GAP]-and-escalate, never an interview loop.
3. Emit [GAP] for every unknown; never assume latent intent.
4. DISCOVER hands its summary to CLARIFY; it does not itself produce a plan.
5. Coverage is mechanically countable: ≥2 unresolved [GAP] axes ⇒ escalate, computed from the checklist, never eyeballed.
6. Every output path lives under .spectra/ (see SPEC.md "Output discipline").

See SPEC.md "## Pre-phases" for the full methodology section.

---

RAMZA — DISCOVER sub-mode