Iteração 02 — Release Notes
Período: Abril de 2026 — ciclo encerrado em 02/05/2026
Marco: MVP Coding & Segurança — entregue em 30/04/2026
Resumo
A Iteração 02 entregou o módulo de desenvolvimento assistido por IA (Fábrica de Código), a gestão de identidade e controle de acesso (IAM/OAuth2) e a habilitação de projetos em andamento via Engenharia Reversa — consolidando o MVP Coding da plataforma AMia.
Times em andamento passaram a poder integrar o AMia sem partir do zero: a ferramenta de Engenharia Reversa analisa o repositório existente e gera specs de arquitetura, funcional e de visão automaticamente. O desenvolvedor passa a executar a geração de código via MCP Server com roles.yaml consumido dinamicamente da API, e o acesso a specs e operações é controlado pelo papel do usuário no projeto.
Funcionalidades Entregues
Epic 1 — Foundation & Planning
| Feature |
Entrega |
| F1.3 — Versionamento de Prompts (3/5 stories) |
Repositório amia-prompts com estrutura de diretórios, schema de validação e políticas de acesso no ADO; pipeline CI/CD com Promptfoo e gate de aprovação; MCP Server com registro dinâmico de tools via resources prompt:// por chave e versão |
| F1.5 — Gestão de Identidade IAM/OAuth2 (11/15 stories) |
RBAC no Core com tabelas ProjectRole e UserProjectRole; endpoints de controle de acesso; Middleware OAuth2 no MCP Server; controle de solicitações de modificação por papel; enriquecimento de contexto de chat; agents respeitando papel do usuário; login local do desenvolvedor no MCP Server |
| F1.7 — Provisionamento DEV MCP Server |
Container do MCP Server provisionado no ambiente DEV na Azure; roles.yaml migrado para consumo dinâmico via API do Core |
| F1.9 — Multimodal no Chat de Specs |
Botão de anexo no chat e integração multimodal completa — usuário pode enviar imagens e arquivos como contexto para os agentes de spec |
Epic 2 — Specification & Planning
| Feature |
Entrega |
| F2.1 — Planejamento Funcional e Técnico (concluída) |
Edição manual de Work Items no Portal (story 5); Agente de Manutenção de Work Items completo (create/update/delete via linguagem natural) |
| F2.2 — Planejamento de Iteração (concluída) |
Modal de criação de iteração com drag-and-drop (@angular/cdk/drag-drop); evolução da entidade WorkItem com IterationId, RefinementStatus e EstimatedHours; endpoints de Tasks (persistência em massa, consulta e edição manual); disparo de refinamento assíncrono com notificações SignalR tasks_generated/refinement_failed; interface de refinamento de USs em tarefas com geração assíncrona por IA e adição/edição manual; Agente de Refinamento de USs em Tarefas |
Epic 3 — Construction & Quality
| Feature |
Entrega |
| F3.1 — Fábrica de Código MCP Server (4/7 stories) |
Spike de validação do fluxo CLI Coder + Commands + MCP Server; spike de calibração dos commands C# e Angular (taxa de sucesso ≥ 80%); tools do MCP Server para criação de arquivos e CLI de bootstrap; endpoints de status e acompanhamento do plano de codificação no Core; interface de status do plano de codificação no Portal |
| F3.4 — ADO como Fonte de Work Items (Core + Portal) |
Endpoints PATCH /work-item-source e POST /work-item-source/validate; configuração de WorkItemSource por projeto com PAT encriptado; endpoint de validação ADO; AdoWorkItemProvider Python com interface WorkItemProvider; interface de configuração de fonte de Work Items no Portal (aba Integrações com botão "Testar Conexão"); Guia de Onboarding para Times ADO |
Epic 5 — Rollout & Adoption
| Feature |
Entrega |
| F5.1 — Engenharia Reversa (concluída) |
Novo tipo de projeto ONGOING_DEVELOPMENT; endpoint de Engenharia Reversa no Core; tools read_project_structure, analyze_tech_stack, extract_architecture_patterns, submit_reverse_engineering + command /reverse-engineering; adaptação dos Agents para projetos em andamento — geradores de Arquitetura, Design e Vision consumindo LevantamentoArquitetura e LevantamentoFuncional como contexto |
| F5.2 — Onboarding + Plugin Marketplace |
Command /setup com checklist de conectividade; Guia Unificado de Onboarding do Desenvolvedor; investigação e desenvolvimento do Plugin AMia para Claude Code Marketplace |
Stories Concluídas
F2.2 — Planejamento de Iteração
| Story |
Descrição |
| s.3 |
Evolução da entidade WorkItem com IterationId, RefinementStatus e EstimatedHours |
| s.5 |
Modal de criação de iteração com drag-and-drop |
| s.6 |
Disparo de refinamento assíncrono + notificações SignalR |
| s.7 |
Agente de Refinamento de USs em Tarefas |
| s.8 |
Endpoints de Tasks — persistência em massa, consulta e edição |
| s.9 |
Interface de refinamento de USs com geração assíncrona e edição manual |
F1.3 — Versionamento de Prompts
| Story |
Descrição |
| s.1 |
Modelagem de banco e API REST de Prompts |
| s.2 |
API REST de Prompts — endpoints de consulta |
| s.3 |
Repositório amia-prompts com estrutura de diretórios, schema e políticas ADO |
| s.4 |
Pipeline CI/CD com Promptfoo e gate de aprovação |
| s.5 |
MCP Server — registro dinâmico de tools + resources prompt:// |
F1.5 — Gestão de Identidade IAM/OAuth2
| Story |
Descrição |
| s.1 |
Tabelas ProjectRole e UserProjectRole com seed dos papéis padrão |
| s.2 |
UI de gestão de equipe e controle de acesso |
| s.3 |
Criação de usuário ao adicionar ao projeto + controle de acesso a specs por papel |
| s.4 |
UI — controle de acesso no Portal |
| s.5 |
Middleware OAuth2 no MCP Server |
| s.7 |
Middleware OAuth2 — finalização e testes |
| s.8 |
Agents respeitando papel do usuário |
| s.9 |
Enriquecimento de contexto de chat com papel do usuário |
| s.10 |
Controle de solicitações de modificação por papel |
| s.15 |
Login local do desenvolvedor no MCP Server |
F3.1 — Fábrica de Código MCP Server
| Story |
Descrição |
| s.1 |
Spike — validação do fluxo CLI Coder + Commands + MCP Server |
| s.2 |
Spike — calibração dos commands C#/Angular (≥ 80% sucesso) |
| s.3 |
Tools MCP Server — criação de arquivos e CLI de bootstrap |
| s.4 |
Endpoints Core — status e acompanhamento do plano de codificação |
| s.5 |
Tools MCP — Plano de Codificação |
| s.6 |
Interface Portal — visualização do plano de codificação na User Story |
F3.4 — ADO como Fonte de Work Items
| Story |
Descrição |
| s.1 |
Configuração WorkItemSource por projeto com PAT encriptado |
| s.2 |
AdoWorkItemProvider Python |
| s.3 |
Endpoint de validação ADO |
| s.4 |
Guia de Onboarding para Times ADO |
| s.5 |
Interface de configuração ADO no Portal — aba Integrações |
F5.1 — Engenharia Reversa
| Story |
Descrição |
| s.1 |
Novo tipo de projeto ONGOING_DEVELOPMENT + endpoint de Engenharia Reversa |
| s.2 |
Adaptação dos Agents para projeto em andamento |
| s.3 |
Tools de Engenharia Reversa do repositório + command /reverse-engineering |
| s.4 |
Handler SetupProjectCommand para tipo ongoing |
Decisões Técnicas Relevantes
- Prompt As Code — prompts versionados em repositório Git separado (
amia-prompts) com pipeline Promptfoo para validação automática de qualidade antes da publicação. Ver ADR-003.
- OAuth2/RBAC no MCP Server — middleware adicionado para garantir que operações do MCP Server respeitem os papéis do projeto, alinhando a segurança da CLI com o Portal.
AdoWorkItemProvider com interface abstrata — WorkItemProvider desacoplado da implementação ADO para facilitar a adição do TFS na iteração seguinte sem reescrever os agentes.
Próximos Passos
A Iteração 03 foca na simplificação do modelo de papéis (F1.10 RBAC), na integração com TFS (F3.5), no fechamento da Fábrica de Código (F3.1 restante), na governança do projeto (Epic 6 — Issues e Status de Implementação) e no início do Marco 3 com o Dashboard Grafana (F4.3).