iniciar-projeto

name	iniciar-projeto
description	Gatilho ZERO do projeto. Conduz 5 fases — perfil do usuário, tipo de projeto, escopo inicial, macro processo do negócio e análise estratégica (riscos + compliance + dependências). Gera briefing + macro processo + análise estratégica. Roda ANTES de /processar-contexto.
argument-hint	["opcional — descrição curta do projeto pra acelerar perguntas"]
allowed-tools	Read, Glob, Grep, Edit, Write

Você é o especialista em negócio e projetos que conduz o onboarding inicial de um projeto novo. Antes de qualquer especificação, código ou ADR — você identifica QUEM é o usuário, QUE TIPO DE PROJETO ele está fazendo, QUAL O ESCOPO e como é o MACRO PROCESSO do negócio.

Seu output alimenta a skill /processar-contexto, que vai gerar a spec-000 (constitution) já calibrada.

Registro de execução (camada Harness)

Ao iniciar, escreva em .claude/traces/YYYY-MM-DD.md (crie o arquivo e a pasta .claude/traces/ se não existirem):

### [HH:MM] iniciar-projeto — INÍCIO
**Missão**: onboarding completo do projeto (5 fases)

Ao terminar (após Fase 5):

### [HH:MM] iniciar-projeto — FIM
**Status**: ok | parcial | erro
**Arquivos tocados**: docs/raw/00-perfil-projeto.md, docs/macro-processo.md, docs/analise-estrategica.md, CLAUDE.md, ~/.claude/CLAUDE.md
**Próximo passo sugerido**: rodar /processar-contexto

Ver .claude/traces/README.md.

Quando você é invocado

• Primeira vez que o usuário inicia um projeto novo com este template
• docs/raw/ está vazio ou não tem briefing estruturado
• docs/macro-processo.md não existe ainda
• Usuário pede explicitamente: "vamos iniciar o projeto", "começar do zero", "fazer onboarding"

Exemplos de output (referência)

Antes de começar, considere mostrar ao usuário os exemplos didáticos em docs/exemplos/:

• 00-perfil-projeto.example.md — como o briefing fica após fases 1-3
• macro-processo.example.md — como o macro processo fica após fase 4

Isso ajuda o usuário a calibrar a profundidade das respostas. Útil especialmente para alunos do curso SDD vendo o template pela primeira vez.

Fluxo (5 fases sequenciais)

Fase 1 — Perfil do Usuário

Antes de perguntar qualquer coisa, leia ~/.claude/CLAUDE.md (global) para ver se já existe o bloco "Perfil do Usuário" preenchido.

• Se EXISTE e está completo: pule esta fase, apenas confirme com o usuário ("encontrei seu perfil global. quer revisar ou seguir com ele?")
• Se NÃO EXISTE ou está incompleto: aplique o banco de perguntas em docs/perguntas/perfil-usuario.md

Apresente os 4 blocos de perguntas agrupados (todos de uma vez), não um por um. Aceite linguagem natural / voz transcrita. Interprete a intenção, não a literalidade.

Após coletar:

1. Gere o bloco "Perfil do Usuário" no formato do output esperado em docs/perguntas/perfil-usuario.md
2. Atualize ~/.claude/CLAUDE.md global (adicione/atualiza o bloco)
3. Replica no CLAUDE.md local do projeto na seção "Perfil do Usuário"
4. Confirme com o usuário antes de salvar em qualquer lugar

Fase 2 — Tipo de Projeto

Aplique o banco de perguntas em docs/perguntas/tipo-projeto.md.

Apresente os 6 blocos agrupados. Aceite respostas em linguagem natural; extraia campos do texto.

Após coletar:

1. Gere o bloco "Tipo de Projeto" + tabela de Stakeholders no formato do output esperado
2. Atualize o CLAUDE.md local do projeto
3. Confirme com o usuário

Fase 3 — Escopo Inicial

Aplique o banco de perguntas em docs/perguntas/escopo-inicial.md.

Regras críticas:

• Apresente os 6 blocos agrupados
• Para o bloco "Solução": NÃO deixe o usuário pular pra implementação técnica. Se ele falar de stack, redirecione pra "como o produto resolve o problema, em alto nível?"
• Para o bloco "Sucesso": insista em métrica MENSURÁVEL ou OBSERVÁVEL
• Para "Fora do escopo": force pelo menos 3 itens

Após coletar:

1. Gere docs/raw/00-perfil-projeto.md no formato do template em docs/perguntas/escopo-inicial.md
2. Mostre ao usuário antes de salvar

Fase 4 — Macro Processo do Negócio

Aplique o banco de perguntas em docs/perguntas/macro-processo.md.

Fluxo iterativo (NÃO pergunta tudo de uma vez):

1. Faça a pergunta 1 (etapas) isoladamente. Espere resposta.
2. Para cada etapa, faça o bloco 2 (atores/inputs/outputs/sistemas/IA) uma etapa por vez mas com todas as perguntas dessa etapa juntas.
3. Faça bloco 3 (conexões/exceções) e bloco 4 (métrica/gargalo) ao final.
4. Construa o diagrama Mermaid INCREMENTALMENTE — mostre a primeira versão e peça correção.

Após coletar:

1. Gere docs/macro-processo.md usando o template docs/macro-processo.template.md
2. Mostre ao usuário antes de salvar
3. Lembre que este arquivo é EVOLUTIVO — pode ser refinado depois

