Inteligência
Engineering Intelligence
DORA com fórmula e amostra, fluxo de PRs, revisão de código por IA com portão no CI, times, itens de trabalho e eficiência do uso de IA.
#O que faz
Fluxo de PRs, risco de mudança, métricas de entrega e eficiência do uso de IA.
| Funcionalidade | O que faz | Na área logada |
|---|---|---|
| PR flow | PRs por semana, tempo até o merge e PRs abertos, sincronizados do GitHub. | /plataforma/cortex |
| PR review | Leitura do PR por IA, com custo medido e auditoria. | /plataforma/cortex |
| Code Review | Revisão estruturada de PR por IA com regras do time por repositório: achados por arquivo e linha com sugestão, nota de risco por fórmula fixa, revisores sugeridos pelo CODEOWNERS e pelo grafo, portão consultável pelo CI e conferência da política de branch no GitHub. A publicação no PR e a revisão automática são opções à parte. | /plataforma/engenharia/revisao-codigo |
| Delivery metrics | Frequência de implantação e taxa de falha com fórmula e janela, lead time do CI à implantação do mesmo commit, MTTR quando houver dado e achados de segurança abertos por time, com tendência semanal. | /plataforma/engenharia/entrega |
| DORA metrics | Frequência de implantação, taxa de falha de mudança (falha, rollout abortado, volta ou incidente no serviço numa janela configurável), lead time pelo vínculo commit→PR e tempo para restaurar, por serviço, time e workspace, com tendência semanal, retrabalho de PR e gasto de IA lado a lado (correlação, não causa). Fontes: Compute, rollouts do Kubernetes, Cortex e Incidentes da AIUBY, com perfil por workspace do que conta como produção e como falha; implantações de fora da AIUBY não entram. Lead time só quando a revisão ou o rollout informa o commit. | /plataforma/engenharia/dora |
| Teams and goals | Times em árvore com identidade unificada do desenvolvedor (Git, tickets, chat), perfil DORA configurável, itens de trabalho enviados pela API, sprints, esforço por categoria, higiene do backlog, adoção de IA com pesquisa (só em grupo), metas com alerta, painéis, exportação CSV e relatório pela API v1. | /plataforma/engenharia/inteligencia |
| Graph questions | Perguntas em linguagem natural ao grafo de entrega, respondidas só com evidência citada. | /plataforma/engenharia/perguntas |
| AI efficiency | Adoção e gasto de GitHub Copilot, Claude Code (Admin API da Anthropic) e Cursor por time, pelas APIs administrativas oficiais: assentos ociosos com custo desperdiçado e PRs mesclados lado a lado, como correlação, não causa. Visão por pessoa só para owner/admin; sem prompts nem código. O que cada API não entrega aparece como não coletado. | /plataforma/engenharia/adocao-ia |
#Como ativar
- Na área logada: o dono adiciona o Cortex em Produtos (veja Produtos e conta pré-paga). As telas ficam no menu do produto.
- Pela API v1 e pela CLI: a organização precisa do Cortex ativo, de conta de faturamento válida e de uma chave de API ligada ao workspace, com o escopo da rota.
- Adoção e gasto de ferramentas de IA pedem as credenciais administrativas de cada ferramenta (GitHub Copilot, Anthropic, Cursor), na tela.
Nota
404 not_found, como se a rota não existisse. Sem conta de faturamento válida: 402. Veja API v1.#Primeiro uso
curl "https://aiuby.com/api/v1/engineering/dora?days=30" -H "Authorization: Bearer $AIUBY_TOKEN"
aiuby dora --days 30
aiuby insights delivery --days 30
aiuby intel --team plataforma
aiuby ai-efficiencyIndicador sem dado suficiente vem com value: null e o motivo em missing: a API nunca estima.
#Itens de trabalho pela API
Chave com Enviar itens de trabalho (tickets) engineering:ingest. Até 500 itens por envio, de qualquer ferramenta (Jira, Linear ou outra).
curl -X POST https://aiuby.com/api/v1/engineering/work-items \
-H "Authorization: Bearer $AIUBY_TOKEN" -H "Content-Type: application/json" \
-d '{"items":[{"source":"jira","key":"LOJA-42","title":"Novo checkout","type":"feature","status":"in_progress","team":"pagamentos","points":5}]}'type: feature, bug, task, chore, debt, incident ou other.status: open, in_progress, done ou canceled.
#Portão de revisão no CI
curl "https://aiuby.com/api/v1/code-review/check?repo=empresa/api&pr=128&sha=$GITHUB_SHA" -H "Authorization: Bearer $AIUBY_TOKEN"
aiuby code-review check --repo empresa/api --pr 128 --sha "$GITHUB_SHA" # 0 passou; 6 reprovou, incompleta ou sem revisãostatus volta pass, fail, incomplete ou missing (ainda não há revisão desta versão). O sha tem de ser o commit da ponta do PR, com 40 caracteres.
Limite
#Rotas da API
| Rota | Escopo | Para quê | CLI |
|---|---|---|---|
GET /api/v1/engineering/insights/delivery | Ler a engenharia (API v1) engineering:read | Indicadores de entrega | aiuby insights delivery |
GET /api/v1/engineering/dora | Ler a engenharia (API v1) engineering:read | Indicadores DORA | aiuby dora |
GET /api/v1/engineering/ai-efficiency | Ler a engenharia (API v1) engineering:read | Adoção e gasto de ferramentas de IA | aiuby ai-efficiency |
GET /api/v1/engineering/intel | Ler a engenharia (API v1) engineering:read | Inteligência de engenharia por time | aiuby intel |
POST /api/v1/engineering/work-items | Enviar itens de trabalho (tickets) engineering:ingest | Enviar itens de trabalho (tickets) | aiuby work-items push |
GET /api/v1/code-review/reviews | Ler a engenharia (API v1) engineering:read | Revisões de PR por IA | aiuby code-review list |
GET /api/v1/code-review/reviews/{id} | Ler a engenharia (API v1) engineering:read | Uma revisão de PR | aiuby code-review get <id> |
GET /api/v1/code-review/check | Ler a engenharia (API v1) engineering:read | Portão de revisão de um PR (para o CI) | aiuby code-review check |
GET /api/v1/code-review/branch-policy | Ler a engenharia (API v1) engineering:read | Política de branch conferida no GitHub | aiuby code-review branch-policy |
GET /api/v1/code-review/metrics | Ler a engenharia (API v1) engineering:read | Métricas da revisão por IA | aiuby code-review metrics |
#O que ainda não existe
- Pergunta em linguagem natural pela API:
POST /api/v1/engineering/querysó aceita intenção do catálogo fechado e responde 400question_not_supportedparaquestion. A pergunta livre fica na tela. - Número por pessoa pela API: os relatórios são por time e workspace.
- Implantação feita fora da AIUBY no DORA.