§ reference · skill
explore
Compares 2–4 candidate approaches across precedent-fit, integration risk, migration cost, verification cost, and novelty, then recommends one — ready to feed `design` or `blueprint`.
§ 01 · purpose
Purpose
When several valid approaches exist, explore produces a side-by-side comparison instead of jumping to one. Surface trade-offs explicitly so the design pass starts with the architectural shape already chosen.
§ 02 · when to use
When to use it
- There are multiple valid implementations and you cannot pick on intuition alone.
- The space includes external libraries — you need an ecosystem scan with links.
- You're a valid pipeline entry point on its own (feeds
designorblueprintdirectly).
§ 03 · inputs
Inputs
| Name | Required | Source |
|---|---|---|
feature/change description | yes | Free-text on invocation |
tickets / research docs | no | Paths mentioned inline — read FULLY for constraints |
§ 04 · outputs
Outputs
| Artifact | Path | Format |
|---|---|---|
| Solutions document | .rpiv/artifacts/solutions/ | markdown (design-compatible) |
§ 05 · key steps
Key steps
- Generate 2–4 named candidates from three sources Why: Ecosystem scan via
web-search-researcherfor external libraries · design-space enumeration for first-principles shapes · user shortlist for already-named picks. Merging the three avoids missing whole categories of solution. - Confirm candidates × dimensions checkpoint Why: Dimensions (approach-shape · precedent-fit · integration-risk · migration-cost · verification-cost · novelty) are confirmed *before* per-candidate fit agents are dispatched — keeps the analysis budget proportional to the relevant axes.
- Per-candidate fit dispatch in parallel Why: One agent per candidate, scoring against the locked dimensions. Running concurrently keeps the comparison balanced — no candidate gets stale context from prior reasoning.
- Synthesize a comparison matrix + recommendation Why: A matrix is scannable; a recommendation forces a position. Both produce a clean handoff to
design/blueprint, which expects a chosen shape rather than a menu.
§ 06 · related skills
Related skills
upstream discover