analyzing-projects

1# Analyzing Projects
2 
3### When to Load
4 
5- **Trigger**: Onboarding to a new project, "how does this work" questions, codebase exploration, understanding unfamiliar code
6- **Skip**: Already familiar with the project structure and patterns
7 
8## Project Analysis Workflow
9 
10Copy this checklist and track progress:
11 
12```
13Project Analysis Progress:
14- [ ] Step 1: Quick overview (README, root files)
15- [ ] Step 2: Detect tech stack
16- [ ] Step 3: Map project structure
17- [ ] Step 4: Identify key patterns
18- [ ] Step 5: Find development workflow
19- [ ] Step 6: Generate summary report
20```
21 
22## Step 1: Quick Overview
23 
24```bash
25# Check for common project markers
26ls -la
27cat README.md 2>/dev/null | head -50
28```
29 
30## Step 2: Tech Stack Detection
31 
32### Package Managers & Dependencies
33 
34- `package.json` → Node.js/JavaScript/TypeScript
35- `requirements.txt` / `pyproject.toml` / `setup.py` → Python
36- `go.mod` → Go
37- `Cargo.toml` → Rust
38- `pom.xml` / `build.gradle` → Java
39- `Gemfile` → Ruby
40 
41### Frameworks (from dependencies)
42 
43- React, Vue, Angular, Next.js, Nuxt
44- Express, FastAPI, Django, Flask, Rails
45- Spring Boot, Gin, Echo
46 
47### Infrastructure
48 
49- `Dockerfile`, `docker-compose.yml` → Containerized
50- `kubernetes/`, `k8s/` → Kubernetes
51- `terraform/`, `.tf` files → IaC
52- `serverless.yml` → Serverless Framework
53- `.github/workflows/` → GitHub Actions
54 
55## Step 3: Project Structure Analysis
56 
57Present as a tree with annotations:
58 
59```
60project/
61├── src/              # Source code
62…