Angular CLI MCP e código Angular gerado por IA

O problema real é Angular desatualizado#

O risco em código Angular gerado por IA não é um assistente escrever código. O risco é ele escrever Angular do ano errado: AppModule para tudo, diretivas estruturais antigas por hábito, conversões de RxJS sem fronteira ou APIs experimentais tratadas como estáveis.

Minko Gechev (líder do Angular team) nomeou o problema direto no post LLM-first Web Framework: 'Often the LLM will generate code that uses deprecated or missing APIs from previous versions.' O Angular CLI MCP server existe pra fechar essa lacuna, dando a ferramentas compatíveis um caminho para o Angular CLI, documentação oficial e contexto do workspace. Esse é o lado de tempo de desenvolvimento da superfície de IA do Angular: ele ajuda o assistente a escrever código melhor na sua máquina, enquanto a contraparte de runtime, o WebMCP, expõe tools tipadas do seu app publicado para um agente do browser. Isso melhora o ponto de partida. Não remove review.

O que permitir#

O setup inicial#

Comece com MCP para documentação e contexto de workspace, e ng generate ai-config para regras do repositório. O servidor vem habilitado por padrão desde a v21, mas a página oficial, construída no v22, ainda chama de experimental e ainda separa as seis ferramentas padrão (search_documentation, find_examples, ai_tutor, get_best_practices, list_projects, onpush_zoneless_migration) de outras sete atrás do --experimental-tool: build, e2e, modernize, test, mais um grupo de devserver com três (devserver.start, devserver.stop, devserver.wait_for_build). Como tudo isso roda em dev-time, o risco prático é baixo, mas mantenha política conservadora em qualquer coisa que consiga alterar código.

Para geração de código, o prompt precisa dizer o que Angular moderno significa nesse repo. Caso contrário, o assistente preenche as lacunas com o padrão que mais viu por aí.

ng mcp
ng generate ai-config --tool agents

O que o `ng generate ai-config` escreve#

O comando escreve um arquivo de regras que o assistente lê antes de tocar no código. A flag --tool é um array, tem o padrão ["none"] e decide qual arquivo vai para onde. O enum que veio no schematic é exatamente esses oito valores, e cada um aponta para um caminho que algum assistente específico já procura.

Se o arquivo de destino já existe, o schematic pula e avisa em vez de sobrescrever, então rodar isso num repo que já tem regras é seguro. O valor agents escreve um AGENTS.md; depois que ele existe, o próximo passo é fazer esse arquivo dizer algo útil, que tem o seu próprio texto.

Qualidade de prompt faz parte da arquitetura#

Um prompt vago empurra o assistente para o formato Angular mais comum na internet. Um prompt útil nomeia a arquitetura local, a versão do Angular, a fronteira de estado, a expectativa de teste e as APIs fora de escopo.

Eu rejeitaria uma saída de IA que ignora essas restrições mesmo se o componente compila. O alvo do review não é se o modelo gerou código; é se o diff respeita o modelo do time.

# Prompt ruim
Crie um componente Angular de busca.

# Prompt útil
Crie um componente de busca standalone em Angular 21.
Use Signal para o texto digitado, RxJS para debounce e cancelamento, e toSignal apenas na fronteira do componente.
Use built-in control flow no template.
Não use APIs experimentais.
Adicione um teste pequeno de service ou explique por que nenhum teste mudou.

O checklist de review#

Um diff Angular gerado por IA deve ser revisado como qualquer diff de produção, mais alguns checks específicos: conversão excessiva para Signals, providers no escopo errado, estado global acidental, acessibilidade falsa, testes ausentes e APIs cujo status não foi checado.

O ganho não é 'o agente escreveu a feature'. O ganho é um primeiro rascunho menor que ainda respeita o modelo Angular do time.

# Regras de IA para Angular

Use componentes standalone para UI nova.
Prefira `inject` quando combinar com o estilo local.
Use built-in control flow em templates tocados.
Use Signals para estado local e derivado.
Mantenha RxJS para streams, cancelamento e composição assíncrona.
Não use APIs experimentais sem decisão explícita.
Não coloque secrets em código frontend Angular.
Todo diff gerado precisa de review humano.