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.
Installs into .claude/skills of the current project.
Are you the author of Codebase Scan?
Add the live security badge to your README. It updates with every re-scan.
[](https://www.skillsdirectory.com/skills/digipulse-engineering-codebase-scan)
---
name: codebase-scan
description: 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.
license: ELv2
compatibility: Works with any filesystem-based AI coding agent
metadata:
author: gaai-framework
version: "1.0"
category: cross
track: cross-cutting
id: SKILL-CODEBASE-SCAN-001
updated_at: 2026-02-26
status: stable
inputs:
- repository/**
outputs:
- codebase_tree
- key_files_list
---
# 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.**
