openspec-explore

Explore codebases and clarify requirements without modifying code.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enter explore mode to act as a thinking partner for exploring ideas, investigating problems, and clarifying requirements. You may read files, search code, and investigate the codebase, but you must NEVER write code or implement features. If the user asks you to implement something, remind them to exit explore mode first and create a change proposal. You MAY create OpenSpec artifacts (proposals, designs, specs) if the user asks—that's capturing thinking, not implementing.

Core Features & Use Cases

  • Thinking partner: surface questions, edges, and multiple directions without prescribing a single path.
  • Codebase grounding: read context and diagrams to map dependencies and risks.
  • Visualization: generate ASCII diagrams and decision surfaces to aid exploration.

Use Case: You’re helping a developer understand a tricky requirement by asking clarifying questions and proposing exploration paths, without modifying the codebase.

Quick Start

Describe your exploration goal and context, and let OpenSpec guide the discussion by asking questions, visualizing ideas, and surfacing options.

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 and explore ideas without modifying the codebase?

To clarify requirements without modifying the codebase, use a thinking partner approach that reads context, poses clarifying questions, and surfaces options. This prevents code changes while mapping dependencies and risks during early discovery.

What is the best way to investigate codebase dependencies during early discovery?

The best way to investigate codebase dependencies during early discovery is by reading context and diagrams to map dependencies and visualize risks. This codebase grounding approach aids exploration by generating ASCII diagrams and decision surfaces.

How do I frame problems and surface multiple directions without prescribing a single path?

To frame problems and surface multiple directions without prescribing a single path, enter an exploration mode that acts as a thinking partner. This approach surfaces questions, edges, and options while preventing code edits, focusing entirely on requirement clarification.

Can I create OpenSpec proposals and designs while exploring requirements?

Yes, you can create OpenSpec proposals, designs, and specs while exploring requirements. This is considered capturing thinking rather than implementing code, so it is fully allowed even when code changes are strictly prevented.

When should I not use an exploration approach for requirement clarification?

You should not use this exploration approach when you need to implement features or write code. If the user asks to implement something, they must exit explore mode first and create a change proposal to proceed with actual coding tasks.

Does OpenSpec explore mode support generating visualizations for complex problems?

Yes, OpenSpec explore mode supports generating visualizations for complex problems. It generates ASCII diagrams and decision surfaces to aid exploration, helping teams visualize ideas and map dependencies while acting as a thinking partner.