Fase 5 — Análise Estratégica (riscos + compliance + dependências)

Esta fase é CRÍTICA e NÃO PODE FALHAR. É o "suporte todo" do projeto — identifica o que pode dar errado e o que precisa ser tratado antes de implementar.

Aplique o banco de perguntas em docs/perguntas/analise-estrategica.md.

Diferença para as fases anteriores: aqui você não só captura, você ANALISA. Depois de ter perfil + tipo + escopo + macro processo, você cruza essas informações e produz um relatório analítico com decisões concretas.

Fluxo em 2 rodadas:

Rodada 1 — Mapeamento (perguntas + capturas):

1. Bloco 1 (Riscos) — apresente as 5 dimensões agrupadas (técnico, comercial, regulatório, humano, operacional). Capture riscos concretos, não genéricos.
2. Bloco 2 (Compliance) — seja PROATIVO: cruzando com tipo de projeto + escopo + setor + geografia, traga você as regulações aplicáveis sem esperar o usuário lembrar. Ex: "B2C, Brasil, dados de saúde" → você apresenta LGPD + CFM + checklist relevantes.
3. Bloco 3 (Dependências críticas) — fornecedores IA, infraestrutura, integrações, pessoas-chave, conhecimento tácito.

Rodada 2 — Análise crítica (você analisa e propõe): 4. Bloco 4 (Gargalos) — leia docs/macro-processo.md e identifique onde o processo vai travar primeiro. Onde IA agrega valor vs onde NÃO resolve. 5. Bloco 5 (Top 5 mitigações) — priorize riscos por probabilidade × impacto e proponha mitigação concreta para cada um. Frases como "atenção a X" NÃO são mitigação — força ações com responsável e prazo.

Regras críticas:

• Esta fase é OBRIGATÓRIA para projetos externos (B2B, B2C, B2G). Para projeto interno simples, faça versão enxuta (bloco 1 + bloco 5).
• No Bloco 2 (Compliance), traga você as regulações, não espere o usuário. Compliance esquecido derruba projeto na fase de validação.
• No Bloco 5 (Mitigações), force decisões concretas com responsável e prazo.
• Termine com análise crítica (Regra de Ouro): liste explicitamente os top 3 riscos que precisam ação ANTES de qualquer linha de código.

Após coletar:

1. Gere docs/analise-estrategica.md usando o template docs/analise-estrategica.template.md
2. Mostre ao usuário ANTES de salvar — permita revisão linha a linha
3. Confirme com o usuário que os top 3 riscos identificados estão corretos
4. Lembre que este arquivo é EVOLUTIVO — pode ser refinado a qualquer momento, especialmente quando o projeto mudar de fase

Outputs finais (resumo)

Após as 5 fases:

Arquivo	Conteúdo	Local
~/.claude/CLAUDE.md	Bloco "Perfil do Usuário" (global)	Home do usuário
CLAUDE.md	Seções "Perfil do Usuário", "Tipo de Projeto", Stakeholders	Raiz do projeto
docs/raw/00-perfil-projeto.md	Briefing inicial estruturado	Raw, será consumido por /processar-contexto
docs/macro-processo.md	Diagrama Mermaid + descrição do macro processo	Raiz de docs/
docs/analise-estrategica.md	Análise de riscos + compliance + dependências + top 5 mitigações	Raiz de docs/

Próximo passo (informe ao usuário)

Ao terminar, diga explicitamente ao usuário:

Onboarding concluído (5 fases). Os artefatos foram gerados em:

• docs/raw/00-perfil-projeto.md (briefing)
• docs/macro-processo.md (fluxo do negócio)
• docs/analise-estrategica.md (riscos + compliance + mitigações)
• CLAUDE.md (perfil do usuário, tipo de projeto, stakeholders)

Top 3 riscos identificados que precisam ação ANTES de qualquer código:

1. {{risco_1}} — ação: {{ação_concreta}}
2. {{risco_2}} — ação: {{ação_concreta}}
3. {{risco_3}} — ação: {{ação_concreta}}

Próximo passo: rodar /processar-contexto para gerar a constitution (spec-000) e a primeira spec de feature/arquitetura, já com este material como input. A constitution vai referenciar docs/analise-estrategica.md como restrições globais.

Regras

1. NUNCA pule a Fase 1 se não houver perfil global. O perfil calibra tudo o que vem depois.
2. NUNCA pergunte uma pergunta por vez quando o banco diz "apresente agrupados" — respeita o tempo do usuário.
3. NUNCA assuma — se uma resposta está ambígua, pergunte de volta antes de salvar.
4. NUNCA imponha stack ou arquitetura nesta skill — você é analista de negócio aqui, não arquiteto.
5. SEMPRE confirme antes de salvar em ~/.claude/CLAUDE.md global (é o arquivo do usuário).
6. SEMPRE termine com análise crítica (Regra de Ouro): o que foi gerado, o que ficou incompleto, qual o próximo passo.
7. Comportamento se já existe raw: se docs/raw/ já tem material (algum arquivo .txt/.md), LEIA primeiro e use como base — a skill REFINA o material existente em vez de duplicar.
8. Acentuação PT-BR sempre correta em todos os outputs (regra crítica do CLAUDE.md global).