ai-integration-architect · diff

git:20260516.e5a0f4a to git:20260524.b9d0bd2

18 added, 0 removed. Audit A to A.

---

name: ai-integration-architect

description: |

Skill para desenhar e implementar integracoes de IA em aplicacoes, separando provider, adapter, hooks,

observabilidade, custo e seguranca. Use quando o usuario quiser adicionar texto, imagem ou video ao app.

---

# AI Integration Architect

O AI Integration Architect usa os patterns de `patterns/ai-integration/` para implementar features de IA em apps sem improvisar arquitetura toda vez.

## Governanca Global

Esta skill segue `GLOBAL.md`, `policies/execution.md`, `policies/handoffs.md`, `policies/quality-gates.md`, `policies/token-efficiency.md`, `policies/tool-safety.md`, `policies/evals.md`, `policies/stack-flexibility.md` e `policies/mcp-builder-patterns.md` (quando recomendar/criar MCP server para integrar serviço externo).

## Quando Usar

- integrar geracao de texto no app

- integrar geracao ou edicao de imagem no app

- integrar video generativo no app

- definir adapters, hooks, schemas, custo e observabilidade de IA

## Quando Nao Usar

- para gerar um asset visual isolado durante o trabalho do kit

- para substituir `Image Generator`, que e uma skill operacional separada

## Entradas Esperadas

- caso de uso do app

- stack real do projeto

- provider ou gateway desejado

- requisitos de UX, custo, seguranca e observabilidade

## Saidas Esperadas

- arquitetura de integracao de IA clara

- hooks ou adapters sugeridos

- handoff para Backend, Frontend, Data Analytics ou Observability SRE

## Base Obrigatoria

Antes de decidir a arquitetura, consultar:

- `patterns/ai-integration/README.md`

- `patterns/ai-integration/providers.md`

- `patterns/ai-integration/hooks.md`

- `patterns/ai-integration/prompt-patterns.md`

- `patterns/ai-integration/cost-efficiency.md`

- `patterns/ai-integration/security.md`

## Evidencia de Conclusao

- provider/gateway escolhido com justificativa

- adapters e hooks mapeados

- custo, seguranca e observabilidade considerados

## Handoff

Seguir `policies/handoffs.md` e, quando util, `templates/ai-integration-plan.md`.

+ ## Docs upstream via submodule (v2.12.2+, opt-in)

+ Esta skill pode usar o `anthropics/anthropic-cookbook` como fonte de exemplos vivos via git submodule. Por padrao **nao esta inicializado** (evita ~100MB de clone obrigatorio). Para ativar:

+ ```bash

+ git submodule init skills/25-ai-integration-architect/sources/anthropic-cookbook

+ git submodule update --remote --depth=1

+ ```

+ Quando ativo, os exemplos em `./sources/anthropic-cookbook/anthropic_api/` ficam em sync com o repo upstream. Pra atualizar:

+ ```bash

+ git submodule update --remote skills/25-ai-integration-architect/sources/anthropic-cookbook

+ git add . && git commit -m "chore: bump anthropic-cookbook submodule"

+ ```

+ Pattern documentado em [`docs/patterns/submodule-skills.md`](../../docs/patterns/submodule-skills.md). Inspirado em [antfu/skills](https://github.com/antfu/skills) (MIT).