sdd-explore

Investigates codebases and compares implementation approaches for spec-driven development exploration.

Updated Aug 25, 2026
One-click install
npx skills add https://github.com/CarlosWilliamsR/SketchOS --skill sdd-explore-carloswilliamsr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sdd-explore
Source: https://github.com/CarlosWilliamsR/SketchOS/tree/main/.config/opencode/skills/sdd-explore
Command: npx skills add https://github.com/CarlosWilliamsR/SketchOS --skill sdd-explore-carloswilliamsr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Before committing to a code change, teams need a structured analysis of the current codebase, affected files, and viable approaches. This Skill performs that exploration phase of spec-driven development (SDD), returning a consistent, structured report instead of ad-hoc investigation notes. ## Core Features & Use Cases - Codebase Investigation: Reads entry points, related functionality, tests, and dependencies to map current architecture and affected files. - Approach Comparison: Compares multiple implementation options with pros, cons, and effort estimates in a standardized table. - Structured Artifact Output: Produces a fixed-format exploration report (current state, affected areas, approaches, recommendation, risks) and optionally persists it as exploration.md via engram, openspec, hybrid, or none storage modes. - Use Case: An orchestrator agent receives a feature request, delegates to this sub-agent, and gets back a concise analysis stating which files are affected, two or three candidate approaches, a recommendation, and whether the topic is ready for a formal proposal. ## Quick Start Ask the orchestrator to explore how a new feature would fit into the current codebase before writing a proposal.

Frequently Asked Questions about sdd-explore

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

FAQPage Schema
How do I explore a codebase before starting a spec-driven development change?

Delegate the topic to the sdd-explore sub-agent with a feature description and storage mode. It reads relevant code, compares approaches, and returns a structured exploration report covering current state, affected files, and a recommendation.

What does the SDD exploration phase produce?

It produces a markdown report with sections for current state, affected areas, approach comparisons with pros and cons, a recommendation, risks, and a ready-for-proposal verdict. When tied to a named change, the same content is saved as exploration.md.

Can sdd-explore modify code during investigation?

No. The skill is strictly read-only regarding existing code. The only file it may create is exploration.md inside the change folder when a change name is provided; all other files remain untouched.

What artifact storage modes does sdd-explore support?

It supports four modes: engram (persist to an Engram store under sdd/{change-name}/explore), openspec (follow the openspec convention files), hybrid (both), and none (return the analysis to the orchestrator without persistence).

When should exploration be skipped in an SDD workflow?

Exploration adds little value when the change is trivial, the affected code is already well understood, or requirements are fully specified. It is most useful for new features, refactors, or ambiguous requests needing clarification before a proposal.