openspec-explore

Guide codebase exploration and problem framing with ASCII diagrams.

Updated Jul 26, 2025
One-click install
npx skills add https://github.com/0serna/dotfiles --skill openspec-explore-0serna
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-explore
Source: https://github.com/0serna/dotfiles/tree/main/dotfiles/agents/skills/openspec-explore
Command: npx skills add https://github.com/0serna/dotfiles --skill openspec-explore-0serna

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a structured approach to thinking through ideas and clarifying requirements without making or writing code, acting as a thinking partner that helps users explore problems deeply while preserving safety.

Core Features & Use Cases

  • Stance: Curious and adaptive guidance that surfaces multiple directions instead of prescribing a single path.
  • Visualize: ASCII diagrams and system maps to explain ideas and relationships.
  • Guider: Helps surface risks, unanswered questions, and design spaces, while respecting guardrails and not implementing changes.
  • Artifacts: May generate OpenSpec artifacts if asked, while avoiding actual code changes.

Quick Start

At activation, begin by stating the current exploration goal and ask clarifying questions to frame the problem.

Frequently Asked Questions about openspec-explore

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

FAQPage Schema
How do I explore codebase changes before writing any code?

To explore codebase changes safely, use a thinking partner that guides problem framing and surfaces risks without implementing modifications. It helps you visualize system relationships and clarify requirements through structured exploration before committing to actual development.

What is the best way to visualize system architecture during early design?

The best way to visualize system architecture during early design is using ASCII diagrams and system maps. These visual tools explain component relationships and surface design questions, allowing you to explore multiple directions without prescribing a single path.

Can I generate OpenSpec artifacts without modifying my source code?

Yes, you can generate OpenSpec artifacts without modifying source code. The exploration process enforces non-implementation guardrails, ensuring it only produces documentation artifacts while strictly preventing any actual code changes.

How do I surface unanswered questions and risk surfaces in my project?

You surface unanswered questions and risk surfaces by applying adaptive guidance that frames problems deeply. This approach identifies potential risks and explores design spaces systematically, acting as a curious guide rather than prescribing solutions.

Does this codebase exploration approach support generating visual diagrams?

Yes, this codebase exploration approach supports generating visual diagrams. It utilizes ASCII diagrams and system maps to explain ideas and relationships, helping you understand structural connections while thinking through potential changes.

When should I not use a code-writing approach for exploring ideas?

You should not use a code-writing approach when you need to clarify requirements and frame problems safely. If your goal is deep exploration of design spaces and surfacing options without committing changes, a non-implementation thinking partner is the correct choice.