openspec-explore

Clarify ambiguous requirements and investigate codebase questions before implementation.

Updated Nov 29, 2022
One-click install
npx skills add https://github.com/circlebacknever/soundstage --skill openspec-explore-circlebacknever
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-explore
Source: https://github.com/circlebacknever/soundstage/tree/main/.codex/skills/openspec-explore
Command: npx skills add https://github.com/circlebacknever/soundstage --skill openspec-explore-circlebacknever

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you think through ambiguous problems, clarify requirements, and investigate the codebase before committing to a change.

Core Features & Use Cases

  • Requirements discovery: Surface hidden assumptions, open questions, and constraints before work begins.
  • Codebase investigation: Read files, search patterns, and map relevant architecture to understand how a system behaves.
  • Tradeoff analysis: Compare options, sketch alternatives, and identify risks when a decision is not yet obvious.
  • OpenSpec context: Use existing proposals, specs, and tasks to keep exploration grounded in the repository’s current direction.

Quick Start

Ask the openspec-explore skill to help you investigate the problem, map the relevant code, and clarify the requirements before you implement anything.

Frequently Asked Questions about openspec-explore

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

FAQPage Schema
How do I clarify ambiguous requirements before starting codebase implementation?

Clarifying ambiguous requirements involves surfacing hidden assumptions, open questions, and constraints through exploratory discussion before development begins. This approach ensures you fully understand the problem space and map relevant architecture prior to writing any application code.

What is the best way to investigate codebase architecture without modifying application code?

Investigating codebase architecture safely requires read-only analysis of files and search patterns to map system behavior. This strict read-only approach prevents accidental application code changes while you diagnose problems and explore how the system behaves.

How do I analyze tradeoffs and sketch alternatives for a software architecture decision?

Analyzing tradeoffs requires comparing options, sketching alternatives, and identifying risks when a decision is not yet obvious. This process helps you evaluate different architectural paths and ground your exploration in the repository's current direction before committing.

Can I use OpenSpec proposals and specs to plan codebase changes?

Yes, OpenSpec proposals and specs provide context to keep exploration grounded in the repository's current direction. You can use existing proposals, specs, and tasks to guide architecture review and plan changes without modifying application code during the exploration phase.

When should I not use exploratory codebase analysis for requirements discovery?

Exploratory codebase analysis is not suitable when you need to immediately modify application code or implement changes. This approach strictly avoids code changes and focuses solely on read-only file analysis, problem diagnosis, and clarifying requirements before implementation begins.