Profile My skills Saved My plugins Edit profile Submit a skill

Codebase Scan

Create a high-level map of the project structure and identify architectural pillars, entry points, and module boundaries. Activate at Bootstrap initialization or before architecture extraction.

Fr-e-d Updated
Coding & Dev Tools

File contents

Codebase Scan

Purpose / When to Activate

Activate:

  • During Bootstrap initialization (before architecture extraction)
  • When onboarding GAAI onto an existing codebase
  • When the project structure is unknown

Process

  1. Recursively list directories and files
  2. Identify entry points, config files, manifests, and core modules
  3. Highlight likely architecture boundaries
  4. Output a structured project tree and key file list

Outputs

codebase_tree — structured directory tree with annotations for key files

key_files_list — list of significant files: entry points, configs, manifests, core modules, test runners

Quality Checks

  • Repository structure is fully visible
  • Core technical pillars are identified
  • No blind spots remain
  • Output is structured for use by architecture-extract

Non-Goals

This skill must NOT:

  • Interpret architecture decisions (use architecture-extract)
  • Read file contents in depth
  • Make recommendations

Maps the terrain. Does not interpret it.

Fr-e-d/GAAI-framework/tree/main/.gaai/core/skills/cross/codebase-scan commit 513653ff36

Browse category

Frequently asked questions

npx skillmds@latest add fr-e-d/codebase-scan