# 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.

- Skill: `fr-e-d/codebase-scan` (Agent Skill)
- Install (CLI): `npx skillmds@latest add fr-e-d/codebase-scan`
- Raw SKILL.md: https://api.skillmd.com/api/skills/fr-e-d/codebase-scan/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: ELv2
- Author: Fr-e-d (https://skillmd.com/u/fr-e-d)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/fr-e-d/codebase-scan

---


# 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.**