richfrem/agent-plugins-skills / plugins/agent-exploration-cycle/.apm/skills/running-exploration-cycle
running-exploration-cycle
VerifiedRuns the business exploration cycle end to end: starts or resumes a session (intake interview, session brief), enforces the Discovery Plan HARD-GATE, routes the four phases (Discovery Plan, Visual Blueprinting, Prototype, Handoff) to the sibling skills and keeps session state. Use when the user says "let's explore this idea", "I have an idea I want to explore", "help me plan this out", "start discovery", "resume my exploration", "where did we leave off", or starts any conversation about a need, problem or idea before building. Not for hardening an existing prototype (use reengineering-vibe-code) or for engineering build work.
references/discovery-planning.md
View on GitHub# Discovery Planning (`discovery-planning`) (absorbed skill)
> Absorbed from the retired `discovery-planning` skill into `running-exploration-cycle`; the full original body follows.
> Original trigger description: Guides a Subject Matter Expert through a structured discovery session to create and approve a Discovery Plan before any building begins. This is the HARD-GATE brainstorming skill — no prototype can be built until the SME explicitly approves the plan. Trigger phrases: "start a discovery session", "let's plan this out", "help me figure out what we're building", "I have an idea I want to explore", "let's start from scratch"
> Original allowed-tools: Read, Write
Guides a Subject Matter Expert through a structured discovery session to create and approve a Discovery Plan before any building begins.
## Contents
- [Constraints](#constraints)
- [Quick start](#quick-start)
- [Workflow](#workflow)
- [Verification](#verification)
- [References](#references)
## Constraints
- **Hard-gate rule**: No prototype files may be written until the SME explicitly confirms the discovery plan ("YES", "approved").
- **Sequential questioning**: Ask questions one at a time and reflect understanding before asking the next.
- **Intervention check**: Verify whether software is truly required, or if a process or policy change solves the root issue.
- **Database authority**: Record state transitions in the authoritative SQLite state engine.
## Quick start
```bash
# Check existing session brief before initiating discovery interview
test -f exploration/session-brief.md && cat exploration/session-brief.md
```
## Workflow
1. **Pre-Discovery**: Ingest `exploration/session-brief.md` and select session track (Greenfield, Feature, Spike, etc.).
2. **Interactive Interview**: Ask targeted questions one by one across context, users, and constraints.
3. **Plan Compilation**: Draft discovery plan at `exploration/discovery-plans/discovery-plan-YYYY-MM-DD.md`.
4. **Approval Gate**: Present plan to SME and wait for explicit affirmation ("YES") before advancing.
5. **Handoff**: Emit `HANDOFF_BLOCK` and return control to `exploration-workflow`.
## Verification
```bash
# Verify discovery plan exists and is approved in state engine
python3 scripts/state_engine.py status # run from the running-exploration-cycle skill folder
```
## References
- [discovery-planning-tracks.md](discovery-planning-tracks.md) — All 7 session tracks, question scripts, and plan format.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |