aidlc-workflows

AI-DLC (ciclo de vida de desenvolvimento orientado por IA) é uma estrutura de fluxo de trabalho neutra e estruturada, projetada para transformar assistentes de codificação de IA em sistemas de entrega de software verificáveis e auditáveis. Ela aborda o desafio da codificação de IA ad hoc perder contexto à medida que os projetos crescem, mantendo requisitos, decisões, implementação, testes e trabalho operacional conectados por meio de um ciclo de vida padronizado. ### Principais recursos - **Estrutura do ciclo de vida:** compreende 5 fases e 33 estágios, da inicialização à operação. - **Composição de agentes:** emprega 14 agentes, incluindo 11 especialistas de domínio, 2 revisores e um compositor adaptativo. - **Perfis de fluxo de trabalho:** oferece 11 perfis de fluxo de trabalho para recursos, correções de bugs, infraestrutura, segurança, provas de conceito, entrega empresarial e outros trabalhos comuns. - **Governança:** apresenta portões de aprovação humana, evidências de revisão vinculadas à fonte e uma trilha de auditoria de 99 eventos, juntamente com estado persistente, conhecimento da equipe e regras aprendidas. - **Mecanismo determinístico:** fornece um mecanismo único e consistente em todos os harnesses suportados. ### Harnesses suportados O mecanismo principal é executado nativamente nos principais ambientes de codificação de IA, incluindo: - Claude Code (invocado via `/aidlc`) - Kiro CLI e Kiro IDE - Codex CLI (invocado via `$aidlc`) - Cursor (invocado via `/aidlc` ou `agent`) - opencode (invocado via `/aidlc`) - GitHub Copilot CLI / VS Code (invocado via `/aidlc`) ### Instalação e configuração Os usuários podem instalar o AI-DLC por meio de um instalador nativo para macOS, Linux, WSL ou Windows PowerShell, que adiciona o comando `aidlc` e todos os runtimes de harness sem exigir Bun ou Node.js. Alternativamente, os usuários podem copiar manualmente o diretório `runtime/<harness>/` para o projeto usando Bun. A configuração do projeto é tratada executando `aidlc config --harness <nome>` seguido de `aidlc doctor` para verificar o ambiente. A configuração do provedor de modelo é tratada pelo respectivo harness, com Amazon Bedrock como padrão para Claude Code e configurações Codex fornecidas, e a metodologia permanece independente do provedor. ### Estrutura do repositório - `core/`: contém a metodologia neutra de harness, o mecanismo e 71 ferramentas de autoria escritas manualmente. - `harness/<nome>/`: contém manifestos e integrações finos e específicos do harness. - `plugins/<nome>/`: abriga plugins AIDLC opcionais. - `scripts/`: contém ferramentas de empacotamento, binário, instalador e release. - `tests/`: inclui suítes de teste de fumaça, unidade, integração e ponta a ponta. - `docs/`: fornece guias do usuário, documentação de engenharia de harness e referências para desenvolvedores.