Systematic Exploration

Structure unfamiliar codebase investigations into briefs, maps, and findings reports.

54|7|Updated Sep 19, 2021
One-click install
npx skills add https://github.com/Vrooli/Vrooli --skill systematic-exploration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Systematic Exploration
Source: https://github.com/Vrooli/Vrooli/tree/main/scenarios/prompt-manager/store/skills/packs/core/systematic-exploration
Command: npx skills add https://github.com/Vrooli/Vrooli --skill systematic-exploration

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Helps teams quickly understand unfamiliar code by guiding them through structured scope, mapping, understanding, validation, and synthesis phases so investigations never drift or miss critical constraints.

Core Features & Use Cases

  • Phase-driven methodology: Defines entry criteria, mapping actions, understanding hypotheses, validation steps, and synthesis expectations for repeatable exploration.
  • Artifacts and deliverables: Requires an exploration brief, structural map, and findings report that document key components, conventions, constraints, risks, and implementation entry points.
  • Real-world use case: Onboard onto a new subsystem, align multiple agents before implementation, or assess architectural constraints for cross-cutting changes.

Quick Start

Start by writing down your investigation question, entry points, and boundaries so you can follow the scope phase before reading any code.

Frequently Asked Questions about Systematic Exploration

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

FAQPage Schema
What is a systematic codebase exploration methodology?

A systematic codebase exploration methodology structures unfamiliar code investigations through defined scope, mapping, understanding, validation, and synthesis phases to prevent aimless reading and missed constraints.

How do I investigate an unfamiliar subsystem before making cross-cutting changes?

Investigate an unfamiliar subsystem by creating an exploration brief with entry points and boundaries, then mapping structural components, conventions, and risks before planning implementation.

What's the best way to onboard a team onto a new codebase?

Onboard a team onto a new codebase by applying a phase-driven methodology that produces structural maps and findings reports, documenting key components and constraints to align multiple agents.

How do I document codebase analysis findings for downstream planning?

Document codebase analysis findings by generating a structured findings report that captures components, conventions, constraints, risks, and implementation entry points for downstream planning.

When do I need a structured investigation plan for codebase analysis?

You need a structured investigation plan for codebase analysis when teams must onboard onto unfamiliar subsystems, align multiple agents, or assess architectural constraints before implementation.

What deliverables should a codebase exploration plan produce?

A codebase exploration plan should produce an exploration brief, a structural map, and a findings report documenting key components, conventions, constraints, risks, and implementation entry points.