ABOUTME: Automated codebase analysis and CLAUDE.md generation

ABOUTME: Project structure mapping, convention detection, documentation creation

Project Analyzer

Analyzes a codebase via a specialized agent (Haiku) that generates comprehensive CLAUDE.md documentation.

When to Use

• Starting work on a new project
• Need to understand project structure
• Creating/updating project documentation

Agent Invocation

Use the Task tool with:

subagent_type: "project-analyzer"
prompt: "Analyze the project in [directory] and create comprehensive CLAUDE.md documentation"

The agent will:

1. Scan directory structure
2. Identify language and framework
3. Analyze code patterns with ast-grep
4. Detect conventions
5. Generate CLAUDE.md

---

Language Detection

Indicator File	Language/Framework	Key Config Files
go.mod	Go	go.sum, Makefile
pyproject.toml	Python	uv.lock, setup.py, .python-version
Gemfile	Ruby/Rails	Gemfile.lock, config/routes.rb
Package.swift	Swift	*.xcodeproj, *.xcworkspace
build.gradle.kts	Kotlin/Android	settings.gradle.kts, AndroidManifest.xml
package.json	Node/React	next.config.*, tsconfig.json
*.tf	Terraform	*.tfvars, terragrunt.hcl
Cargo.toml	Rust	Cargo.lock
docker-compose.yml	Docker	Dockerfile, .dockerignore

Also check: .gitignore, .env.example, .github/workflows/*.yml, .gitlab-ci.yml, Jenkinsfile

Quality tools: .golangci.yml (Go), ruff.toml (Python), .rubocop.yml (Rails), .eslintrc (JS)

---

Framework Detection

Pattern	Framework
config/routes.rb	Rails
next.config.*	Next.js
angular.json	Angular
nuxt.config.*	Nuxt
fastapi in deps	FastAPI
django in deps	Django
gin or echo in go.mod	Go web
Vapor in Package.swift	Vapor

---

CLAUDE.md Required Sections

• Project purpose (1-2 sentences)
• Tech stack + versions
• Build/test/lint commands
• Architecture overview (directory structure)
• Key conventions and patterns
• Environment setup
• Vault Context (if vault is configured; see _VAULT_CONTEXT.md)

---

Resources

Related Skills:

• Language analysis: _AST_GREP.md
• Go projects: golang/SKILL.md
• Python projects: python/SKILL.md
• Rails projects: rails/SKILL.md
• Terraform: terraform/SKILL.md