Primeiro Projeto¶

Este guia mostra como criar um projeto no AMia e executar os primeiros passos de acordo com o tipo de projeto.

Passo 1 — Criar o projeto no Portal¶

Acesse o Portal AMia e clique em Novo Projeto
Preencha o nome e a descrição do projeto
Selecione o tipo de projeto:

Tipo	Quando usar
Novo Projeto	Sistema sendo construído do zero, sem código-fonte preexistente
Em Andamento	Sistema com código-fonte existente em evolução ou manutenção
Migração	Sistema legado sendo migrado para nova stack ou arquitetura

Faça upload do documento de proposta (PDF ou DOCX) se disponível
Clique em Criar
Anote o ID do projeto exibido na URL: https://portal.amia.amcom.com.br/projects/{ID}/...

Passo 2 — Engenharia Reversa (somente Em Andamento e Migração)¶

Execute antes de qualquer desenvolvimento

Para projetos Em Andamento e Migração, a engenharia reversa deve ser executada uma única vez antes de iniciar qualquer story. Ela gera a documentação funcional e de arquitetura que os demais commands consomem como referência.

Com o Claude Code aberto na raiz do repositório e já autenticado no MCP Server (ver Setup e Configuração), execute:

/amia:run.reverse_engineering

O pipeline executa em duas fases:

Fase	Command	Produz
1	`/amia:analyst.functional_survey`	`FUNCTIONAL_REQUIREMENTS/` — módulos, regras de negócio, atores, validações
2	`/amia:architect.architecture_survey`	`ARCHITECTURE/` — stack, camadas, patterns, segurança, modelo de dados

Cada fase solicita que o especialista correspondente seja executado manualmente. Confirme no pipeline ao concluir cada uma para avançar.

Projetos Novos

Para projetos do tipo Novo Projeto, pule este passo e siga direto para o Passo 3.

Passo 3 — Gerar a Visão do Produto¶

Após criar o projeto, o amIA está pronto para gerar a Spec de Visão e iniciará o processo automaticamente:

Na tela do projeto, você verá a spec de Visão com status Gerando especificação
O agente de Visão analisa o documento de proposta e gera:
Propósito e domínio do negócio
Consumidores do sistema
Capacidades de alto nível

Geração assíncrona

A geração de specs é assíncrona — você receberá uma notificação quando estiver pronta (30 segundos a 2 minutos).

Passo 4 — Adicionar membros ao projeto¶

No Portal, acesse Membros no projeto
Adicione os membros pelo e-mail corporativo
Atribua os papéis: Product Owner, Arquiteto, Designer, Desenvolvedor, QA

Próximos passos¶

Com o ambiente configurado e o projeto pronto, você pode iniciar o desenvolvimento de stories:

/amia:run.implement_story {código da story}

Consulte o guia de Setup e Configuração se precisar revisar os commands disponíveis.