openspec-explore

Explore codebases and create OpenSpec artifacts with YAML frontmatter.

14|1|Updated Oct 16, 2024
One-click install
npx skills add https://github.com/factorial-io/scotty --skill openspec-explore-factorial-io
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-explore
Source: https://github.com/factorial-io/scotty/tree/main/.opencode/skills/openspec-explore
Command: npx skills add https://github.com/factorial-io/scotty --skill openspec-explore-factorial-io

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires openspec, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a companion for users to delve into the exploration of ideas, investigation of problems, and clarification of requirements, enhancing the process of conceptualization and problem-solving.

Core Features & Use Cases

  • Exploration Mode: Facilitates in-depth thinking and brainstorming sessions.
  • Codebase Investigation: Allows users to read files, search code, and investigate the codebase without implementing features.
  • OpenSpec Integration: Leverages the OpenSpec system to create and manage proposals, designs, and specs.
  • Visual Tools: Utilizes ASCII diagrams and other visual aids to clarify complex ideas.
  • Adaptive Workflow: Tailors the exploration process based on user input and emerging insights.

Quick Start

Enter explore mode with the command: openspec explore

Frequently Asked Questions about openspec-explore

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

FAQPage Schema
How do I brainstorm and explore software requirements before writing code?

To explore software requirements before implementation, you can use an interactive thinking partner to investigate your codebase, brainstorm ideas, and clarify concepts without writing features. This deep dive process helps solidify designs and specs prior to development.

Can I investigate and search my codebase without automatically generating code changes?

Yes, you can investigate your codebase by reading files and searching code without implementing features. This read-only exploration mode allows you to analyze existing logic and architecture safely while brainstorming or clarifying requirements.

Do I need the openspec CLI to create and manage design proposals?

Yes, the openspec CLI is a required dependency to create and manage OpenSpec artifacts like proposals, designs, and specs. You must have this command-line tool installed to leverage the full proposal generation and management workflow.

What is the best way to visualize complex ideas and software architecture during brainstorming?

The best way to visualize complex ideas during brainstorming is using ASCII diagrams and visual aids. These tools help clarify intricate software architecture and requirements directly within your text editor or terminal environment.

How do I start an exploration session for problem-solving and requirement clarification?

To start an exploration session for problem-solving, enter explore mode with the command `openspec explore`. This initiates the adaptive workflow, tailoring the deep thinking and brainstorming process based on your input and emerging insights.

Are there limitations when using YAML frontmatter for configuration in codebase investigation?

Configuration for codebase investigation and exploration relies on YAML-based frontmatter, which requires strict syntax adherence. While this format supports adaptive workflows, malformed YAML will prevent the tool from properly reading your exploration parameters.