codebase-scan

Scan project directory structures and output a tree of key files.

157|28|Updated Feb 7, 2026
One-click install
npx skills add https://github.com/Fr-e-d/GAAI-framework --skill codebase-scan-fr-e-d
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: codebase-scan
Source: https://github.com/Fr-e-d/GAAI-framework/tree/main/.gaai/core/skills/cross/codebase-scan
Command: npx skills add https://github.com/Fr-e-d/GAAI-framework --skill codebase-scan-fr-e-d

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a clear, high-level overview of a project's structure, helping to understand its architecture, identify key components, and define module boundaries, especially when onboarding or analyzing unfamiliar codebases.

Core Features & Use Cases

  • Project Structure Mapping: Generates a detailed tree of directories and files.
  • Key File Identification: Pinpoints entry points, configuration files, manifests, and core modules.
  • Architectural Boundary Highlighting: Suggests where different parts of the architecture might be divided.
  • Use Case: Before starting a major refactor, use this Skill to quickly grasp the existing project layout and identify the most critical files to focus on.

Quick Start

Run the codebase-scan skill to generate a map of the current project structure.

Frequently Asked Questions about codebase-scan

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

FAQPage Schema
How do I map my project directory structure to understand its architecture?

Mapping your project directory structure generates a detailed tree of directories and files, pinpointing entry points, configuration files, manifests, and core modules to help you understand unfamiliar codebases.

When do I need to scan a codebase for module boundaries?

You need to scan a codebase for module boundaries during project onboarding, before a major refactor, or before architecture extraction to quickly grasp the existing project layout and identify critical files.

Can I identify architectural pillars and entry points by scanning a filesystem?

Scanning a filesystem identifies architectural pillars and entry points by analyzing the project directory structure and outputting a structured project tree alongside a list of key files.

Does codebase scanning work for onboarding to unfamiliar codebases?

Codebase scanning works for onboarding to unfamiliar codebases by providing a clear, high-level overview of the project structure to help you identify key components and define module boundaries quickly.

What is the best way to extract a project tree before starting a refactor?

The best way to extract a project tree before a refactor is to run a codebase scan, which highlights architectural boundaries and suggests where different parts of the architecture might be divided.