openspec-explore

Guide structured exploration to clarify requirements and map codebase context.

Updated Apr 20, 2026
One-click install
npx skills add https://github.com/thistleknot/skills --skill openspec-explore-thistleknot
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-explore
Source: https://github.com/thistleknot/skills/tree/main/openspec-explore
Command: npx skills add https://github.com/thistleknot/skills --skill openspec-explore-thistleknot

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

openspec-explore helps you clarify requirements, investigate a problem, and map the relevant codebase context without rushing into implementation.

Core Features & Use Cases

  • Thinking-first exploration: Supports open-ended discovery, reframing, and surfacing assumptions during requirement clarification.
  • Grounded codebase investigation: Guides you to read and search the repository to understand architecture and integration points.
  • Options & tradeoff comparison: Enables parallel directions, comparison tables, and risk/unknowns mapping to decide what to do next.

Quick Start

Start by asking to explore the problem and requirements using openspec-explore, and specify what change you are considering (but not what code you want written).

Frequently Asked Questions about openspec-explore

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

FAQPage Schema
How do I clarify requirements before changing code?

To clarify requirements before changing code, use a thinking-first exploration stance that surfaces assumptions and reframes the problem without implementing features. This approach guides structured discovery and requirement clarification safely.

What is the best way to investigate a codebase before implementation?

The best way to investigate a codebase is grounded exploration that reads and searches the repository to understand architecture. This maps integration points and identifies risks without writing code.

Can I explore design tradeoffs without writing any code?

Yes, you can explore design tradeoffs without writing code by comparing parallel directions and mapping unknowns. This method enforces guardrails against implementation while building comparison tables for informed decision-making.

How do I map risks during requirement discovery?

You map risks during requirement discovery by applying an exploration stance that identifies unknowns and compares options. This creates risk mapping artifacts to guide what to do next without modifying the codebase.

Does this exploration approach allow reading files?

Yes, the exploration approach allows reading files and creating OpenSpec artifacts when requested. However, it maintains explicit guardrails against writing code or implementing features during the investigation.

When should I not use a structured codebase investigation?

You should not use structured codebase investigation when you need immediate implementation rather than discovery. It is designed for early ideation, requirement clarification, and mid-change troubleshooting, not for writing production features.