openspec-explore

Explores ideas and clarifies requirements through guided thinking before creating OpenSpec change proposals.

Updated Mar 7, 2024
One-click install
npx skills add https://github.com/girlguidingstaplehurst/booking --skill openspec-explore-girlguidingstaplehurst
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-explore
Source: https://github.com/girlguidingstaplehurst/booking/tree/main/.opencode/skills/openspec-explore
Command: npx skills add https://github.com/girlguidingstaplehurst/booking --skill openspec-explore-girlguidingstaplehurst

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams often jump into implementation before fully understanding a problem, leading to rework and misaligned requirements. This Skill provides a structured thinking partner that investigates the codebase, challenges assumptions, and captures decisions as OpenSpec change artifacts without writing implementation code. ## Core Features & Use Cases - Guided Discovery: Asks focused questions, follows dependencies between decisions, and grounds discussion in the actual codebase using read-only OpenSpec CLI commands. - ASCII Visualization: Renders architecture sketches, state machines, and comparison tables in plain ASCII to clarify complex design discussions. - Change Capture: Scaffolds new changes with openspec new change and creates proposals, designs, specs, and task artifacts following CLI-provided instructions and templates. - Use Case: A developer unsure whether to use SQLite or Postgres for a CLI tool invokes explore mode; the Skill inspects the project, compares tradeoffs in a table, recommends an option, and offers to capture the decision in a design artifact. ## Quick Start Ask the assistant to enter explore mode and think through whether your planned feature should be scoped as a new OpenSpec change before any code is written.

Frequently Asked Questions about openspec-explore

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I explore a feature idea before writing code?▼

Invoke explore mode and describe your idea. The assistant investigates the codebase, asks focused questions, draws ASCII diagrams of options, and only captures decisions into OpenSpec artifacts after you explicitly confirm the scope.

How to create an OpenSpec change proposal from a discussion?▼

Once exploration crystallizes, confirm you want a change captured. The assistant runs openspec new change to scaffold it, then follows openspec status and instructions commands to create the proposal, design, specs, and tasks in dependency order.

Does openspec-explore write implementation code?▼

No. Explore mode never writes code or implements features. It only runs read-only commands and creates OpenSpec change artifacts such as proposals and specs within a scope you explicitly confirm.

What is required to use the openspec explore workflow?▼

The openspec CLI must be installed, since the Skill runs commands like openspec list, status, instructions, and new change. Projects without a local openspec directory can use a registered store via the --store flag.

When should I not use explore mode?▼

Avoid explore mode when you already know exactly what to build and just want implementation. It is designed for open-ended thinking and requirement clarification, so direct implementation requests are redirected to a change proposal workflow first.