openspec-explore

Explore codebases and clarify requirements through read-only analysis.

Updated Feb 6, 2024
One-click install
npx skills add https://github.com/081595/mynode --skill openspec-explore-081595
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-explore
Source: https://github.com/081595/mynode/tree/main/myproject/.github/skills/openspec-explore
Command: npx skills add https://github.com/081595/mynode --skill openspec-explore-081595

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Explore mode helps teams and individuals think through ambiguous problems, clarify requirements, and investigate code or design options before any implementation work begins. It prevents premature commitment to solutions by enabling open-ended analysis and visual thinking grounded in repository context.

Core Features & Use Cases

  • Conversational exploration: Ask open questions, surface tradeoffs, and reframe problems without producing production code.
  • Codebase investigation: Read and map relevant files, identify integration points, and surface hidden complexity from the repository.
  • Visualization & decision capture: Produce ASCII diagrams, list risks and open questions, and offer to create OpenSpec artifacts (proposals or designs) when the user requests capture.
  • Use Case: A product manager and engineer jointly brainstorm real-time collaboration approaches, map architecture options, and identify next investigation tasks.

Quick Start

Use the openspec-explore skill to think through adding real-time collaboration to the project, map key tradeoffs, and list open questions and risks.

Frequently Asked Questions about openspec-explore

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

FAQPage Schema
How do I brainstorm architectural tradeoffs before writing any code?

To brainstorm architectural tradeoffs safely, you need a read-only exploration process that maps integration points and surfaces hidden complexity from your codebase without making any code changes. This approach keeps analysis grounded in repository context.

What is the best way to investigate codebase complexity during requirements discovery?

Codebase investigation during requirements discovery involves reading and mapping relevant files to identify integration points and surface hidden complexity. This open-ended analysis prevents premature commitment to solutions by grounding the exploration in actual repository context.

How do I clarify ambiguous product requirements before implementation begins?

Clarifying ambiguous product requirements requires conversational exploration where you ask open questions, surface tradeoffs, and reframe problems. This prevents premature commitment to solutions by enabling open-ended analysis before any implementation work begins.

Can I generate visual diagrams to map design options directly from my repository?

Yes, you can generate visual diagrams to map design options by producing ASCII diagrams during your repository exploration. This visual thinking process is grounded in repository context and helps capture decisions before implementation.

Does exploratory thinking modify my source files when investigating code?

No, exploratory thinking explicitly prohibits making code changes during investigation. It requires read-only access to repository files to ensure that open-ended analysis, brainstorming, and requirements discovery happen safely without altering the codebase.

How do I capture open questions and risks after brainstorming design options?

To capture open questions and risks after brainstorming, you can list them during exploration and offer to create OpenSpec artifacts like proposals or designs when requested. This ensures decision capture follows the visual thinking and analysis phase.