openspec-explore

Explores ideas, investigates codebases, and clarifies requirements before creating OpenSpec change proposals.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/TranVanTienDat/Milkyway --skill openspec-explore-tranvantiendat
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-explore
Source: https://github.com/TranVanTienDat/Milkyway/tree/main/agent-core/.cursor/skills/openspec-explore
Command: npx skills add https://github.com/TranVanTienDat/Milkyway --skill openspec-explore-tranvantiendat

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 dedicated thinking mode where you can investigate the codebase, compare approaches, and crystallize decisions before committing to a change proposal. ## Core Features & Use Cases - Exploration stance: Acts as a thinking partner that asks clarifying questions, challenges assumptions, and surfaces risks without following a rigid script. - Codebase grounding: Reads and maps existing architecture, integration points, and patterns to keep discussions grounded in the actual code. - OpenSpec integration: Detects active changes via the openspec CLI, reads existing proposals and designs, and offers to capture decisions into specs, design.md, tasks.md, or proposal.md. - Use Case: Before adding real-time collaboration to your app, enter explore mode to map the collaboration spectrum, compare CRDT versus simpler presence approaches with ASCII diagrams, then capture the chosen direction in a design document. ## Quick Start Ask the assistant to enter explore mode and think through your idea or problem before creating an OpenSpec change proposal.

Frequently Asked Questions about openspec-explore

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

FAQPage Schema
How do I explore an idea before writing code with OpenSpec?▼

Enter explore mode and describe your idea or problem. The assistant investigates the codebase, draws ASCII diagrams, compares options, and asks clarifying questions, then offers to create a change proposal once your thinking crystallizes.

What is the difference between explore mode and implementing a change?▼

Explore mode is strictly for thinking: reading code, mapping architecture, and discussing tradeoffs. It never writes application code. Implementation happens only after you exit explore mode and create a formal change proposal.

Does openspec-explore require the openspec CLI?▼

Yes, the Skill requires the openspec CLI installed. It runs commands like openspec list --json to detect active changes and reads artifacts such as proposal.md, design.md, and tasks.md for context.

Can explore mode update my OpenSpec design or spec files?▼

Yes, it can create or update OpenSpec artifacts like specs, design.md, tasks.md, and proposal.md when you ask. It offers to capture decisions but never modifies artifacts automatically without your approval.

When should I not use explore mode?▼

Avoid explore mode when you already have a clear, approved plan and just need implementation. It is designed for open-ended thinking, so using it for straightforward coding tasks adds unnecessary discussion overhead.