Analyze a codebase to generate a comprehensive architecture and structure report. Use when user wants to understand a codebase, explore project structure, or generate analysis.
View on GitHubFebruary 1, 2026
Select agents to install to:
npx add-skill https://github.com/sequenzia/claude-alchemy/blob/main/claude-tools/dev-tools/skills/analyze-codebase/SKILL.md -a claude-code --skill analyze-codebaseInstallation paths:
.claude/skills/analyze-codebase/# Codebase Analysis Workflow Execute a 3-phase codebase analysis workflow. This workflow explores a codebase, analyzes its architecture, and generates a comprehensive report. **CRITICAL: Complete ALL 3 phases.** After completing each phase, immediately proceed to the next phase without waiting for user prompts. ## Phase Overview 1. **Codebase Exploration** - Explore structure, patterns, and dependencies 2. **Deep Analysis** - Analyze findings to identify architecture and patterns 3. **Output & Context Loading** - Present options and deliver results in user's preferred format --- ## Phase 1: Codebase Exploration **Goal:** Thoroughly explore the codebase to gather raw findings. 1. Determine the analysis path: - If `$ARGUMENTS` was provided, use that path - Otherwise, use the current working directory - Inform the user of the scope being analyzed 2. **Launch 3 code-explorer agents in parallel** using the Task tool with `subagent_type: "dev-tools:code-explorer"`: **Agent 1: Project Structure & Configuration** ``` Explore and analyze the project structure and configuration. Path to analyze: [path] Focus on: - Project root structure (directories and their purposes) - Entry points (main files, index files, CLI entry points) - Configuration files (package.json, pyproject.toml, tsconfig.json, etc.) - Build configuration (webpack, vite, rollup, etc.) - Development tools (.eslintrc, .prettierrc, etc.) - CI/CD configuration (.github/workflows, Jenkinsfile, etc.) - Environment configuration (.env.example, config files) Return a structured report of: - Directory structure overview - Key entry points and their purposes - Configuration summary - Build and development tooling ``` **Agent 2: Core Modules & Business Logic** ``` Explore and analyze the core modules and business logic. Path to analyze: [path] Focus on: - Core source directories (src/, lib/, app/) - Key classes, functions, a