🗺️
AutomationShell

Codebase Scan

by Fr-e-d

Codebase Scan is an Automation skill for Claude Code, published by Fr-e-d in GAAI-framework.

161 stars27 forkson Fr-e-d/GAAI-frameworkAdded 2026/09/08Repository updated 2026/09/04
agentic-codingai-agentsai-codingai-developer-toolsai-governanceai-memory-systemautonomous-agentsclaude-codecodex-clicontext-engineeringcursordevtoolsgemini-cliopencodevibe-codingwindsurf
Install in seconds
Install Codebase Scan
Copy Codebase Scan into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.
terminal
npx degit https://github.com/digipulse-engineering/GAAI-framework/tree/main/.gaai/core/skills/cross/codebase-scan ~/.claude/skills/codebase-scan

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/digipulse-engineering/GAAI-framework.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file
.gaai/core/skills/cross/codebase-scan/SKILL.md in Fr-e-d/GAAI-framework
Installs to
~/.claude/skills/codebase-scan
Collection
One of 25 skills cataloged from this repository
Category
Automation2226 skills

What Codebase Scan does

Codebase Scan creates a high-level map of a project’s directories, entry points, configs, and core modules. Use it during bootstrap or onboarding before deeper architecture extraction.

Codebase Scan is cataloged under Automation on DirSkills. Codebase Scan comes from a repository tagged agentic-coding, ai-agents, ai-coding, ai-developer-tools and ai-governance.

Documentation

README

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

This is the opening of the README. Read the full README on GitHub.

Frequently asked about Codebase Scan

  • What else does Fr-e-d publish alongside Codebase Scan?

    Codebase Scan is one of 25 skills that DirSkills catalogs from Fr-e-d/GAAI-framework, the repository it ships in. Its siblings there include Abort-Safe Handler, Ambiguity Detector and Approach Evaluation. Each one is a separate skill with its own page in this directory, installs the same way Codebase Scan does, and is maintained by Fr-e-d in that same repository. The rest of the collection is listed on the Fr-e-d/GAAI-framework page.

  • How does Codebase Scan compare to other Automation skills?

    Codebase Scan ranks #2084 by stars among the 2226 Automation skills in this catalog. The most-starred ones next to it are Autonomous Loops, Autonomous Agent Harness and Automation Audit Ops. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of Codebase Scan against them. Open each page to compare what they document and how they install.

More from Fr-e-d/GAAI-framework

Codebase Scan is one of 25 skills cataloged on DirSkills from Fr-e-d/GAAI-framework.

See all 25 skills
🛑
1h ago

Abort-Safe Handler

Abort-Safe Handler decides whether `/gaai:bootstrap` enters the Q&A loop or skips it. It returns a unified abort-safe result with telemetry and prevents partial state when the user skips or aborts.
Automation
16127
🔎
1h ago

Ambiguity Detector

Ambiguity Detector scores project ambiguity from surface scans, optional open-question synthesis entries, and optional AST signals. It produces structured ambiguity_feed entries for the Q&A stage without making LLM calls.
AI Engineering
16127
⚖️
1h ago

Approach Evaluation

Approach Evaluation researches viable options for a technical or architectural decision and compares them against project constraints. Use it when multiple approaches exist and you need a factual, structured comparison without making the decision.
AI Engineering
16127
🏗️
1h ago

Architecture Extract

Architecture Extract turns a scanned codebase into a concise view of module boundaries, data flows, service relationships, and the architectural pattern. Use it during bootstrap before memory ingestion.
AI Engineering
16127
🧠
1h ago

Bootstrap LLM Synthesis

Bootstrap LLM Synthesis constructs a prompt from project scans, optional tree-sitter context, and Q&A answers, then calls an LLM to produce validated memory entries. Use it in Stage 3 of the /gaai:bootstrap pipeline when raw project signals need to be distilled into structured, traceable notes.
AI Engineering
16127
🗂️
1h ago

Build Agents Index

Build Agents Index scans agent and sub-agent frontmatter plus specialists.registry.yaml, then writes a derived agents-index.yaml. Use it after adding, changing, or removing agent, sub-agent, or specialist entries.
Automation
16127