← AI Powered Coding Team

Instalação

Pré-requisitos

  • Assistente de IA compatível instalado e configurado (ex: Claude Code)

  • 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

1

Instale o template

Linux / macOS (bash):

# Sem stack (agnóstico — você define a tecnologia depois)
curl -fsSL https://hibex-solutions.github.io/ai-powered-coding-team/install.sh | bash -s -- meu-projeto

# Com stack ASP.NET (Web API, Blazor e outros componentes .NET)
curl -fsSL https://hibex-solutions.github.io/ai-powered-coding-team/install.sh | bash -s -- meu-projeto --stack aspnet

Windows (PowerShell 5.1+):

# Sem stack (agnóstico — você define a tecnologia depois)
& ([ScriptBlock]::Create((irm https://hibex-solutions.github.io/ai-powered-coding-team/install.ps1))) meu-projeto

# Com stack ASP.NET (Web API, Blazor e outros componentes .NET)
& ([ScriptBlock]::Create((irm https://hibex-solutions.github.io/ai-powered-coding-team/install.ps1))) meu-projeto -Stack aspnet

Versão específica (bash): use --version <tag> — ex: meu-projeto --version v0.1.0-alpha8 --stack aspnet

Versão específica (PowerShell): use -Version <tag> — ex: meu-projeto -Version v0.1.0-alpha8 -Stack aspnet

Stack inválida: o script falha imediatamente e lista as stacks disponíveis na versão solicitada.

2

Configure o Git 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"
3

Produza os artefatos com a IA, sob supervisão

Cada papel humano (engenheiro, analista, designer, arquiteto) abre uma sessão de assistente de IA (ex.: claude para Claude Code) para supervisionar a produção do(s) artefato(s) sob sua responsabilidade. Solo ou em time, na mesma máquina ou em máquinas distintas, com a mesma ferramenta ou ferramentas diferentes — o framework não impõe nenhuma dessas escolhas. A IA propõe; cada papel revisa, ajusta e commita.

A ordem das etapas é inviolável. Antes de qualquer linha de código, produza:

docs/GOAL.md          ← etapa 1 — objetivo, fase e critérios de aceite (engenheiro supervisiona)
docs/BUSINESS.md      ← etapa 2 — problema e regras de negócio (analista supervisiona)
docs/GUIDELINE.md     ↰
docs/ARCHITECTURE.md  ├─ etapa 3 (projeção, paralela) — marca/UX, regras arquiteturais e solução (designer + arquiteto supervisionam)
docs/SOLUTION.md      ↲
                      → etapa 4 — implementação em src/ e test/ (engenheiro supervisiona)

BUSINESS.md descreve o problema; GUIDELINE.md, ARCHITECTURE.md e SOLUTION.md são elaborados em conjunto na etapa de projeção, coordenando marca/UX, regras arquiteturais e solução técnica. O CLAUDE.md do projeto carrega as regras do framework em qualquer sessão, sem necessidade de repetir contexto.

A produção do texto dos cinco documentos é feita pela IA na sessão padrão, sem skill especializada. Skills *-reviewer entram depois como passo de validação independente; c4model-architectural-designer entra na etapa 3 para os diagramas inline em SOLUTION.md.