core-analysis-loop

Observabilidade — Core Analysis Loop

Quando usar

LLM carrega esta skill ao investigar incidente, debugar comportamento de produção, ou validar hipótese sobre sistema. Trigger phrases:

• "investigar incidente", "debugar produção"
• "qual a causa raiz", "root cause analysis"
• "core analysis loop"
• "debug from first principles"
• "alerta disparou — onde começo?"
• "SLO burn — como descobrir o que quebrou?"

Regras absolutas

• Hipóteses vêm de DADOS, não intuição — você não precisa conhecer o sistema. Comece com query SELECT * WHERE result.success = false LIMIT 10 e itere.
• NUNCA chute "deve ser X" — toda hipótese é validada com query antes de aceitar. Se você está confiante mas não verificou, pare e verifique.
• GROUP BY iterativo — sempre comece amplo e estreite. Erro 5xx → group by error.type → group by tenant_id → group by endpoint → root cause.
• Cardinalidade alta é sua amiga — debug por user_id específico é só possível se você instrumentou alta cardinalidade (skill structured-events).
• Documente a trilha — cada hipótese, query, resultado, próxima hipótese. incident-investigator salva em .planning/investigations/<id>.md.
• Pare quando achar root cause — não vá além. "Tenant X em endpoint Y excedeu rate limit" é root cause; o "porquê tenant X excedeu" é um próximo loop separado.
• Refute hipóteses agressivamente — busque evidência CONTRA, não A FAVOR. Bias de confirmação é o inimigo.
• Não confie em dashboards — eles foram criados para problemas conhecidos. Você está investigando algo emergente.

As 4 fases do Core Analysis Loop

┌────────────────────────────────────────────────────────────────┐
│                                                                │
│   ┌──────────────────┐                                         │
│   │ 1. SINTOMA       │  Algo está errado (alerta, complaint,   │
│   │                  │  SLO burn, métrica anômala)             │
│   └────────┬─────────┘                                         │
│            ↓                                                   │
│   ┌──────────────────┐                                         │
│   │ 2. HIPÓTESE      │  Olhar para os DADOS (não intuição):    │
│   │    DE DADOS      │  query inicial ampla; ver o que aparece │
│   └────────┬─────────┘                                         │
│            ↓                                                   │
│   ┌──────────────────┐                                         │
│   │ 3. VALIDAÇÃO     │  Refinar com GROUP BY + WHERE.          │
│   │    POR QUERY     │  Tem evidência? Sim → próxima hipótese  │
│   └────────┬─────────┘  Não → volta para 2 com hipótese nova   │
│            ↓                                                   │
│   ┌──────────────────┐                                         │
│   │ 4. ITERAR        │  Foi para 2 (refinou hipótese)          │
│   │    OU PARAR      │  ou parar (achou root cause)            │
│   └──────────────────┘                                         │
│                                                                │
└────────────────────────────────────────────────────────────────┘