reviewing-findings

Reviewing AWS Cost Findings

Multi-perspective review of cost optimization findings with confidence-based filtering.

Quick Start

# Review findings and update findings.json in place
python3 "${CLAUDE_PLUGIN_ROOT}/skills/reviewing-findings/scripts/review_findings.py" findings.json --profile your-profile

# Re-review findings that already carry a review_status
python3 "${CLAUDE_PLUGIN_ROOT}/skills/reviewing-findings/scripts/review_findings.py" findings.json --force

For the detailed per-check confidence matrices and false-positive patterns, read REVIEW_CRITERIA.md in this skill's directory.

Review Process

1. Pre-flight Checks

Skip review if:

• No findings.json exists
• Findings already reviewed (has review_status)
• Empty findings array

2. Multi-Agent Review (4 Parallel Agents)

Launch 4 independent review agents:

Agent #1: Resource Verification
├── Verify resource still exists
├── Check current utilization metrics
└── Confirm finding is still valid

Agent #2: Recommendation Quality
├── Validate recommendation is actionable
├── Check for edge cases (ASG, DR, scheduled)
└── Verify savings calculation logic

Agent #3: Business Context
├── Identify environment (prod/dev/staging)
├── Check for dependencies
└── Flag potential risks

Agent #4: Historical Pattern
├── Check for burst patterns
├── Identify seasonal usage
└── Review recent changes

3. Confidence Scoring

Each agent assigns confidence (0-100):

Score	Meaning
90-100	Definite savings - act immediately
70-89	High confidence - safe to implement
50-69	Medium confidence - needs validation
25-49	Low confidence - likely false positive
0-24	Skip - insufficient evidence

Filter threshold: 50 (adjustable)

4. Update Findings

Add review metadata to each finding:

{
  "check_id": "EC2-001",
  "monthly_savings": 150.00,
  "review_status": {
    "reviewed_at": "2026-01-19T15:00:00Z",
    "final_confidence": 85,
    "agents": {
      "resource_verification": 90,
      "recommendation_quality": 80,
      "business_context": 85,
      "historical_pattern": 85
    },
    "action": "approved",
    "notes": "Resource verified idle for 21 days"
  }
}