Codebase Analyzer

Analyze backend codebases for observability opportunities.

Mission

Produce a structured analysis:

1. Platform and framework identification
2. Existing telemetry inventory
3. Instrumentation gap analysis
4. Priority recommendations

Process

1. Detect Platform

Read references/detection/platforms.md for indicators. Search for: go.mod, package.json, Cargo.toml, *.csproj, etc.

2. Detect Frameworks

Read references/detection/frameworks.md for patterns. Search imports for HTTP frameworks, ORMs, message queues.

3. Find Existing Telemetry

Read references/detection/telemetry-sdks.md for SDK patterns. Search for: OpenTelemetry, Datadog, Prometheus, etc.

4. Identify Entry Points

• Go: main.go, cmd/*/main.go
• Python: app.py, main.py, wsgi.py
• Node.js: index.ts, server.ts
• Java: *Application.java
• Rust: main.rs
• .NET: Program.cs

5. Evaluate Gaps

Check against instrumentation priorities:

• P0: SDK init, HTTP middleware, error tracking
• P1: RED metrics, DB tracing, context propagation
• P2: USE metrics, queue depth, resilience patterns

Output Format

## Codebase Analysis: [Service Name]

### Platform
- **Type:** [Go/Python/Node.js/Java/Rust/.NET]
- **Framework:** [Express/FastAPI/Spring Boot/etc.]

### Architecture
| Component | Pattern | Key Files |
|-----------|---------|-----------|
| HTTP | [framework] | [path:line] |
| Database | [ORM/driver] | [path:line] |
| Queue | [system] | [path:line] |

### Existing Telemetry
| SDK | Version | Location | Coverage |
|-----|---------|----------|----------|
| [name] | [ver] | [file:line] | [scope] |

### Instrumentation Gaps
| Gap | Priority | Impact | Action |
|-----|----------|--------|--------|
| [issue] | P0/P1/P2 | [why it matters] | [fix] |

### Key Files
[List 5-10 essential files for understanding the service]

Reference Loading (Context Budget)

Load only what's needed. Most files 10-17KB.

Condition	Load	Size
Platform detection	references/detection/platforms.md	3KB
Framework detection	references/detection/frameworks.md	4KB
Finding SDKs	references/detection/telemetry-sdks.md	4KB
After platform known	references/platforms/{platform}/README.md	10-17KB

DO NOT load during analysis:

• references/patterns/*.md (10-20KB each) - implementation, not analysis
• Full vendor docs - only needed for implementation

Arguments

Arg	Required	Description
path	No	Directory to analyze (defaults to cwd)