sg-explore

Generate a codebase structure map by invoking gsd-map-codebase.

2|Updated May 15, 2026
One-click install
npx skills add https://github.com/gyuha/super-gsd --skill sg-explore
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sg-explore
Source: https://github.com/gyuha/super-gsd/tree/main/skills/sg-explore
Command: npx skills add https://github.com/gyuha/super-gsd --skill sg-explore

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It removes the guesswork of understanding where things live in a repository by generating a clear map and analysis of the current codebase structure.

Core Features & Use Cases

  • Codebase mapping: Invokes gsd-map-codebase to analyze and document project layout.
  • Stage-aligned discovery: Fits into the GSD → Superpowers → sg-retro loop as the “explore” step before planning.
  • Use Case: You are starting a new milestone and need to quickly find entry points, key modules, and relevant files so you can plan efficiently.

Quick Start

Run sg-explore to map and analyze the current codebase structure.

Frequently Asked Questions about sg-explore

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

FAQPage Schema
How do I generate a codebase structure map for repository analysis?

To generate a codebase structure map for repository analysis, run the sg-explore command. It invokes gsd-map-codebase exactly once to analyze and document the project layout, returning a clear map of key modules and entry points.

What is the best way to map a codebase before starting a new milestone?

Mapping a codebase before starting a new milestone is best handled by running sg-explore. It delegates execution to gsd-map-codebase to remove the guesswork of understanding where things live, providing the repository understanding needed to plan efficiently.

How do I find key modules and entry points in an unfamiliar codebase?

To find key modules and entry points in an unfamiliar codebase, use sg-explore. It generates a clear map and analysis of the current project structure by invoking gsd-map-codebase, helping you quickly locate relevant files.

Do I need to provide arguments to run gsd-map-codebase for project documentation?

No, you do not need to provide arguments to run gsd-map-codebase for project documentation. The sg-explore skill fulfills the requirement to run gsd-map-codebase exactly once with no arguments to generate the codebase analysis.

When do I need codebase mapping in the GSD planning loop?

You need codebase mapping in the GSD planning loop as the explore step before planning tasks. It fits into the GSD → Superpowers → sg-retro loop, providing repository understanding required to support subsequent planning activities.

Does sg-explore work as a standalone Claude Code plugin or does it delegate execution?

sg-explore works as a Claude Code plugin that delegates execution entirely. It invokes gsd-map-codebase to perform the actual repository analysis and codebase mapping, acting as a wrapper to fulfill the specific execution requirement.