Iteração 03 — Release Notes¶

Período: Maio a Junho de 2026
Marco: Plataforma Observável & Resiliente — previsão 30/06/2026

Resumo¶

A Iteração 03 foca em três eixos: maturidade operacional (observabilidade de LLMs, dashboard Grafana e contingência automática), governança do projeto (simplificação de papéis RBAC, rastreabilidade de issues e status de implementação) e fechamento da construção (Fábrica de Código, ajuste fino de prompts de testes e integração com TFS).

Ao final desta iteração, a plataforma AMia estará operacionalmente madura — com métricas de LLM em tempo real, alertas de latência, modo de contingência automático entre Anthropic e Gemini, e visibilidade completa do status de implementação das stories diretamente no Portal.

Funcionalidades Entregues¶

Epic 1 — Foundation & Planning¶

Feature	Status	Entrega
F1.10 — Simplificação de Papéis RBAC	✅ Concluída	Remoção do papel PM; papel único por projeto; GP como administrador com bypass de edição de specs; restrição de gestão de equipe ao GP; GP atribuído automaticamente ao criador do projeto; aba Equipe somente leitura para não-GP no Portal

Epic 2 — Specification & Planning¶

Feature	Status	Entrega
F2.3 — Saída Manual de Work Items para ADO	✅ Concluída	Botão "Copiar para Azure DevOps" no Portal para exportação manual de Work Items
F2.4 — Agente ANR	✅ Concluída	Novo agente Python ANR; remoção de `test_scenarios` dos agentes geradores de specs

Epic 3 — Construction & Quality¶

Feature	Status	Entrega
F3.1 — Fábrica de Código (fechamento)	✅ Concluída	Tools MCP de Plano de Codificação; melhorias de prompt em `implement_story` e `coding`
F3.2 — Estratégia de Testes — Prompts	✅ Concluída	Remoção de ISTQB dos prompts de `unit_testing` e `integration_testing`; consulta de testes existentes antes de criar; Gherkin no plano de `e2e_testing`; `test_story` registrando Gherkin; prompt reviewer de cobertura
F3.4 — ADO como Fonte de WI (MCP + Core)	✅ Concluída	Stories MCP pendentes de fechamento
F3.5 — TFS como Fonte de Work Items	✅ Concluída	Extensão `WorkItemSource` para TFS no Core; endpoint de credenciais TFS; resource `tfs-cli` no MCP Server; script `amia-tfs-cli` via REST API v6.0; tool `get_tfs_credentials_tool`; roteamento TFS nos prompts CLI; Guia de Onboarding para Times TFS

Epic 4 — Observability & Resilience¶

Feature	Status	Entrega
F4.3 — Dashboard Grafana	✅ Concluída	Datasource Elasticsearch configurado no Grafana; Dashboard "AMia — LLM Operations" com painéis de saúde, latência e tokens; alertas de limiar de latência
F4.1 — Migração LLM + Contingência	📅 Planejada	Migração do modelo primário para Anthropic Claude; proxy de contingência automático para Gemini; histórico de auditoria de troca de modelo; banner de status de LLM no Portal
F4.2 — Coleta de Métricas LLM	✅ Concluída	Callback handlers de métricas LangChain; envio de spans e métricas para Elasticsearch
F4.4 — Auto-Trigger de Contingência	📅 Planejada	Lógica de contingência automática ativada por alertas Grafana via webhook; endpoint de hot-reload de modelo no Core

Epic 5 — Rollout & Adoption¶

Feature	Status	Entrega
F5.1 — Engenharia Reversa (fechamento)	✅ Concluída	Priorização de READMEs na análise de repositório (story 6)
F5.3 — Documentação com MkDocs	✅ Concluída	4 stories de documentação técnica com MkDocs

Epic 6 — Project Governance¶

Feature	Status	Entrega
F6.1 — Estrutura da Gestão	✅ Concluída	Aba "Gestão" no Portal com layout de slots para visão consolidada do projeto
F6.2 — Rastreabilidade de Issues	✅ Concluída	Modelagem de banco para `ProjectIssue` com tabelas lookup; endpoints `POST`, `GET`, `PATCH /resolve`, `PATCH /dismiss`, `GET /count`; interface no Portal — chip no header, drawer lateral e tela cheia na Gestão; detecção automática de inconsistências nas interações de chat; tool `register_project_issue` no MCP Server
F6.3 — Status de Implementação de Stories	✅ Concluída	Chip de status e linha de timestamps no detalhe do Work Item; stories 1–7 entregues incluindo MCP Server, Prompts e Portal

Stories Concluídas¶

F1.10 — Simplificação de Papéis RBAC¶

Story	Descrição
s.1 [Core]	Remoção do PM e papel único por projeto
s.2 [Core]	GP como administrador — bypass de edição de specs
s.3 [Agents]	GP bypassa restrição em tools de edição
s.4 [Portal]	Remoção do PM e badge GP
s.5 [Core]	Restringir gestão de equipe ao GP
s.6 [Core]	Atribuir papel GP ao criador do projeto
s.7 [Portal]	Aba Equipe somente leitura para não-GP

F2.4 — Agente ANR¶

Story	Descrição
s.1 [Agents]	Agente ANR
s.2 [Agents]	Remoção de `test_scenarios` dos agentes geradores

F3.5 — TFS como Fonte de Work Items¶

Story	Descrição
s.1 [Core]	Estender `WorkItemSource` para TFS
s.2 [Core]	Endpoint de credenciais TFS
s.4 [MCP]	Resource `tfs-cli`
s.5 [MCP]	Script `amia-tfs-cli` via REST API v6.0
s.6 [MCP]	Tool `get_tfs_credentials_tool`
s.7 [Portal]	Suporte a TFS no formulário de Integrações
s.9 [Prompts]	Roteamento TFS nos prompts CLI
s.10 [Docs]	Guia de Onboarding para Times TFS

F6.1 — Estrutura da Gestão¶

Story	Descrição
s.1 [Portal]	Aba "Gestão" com layout de slots

F6.3 — Status de Implementação de Stories¶

Story	Descrição
s.1–4	Status de implementação no Core, Portal e Agents
s.5–6	Status no MCP Server e Prompts
s.7 [Portal]	Chip de status e linha de timestamps no detalhe do Work Item

Decisões Técnicas Relevantes¶

Anthropic como modelo primário — migração de Gemini para Anthropic Claude com modo de contingência automático (fallback para Gemini via webhook Grafana), garantindo SLA mesmo em indisponibilidade do modelo primário.
Descarte de notificações SignalR em tempo real na aba de Planos — F3.1 stories 9 e 10 marcadas como obsoletas por decisão de produto; a complexidade não justificava o valor para o usuário neste momento.
WorkItemProvider abstrato — a interface desacoplada introduzida na Iteração 02 viabilizou a adição do TFS sem reescrever os agentes, validando a decisão arquitetural.

Próximos Passos¶

Com o Marco 3 entregue, as frentes abertas para sprints seguintes são: F3.3 Garantia de Qualidade (QA), F5.3 Documentação com MkDocs e eventuais melhorias de produto identificadas durante a operação da plataforma em produção.