# Project Analyzer

> Analyze codebase and create CLAUDE.md documentation. Use when analyzing project, understanding codebase, or creating documentation.

- **Type:** Skill
- **Install:** `agentstack add skill-maroffo-claude-forge-project-analyzer`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [maroffo](https://agentstack.voostack.com/s/maroffo)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [maroffo](https://github.com/maroffo)
- **Source:** https://github.com/maroffo/claude-forge/tree/main/skills/project-analyzer

## Install

```sh
agentstack add skill-maroffo-claude-forge-project-analyzer
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

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

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [maroffo](https://github.com/maroffo)
- **Source:** [maroffo/claude-forge](https://github.com/maroffo/claude-forge)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-maroffo-claude-forge-project-analyzer
- Seller: https://agentstack.voostack.com/s/maroffo
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.