O Problema Oculto do Desenvolvimento com IA
Quem desenvolve com Inteligência Artificial conhece bem o ciclo: você descreve uma nova feature, o agente sai escrevendo código antes mesmo de entender completamente o problema, ignora os testes, inventa contexto e, três horas depois, você está revisando um diff de 800 linhas para descobrir que metade da implementação não faz o que foi pedido.
A culpa não é exclusivamente do modelo de IA. O problema raiz é a ausência de processo. Engenheiros de software sêniores não começam a programar impulsivamente — eles especificam, planejam, testam e revisam. Faltava aos agentes autônomos esse mesmo rigor metodológico.
É exatamente essa lacuna que o framework AI-Augmented Developer resolve.
O que é o AI-Augmented Developer?
O AI-Augmented Developer (aiadev) é um framework de workflow completo focado em agentes de codificação. Ele instala um conjunto de skills componÃveis e fornece instruções iniciais (prompts de sistema) que garantem que o agente utilize essas habilidades automaticamente, sem que o desenvolvedor precise se lembrar de acioná-las a cada interação.
A filosofia do framework é pautada em quatro pilares inegociáveis:
- Spec-first: Nenhum código é gerado sem uma especificação prévia aprovada.
- Test-first: O ciclo RED-GREEN-REFACTOR é tratado como um contrato, não como uma sugestão.
- Evidência sobre afirmação: O agente deve verificar a execução do código antes de declarar que o trabalho foi concluÃdo com sucesso.
- Simplicidade como meta primária: Os princÃpios YAGNI (You Aren't Gonna Need It) e DRY (Don't Repeat Yourself) são leis.
O fluxo de trabalho padrão opera como uma esteira contÃnua de oito etapas lógicas:
specify → clarify → plan → tasks → implement
│
test-driven-development (por tarefa)
systematic-debugging (em falhas)
checklist (segurança, perf, a11y, i18n…)
↓
analyze → requesting-code-review → finishing-a-branch
Cada etapa atua como uma skill que dispara sozinha quando o contexto exige. O agente é instruÃdo a não pular etapas ou inventar contexto, apresentando sempre a especificação (spec) antes de escrever o primeiro teste.
A Constituição: Sete Artigos Fundamentais
O coração do framework reside no arquivo constitution.md. Ele contém sete princÃpios que toda decisão técnica tomada pela IA precisa respeitar:
- Spec-first: Sem especificação aprovada, não há código.
- Test-first: Todo teste deve falhar antes de sua respectiva implementação.
- Simplicidade: Busca-se sempre a solução mais simples e viável.
- Evidência sobre afirmação: O agente deve rodar, provar e mostrar resultados reais.
- Provider pattern: Dependências externas devem ficar isoladas atrás de interfaces.
- Privacy by design: Dados sensÃveis nunca devem vazar para o contexto das LLMs.
- Atribuição: Trabalhos derivados devem sempre receber os devidos créditos.
Todo plano arquitetural gerado pela skill plan carrega um Constitution Check. Se um artigo for quebrado, o desvio é registrado em uma tabela de Complexity Tracking junto com sua justificativa. Sem essa disciplina e rastreabilidade, o framework se recusa a avançar.
A Evolução Acelerada do Framework
Entre 14 e 15 de abril de 2026, o projeto evoluiu de forma expressiva da versão 0.3 para a 0.11. Cada release foi focada em resolver fricções reais de quem utiliza a ferramenta no dia a dia.
v0.3 — Instalação Interativa (aiadev install)
A CLI em Python substituiu de vez os scripts manuais antigos. Um único comando agora renderiza um preset no projeto (substituindo variáveis e posicionando arquivos), contando com modos --dry-run, --uninstall e detecção de drift (desvios) contra edições manuais.
v0.4 & v0.5 — Suporte Multiplataforma
Em duas atualizações, o framework abraçou as cinco principais ferramentas de IA para desenvolvimento do mercado: Claude Code, Cursor, Codex, OpenCode e Gemini CLI. Cada integração possui um handler isolado e modular (~30 linhas) com 100% de cobertura de testes.
v0.6 — Escopo Global de Usuário
A flag --scope user permite instalar as skills uma única vez por máquina (sob ~/.<plataforma>/skills/). Todo projeto na sua estação herda automaticamente o catálogo global, mantendo apenas arquivos especÃficos (como CLAUDE.md e constitution.md) em nÃvel local.
v0.7 — Publicação no PyPI
O comando pip install aiadev tornou-se a via oficial de distribuição. O pacote (wheel) já embute recursos essenciais (como templates/, schemas/, skills/ e agents/), eliminando a necessidade de clonar o repositório. O processo de publicação utiliza OIDC trusted publishing para maior segurança.
v0.8 — Sistema Robusto de Extensões
O comando aiadev extension add <git-url> abriu portas para a distribuição de presets de terceiros. Agora, a comunidade e empresas podem criar catálogos públicos ou privados. Para evitar conflitos, funcionalidades embutidas (built-ins) têm prioridade em caso de colisão de nomes.
v0.9 — Instalação Completa e Sincronização
Um marco do projeto. O comando de instalação passou a equipar o projeto com toda a esteira de uma vez, incluindo dezenas de slash commands, agentes, regras e skills. Além disso, o novo aiadev sync permite atualizar projetos existentes de forma inteligente, usando introspecção de dependências (package.json, pyproject.toml, Makefile, etc.) para gerar as configurações automaticamente.
v0.10 — Namespaces e Especificações Sequenciais
Os comandos foram organizados via namespaces (ex: /aiadev:specify). As especificações deixaram os diretórios com nomes arbitrários e adotaram identificadores sequenciais (specs/0001-<slug>/). E o principal para usuários lusófonos: aiadev init --language pt-BR garante que todo o pipeline da IA interaja em português do Brasil.
v0.11 — Integração MCP Universal
O Model Context Protocol (MCP) tornou-se um cidadão de primeira classe. Basta declarar seus servidores MCP uma vez em mcps.yaml e o aiadev install cuida da tradução para o formato nativo exigido por cada plataforma (Claude, Cursor, Gemini, etc.).
Por Que Isso Importa Para o Seu Time?
A rápida evolução do framework é prova do próprio método: o aiadev se aplica a si mesmo. As especificações do projeto vivem em specs/, os planos são gerados pela skill plan e os commits seguem a padronização imposta pela skill tasks.
Para desenvolvedores que utilizam IA, o framework ataca quatro dores crônicas simultaneamente:
| Problema Comum | A Solução do Framework (aiadev) |
|---|---|
| Agente codifica sem entender a feature | A skill specify obriga a validação da especificação primeiro. |
| Código sem testes ou testes tardios | A skill test-driven-development força a adoção do ciclo RED-GREEN-REFACTOR. |
| Decisões técnicas perdidas ou esquecidas | A skill analyze detecta e reporta divergências entre spec, plan, tasks e o código final. |
| Configuração tediosa em todo projeto novo | Comandos unificados (install, --scope user, extensões) automatizam o setup. |
E o maior benefÃcio: você não precisa invocar manualmente as etapas. As skills são projetadas para disparar de forma autônoma nos momentos corretos, em qualquer uma das plataformas suportadas, entregando um Pull Request limpo ao final do processo.
Como Começar
Adotar o framework é rápido e exige apenas o ambiente Python configurado:
# 1. Instale a CLI globalmente
pip install aiadev
# 2. Acesse o seu projeto e instale o preset adequado à sua stack
cd meu-projeto
aiadev install --preset lean # Pipeline genérico e enxuto
aiadev install --preset django-drf-react # Foco em Web full-stack
aiadev install --preset mobile-ops # Foco em Cloud Run + Expo
# 3. Escolha a sua plataforma de IA favorita (Padrão: claude-code)
aiadev install --preset lean --platform cursor
# 4. Quer interagir em português? Inicialize com a flag de idioma
aiadev init --language pt-BR
# 5. Verifique se a instalação está correta
aiadev doctor
Inicie uma nova sessão, solicite a criação de uma feature em linguagem natural e assista ao seu agente puxar a skill specify antes de digitar a primeira linha de código.
Quem Deveria Usar?
- Desenvolvedores Solo: Que buscam maximizar a produtividade da IA sem abrir mão da qualidade e organização de software.
- Equipes: Que necessitam de um processo de IA consistente e previsÃvel em um ambiente com múltiplos contribuidores.
- Empresas: Que desejam padronizar metodologias no uso de IA generativa, sem se tornarem reféns de uma única ferramenta do mercado.
- Mantenedores de Infraestrutura: Que podem tirar proveito do sistema de extensões para distribuir presets de arquitetura internos de forma eficiente.
Próximos Passos
Com a esteira de desenvolvimento completa, suporte a cinco plataformas principais e integração nativa com MCP estabelecidos, o roadmap futuro mira na criação de presets temáticos adicionais (como Dados, Machine Learning e Infraestrutura), telemetria opt-in para avaliar o desempenho das skills e novas ferramentas voltadas à validação de especificações por múltiplos agentes especializados.
O objetivo inicial, porém, já foi conquistado: construir um framework completo para o uso produtivo, disciplinado o suficiente para projetos de alto nÃvel e aberto para a comunidade evoluir e adaptar.
- Repositório Oficial: https://github.com/suportly/ai-augmented-developer
- Versão Atual: 0.11.0 (Lançada em 15/abr/2026)
- Licença: MIT
- Instalação rápida:
pip install aiadev
