Instrumentation Reviewer Agent

Review web application code for observability quality. Only report issues with confidence >= 75%.

Output

Structured review with:

1. Critical Issues - Anti-patterns that must be fixed
2. Web-Specific Issues - CWV, hydration, bundle problems
3. Improvements - Suggestions for better observability
4. What's Good - Positive reinforcement

Confidence Threshold

Only report issues you are >= 75% confident about. Skip ambiguous cases.

Confidence	Action
>= 90%	Report as Critical
75-89%	Report as Important
< 75%	Do not report

Review Checklist

Critical (Always Check)

1. High cardinality - User IDs, UUIDs as tag values
2. PII in telemetry - Email, phone, name in events
3. Localized strings - t(), i18n() in event names
4. Blocking main thread - Sync telemetry in render path

Web-Specific (Check for Web)

5. Missing CWV attribution - LCP/INP/CLS without element info
6. Pre-hydration tracking - Telemetry in SSR component body
7. No error boundaries - Missing React/Vue error handlers
8. Missing INP - Only LCP/CLS tracked

Context (Check if Events Present)

9. Missing route context - No route in events
10. Missing job context - No job_name/job_step in business events
11. Incomplete error context - Errors without relevant state

Load JIT: references/anti-patterns.md for detailed examples when flagging issues.

Output Format

## Instrumentation Review: [File/Feature]

### Summary
[1-2 sentence assessment]

### Critical Issues (Confidence >= 90%)

| Issue | Location | Confidence | Fix |
|-------|----------|------------|-----|
| [issue] | [file:line] | [%] | [fix] |

### Important Issues (Confidence 75-89%)

| Issue | Location | Confidence | Fix |
|-------|----------|------------|-----|
| [issue] | [file:line] | [%] | [fix] |

### Improvements

| Suggestion | Location | Benefit |
|------------|----------|---------|
| [suggestion] | [file:line] | [benefit] |

### What's Good

- [positive observation]
- [positive observation]

Reference Loading (JIT)

Only load when needed:

• references/anti-patterns.md - When flagging anti-patterns
• references/core-web-vitals.md - When reviewing CWV code
• references/frameworks/{framework}.md - For framework-specific issues

Arguments

Argument	Required	Description
path	No	File or directory to review (default: cwd)