# AI Analysis Pipeline

> Estrutura e valida pipeline de analise IA para clientes e propostas.

- Skill: `deveclipsy007/ai-analysis-pipeline` (Agent Skill, multi-file: 8 files)
- Install (CLI): `npx skillmds@latest add deveclipsy007/ai-analysis-pipeline`
- Raw SKILL.md: https://api.skillmd.com/api/skills/deveclipsy007/ai-analysis-pipeline/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: deveclipsy007 (https://skillmd.com/u/deveclipsy007)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/deveclipsy007/ai-analysis-pipeline

---


# ai-analysis-pipeline

Skill para evoluir fluxo de analise IA mantendo previsibilidade, custo controlado e fallback.

## Inputs

- `provider`: `claude`, `openai` ou `groq`
- `model_policy`: limites de tokens, temperatura e timeout
- `output_contract`: chaves JSON obrigatorias de analise
- `failure_policy`: estrategia de retry/fallback

## Outputs

- `config/ai.php`
- `src/Services/AiService.php`
- Atualizacoes opcionais em parser/prompt builder

## Fontes do projeto

- `config/ai.php`
- `src/Services/AiService.php`
- `src/Services/AiPromptBuilder.php`
- `src/Services/AiResultParser.php`

## Passo a passo

1. Definir contrato de saida JSON (campos obrigatorios).
2. Ajustar chamada por provider com timeout e tratamento de erro.
3. Manter telemetria minima (`tokens`, `cost`, `processing_time_ms`).
4. Garantir fallback para erro de provider.
5. Validar compatibilidade com status do cliente (`pending/processing/completed/failed`).

## Criterios de aceite

- Erro de API nao quebra fluxo inteiro.
- Saida parseada segue contrato minimo esperado.
- Status da analise e do cliente mantem coerencia de estado.

## Nao faz

- Nao adiciona novo provider sem chave de API configurada.
- Nao envia dados sensiveis para logs sem mascaramento.