openspec-explore

Explore ideas and investigate codebases as a thinking partner before creating OpenSpec change proposals.

Updated Jul 1, 2025
One-click install
npx skills add https://github.com/mosakuzii0216/mosaku-v1 --skill openspec-explore-mosakuzii0216
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-explore
Source: https://github.com/mosakuzii0216/mosaku-v1/tree/main/.claude/skills/openspec-explore
Command: npx skills add https://github.com/mosakuzii0216/mosaku-v1 --skill openspec-explore-mosakuzii0216

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams often jump into implementation before fully understanding a problem, leading to rework and misaligned requirements. This Skill provides a structured explore mode where the AI acts as a thinking partner—investigating the codebase, visualizing options with ASCII diagrams, and clarifying requirements—without writing any implementation code. ## Core Features & Use Cases - Exploration stance: Asks open questions, challenges assumptions, compares options with tradeoff tables, and visualizes architectures using ASCII diagrams. - OpenSpec integration: Reads project context via the openspec CLI, scaffolds new changes with openspec new change, and captures decisions into proposals, designs, specs, and task artifacts. - Guardrails against premature coding: Never implements features during exploration; offers to capture insights into OpenSpec artifacts only when the user decides. - Use Case: A developer considering real-time collaboration can explore the spectrum from presence indicators to CRDTs, review the existing codebase for integration points, and then crystallize the outcome into a change proposal. ## Quick Start Ask the AI to enter explore mode to think through adding a new feature, investigate a messy subsystem, or compare design options before creating an OpenSpec change proposal.

Frequently Asked Questions about openspec-explore

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

FAQPage Schema
How do I explore a feature idea before writing code?

Enter explore mode and describe your idea in natural language. The AI investigates the codebase, asks clarifying questions, sketches ASCII diagrams of options, and helps crystallize requirements before you commit to a change proposal.

How do I create an OpenSpec change proposal from an exploration?

Ask to capture the exploration as a change. The skill runs openspec new change to scaffold the change, then follows status and instructions commands to create requested artifacts like proposal.md, design.md, and specs in dependency order.

Can explore mode write or modify application code?

No. Explore mode explicitly forbids implementing features or writing application code. It may only read files, search code, and create OpenSpec artifacts such as proposals, designs, and specs when requested.

Does openspec-explore require the openspec CLI installed?

Yes. The skill depends on the openspec CLI for commands like list, status, instructions, and new change. Without it, OpenSpec-aware context checks and artifact scaffolding cannot run.

What is a store in OpenSpec and how does explore mode handle it?

A store is a standalone OpenSpec repository registered on the machine. The skill discovers stores with openspec store list --json and appends --store <id> to subsequent read and write commands for the rest of the workflow.