openspec-explore

Explores ideas, investigates codebases, and clarifies requirements through conversational thinking with ASCII diagrams.

Updated Nov 7, 2023
One-click install
npx skills add https://github.com/lstellway/nixfiles --skill openspec-explore-lstellway
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-explore
Source: https://github.com/lstellway/nixfiles/tree/main/modules/home-manager/claude/skills/openspec-explore
Command: npx skills add https://github.com/lstellway/nixfiles --skill openspec-explore-lstellway

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When starting a new feature or debugging a design, developers often jump into implementation before fully understanding the problem space. This Skill provides a dedicated explore mode where the AI acts as a thinking partner—investigating the codebase, visualizing architecture, and surfacing tradeoffs—without writing any implementation code. ## Core Features & Use Cases - Codebase Investigation: Maps existing architecture, finds integration points, and surfaces hidden complexity relevant to the discussion. - Visual Thinking: Generates ASCII diagrams for state machines, data flows, dependency graphs, and comparison tables to clarify ideas. - OpenSpec Integration: Reads existing change proposals, designs, and specs via the openspec CLI, and offers to capture decisions into the right artifacts. - Use Case: Before building real-time collaboration, a user enters explore mode to compare presence indicators, multi-cursor coordination, and CRDT sync, then captures the chosen approach in a design document. ## Quick Start Ask the AI to enter explore mode and think through your idea or problem, for example by describing a vague feature idea or a specific technical problem you want to investigate before implementing.

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?

Enter explore mode and describe your idea in natural language. The AI investigates the relevant codebase, draws ASCII diagrams of options and tradeoffs, and asks clarifying questions without writing any implementation code.

What is OpenSpec explore mode used for?

Explore mode is a thinking stance for clarifying requirements, comparing approaches, and investigating architecture before or during a change. It can read OpenSpec artifacts like proposals and designs, and offers to capture decisions when they crystallize.

Can explore mode write code or implement features?

No. Explore mode explicitly never writes application code or implements features. It may only read files, search the codebase, and create OpenSpec artifacts such as proposals, designs, and specs when the user asks.

Does openspec-explore require any external tools?

Yes, it requires the openspec CLI to be installed. The skill runs commands like openspec list --json to detect active changes and reads artifacts under the openspec/changes directory for context.

When should I exit explore mode and create a change proposal?

Exit explore mode when the problem and approach feel crystallized and you are ready to implement. The AI will offer to create a change proposal at that point, but the decision to formalize is always yours.