AI Powered Coding Team

O que é

AI Powered Coding Team é um modelo de projeto (project template) que define a estrutura, os papéis e as instruções necessárias para que um engenheiro de software sênior utilize IA — inicialmente Claude Code — como uma equipe completa de desenvolvimento.

O engenheiro deixa de atuar apenas como desenvolvedor e passa a assumir todos os papéis de um time:

Papel	Responsabilidade
Arquiteto de Soluções	Define arquitetura, tecnologias e governança técnica
Analista de Negócio	Especifica regras de negócio e requisitos funcionais
Designer	Define diretrizes de marca, UI e UX
Engenheiro de Software	Implementa, testa e entrega o software

A IA executa sob a supervisão e gestão ativa do engenheiro — que direciona, revisa e decide. A autonomia técnica permanece humana; o volume e a velocidade de execução são amplificados pela IA.

Como funciona

Engenheiro Sênior
      │
      ├── atua como ──► Arquiteto  ──► docs/ARCHITECTURE.md
      │                                docs/SOLUTION.md
      │
      ├── atua como ──► Analista   ──► docs/BUSINESS.md
      │
      ├── atua como ──► Designer   ──► docs/GUIDELINE.md
      │
      └── delega para ─► IA (Claude Code)
                              │
                              ├── lê as especificações
                              ├── implementa o software
                              ├── escreve os testes
                              ├── revisa a arquitetura
                              └── valida regras de negócio

O modelo garante que nenhum código seja escrito sem especificação, que nenhuma decisão técnica seja tomada sem documentação e que toda implementação seja validada contra regras de negócio e diretrizes de marca — mantendo a qualidade de uma equipe madura mesmo com um único operador.

Pré-requisitos

Claude Code instalado e configurado
Git instalado localmente
PowerShell 5.1 ou superior — nativo no Windows 10+; necessário apenas para usuários Windows
Conhecimento sólido de engenharia de software (o modelo foi projetado para profissionais sênior)

Iniciando um novo projeto

Instale o template

Linux / macOS (bash)

curl -fsSL https://hibex-solutions.github.io/ai-powered-coding-team/install.sh | bash -s -- meu-projeto

Windows (PowerShell 5.1+)

& ([ScriptBlock]::Create((irm https://hibex-solutions.github.io/ai-powered-coding-team/install.ps1))) meu-projeto

Versão específica: acrescente a tag ao final do comando, após o nome do diretório (ex: meu-projeto v0.1.0-alpha6).

O script baixa automaticamente a versão solicitada (ou a última disponível) e inicializa o diretório como repositório Git. Após a instalação, configure o Git local e faça o primeiro commit:

cd meu-projeto

# Configure o Git local (obrigatório — não use as configurações globais)
git config user.name "Seu Nome"
git config user.email "seu@email.com"

git add .
git commit -m "chore: inicializa projeto a partir do template"

Especifique antes de implementar

Antes de qualquer linha de código, o engenheiro documenta:

docs/ARCHITECTURE.md  ← decisões arquiteturais e regras invioláveis
docs/SOLUTION.md      ← componentes, tecnologias e desenho da solução
docs/BUSINESS.md      ← regras de negócio e requisitos funcionais
docs/GUIDELINE.md     ← padrões de marca, UI e UX

Delegue para a IA

Com as especificações em mãos, use o Claude Code para implementar:

claude

O CLAUDE.md do projeto já instrui a IA com as regras arquiteturais, a especificação negocial e as diretrizes de marca — sem necessidade de repetir contexto a cada sessão.

Estrutura do projeto

.
├── .claude/                    # Configurações do Claude Code
│   ├── CLAUDE.md               # Instruções para a IA
│   └── skills/                 # Skills customizadas
│       ├── architect-reviewer/
│       ├── business-reviewer/
│       ├── github-site-generator/
│       └── guideline-reviewer/
│
├── docs/                       # Toda a documentação
│   ├── ARCHITECTURE.md         # Especificação arquitetural
│   ├── SOLUTION.md             # Especificação da solução
│   ├── BUSINESS.md             # Especificação negocial
│   ├── GUIDELINE.md            # Guideline de marca e UX
│   └── architecture/
│       └── 12factor/           # Referência: The Twelve-Factor App
│
├── src/                        # Código-fonte
├── test/                       # Testes
├── eng/                        # Scripts de engenharia e CI/CD
├── samples/                    # Exemplos de uso
│
├── CLAUDE.md                   # Ponto de entrada das instruções para IA
├── CONTRIBUTING.md             # Guia de contribuição por perfil
└── LICENSE

Comandos disponíveis

Skill	Descrição
`/architect-reviewer`	Valida conformidade com `ARCHITECTURE.md`, `SOLUTION.md` e os 12 fatores
`/business-reviewer`	Valida conformidade entre `BUSINESS.md`, implementação e cobertura de testes
`/guideline-reviewer`	Valida conformidade entre `GUIDELINE.md` e as interfaces construídas
`/github-site-generator`	Gera o site GitHub Pages em `docs/site/` e atualiza o README

Regras fundamentais do modelo

📋

Especificação antes de implementação Nenhuma funcionalidade sem regra de negócio documentada

📂

Nenhuma tecnologia sem registro Toda stack deve estar em docs/SOLUTION.md

🧪

Testes guiados por negócio Cobertura 100% das regras especificadas em docs/BUSINESS.md

🔒

Secrets nunca no código Sempre configuráveis por ambiente

⚙️

The Twelve-Factor App Software aderente aos doze fatores — ver docs/architecture/12factor/

🤝

Commits são humanos A IA propõe, o engenheiro commita

Contribuindo

Veja CONTRIBUTING.md para entender as responsabilidades de cada perfil e as regras de colaboração com o projeto.

Contribuições são bem-vindas — especialmente melhorias nas instruções da IA, novas skills de revisão, e suporte a outros assistentes além do Claude Code.