/instalar

Executa a configuração inicial — entrevista curta (até 10 perguntas), preenche _memoria/* e identidade/design-guide.md, escolhe o perfil de CLAUDE.md, define o idioma de saída e cria .env. Use na primeira execução após clonar o repositório ou quando o usuário disser “primeiro setup”. Slash command — /instalar.

Como funciona

O que lê

• _memoria/empresa.md, _memoria/preferencias.md, _memoria/estrategia.md, identidade/design-guide.md (para checar se já têm conteúdo real)
• Nome da pasta atual do projeto
• templates/perfis/claude-md-agencia.md, claude-md-empresa.md, claude-md-freelancer.md, claude-md-solopreneur.md
• .env.example (nomes das variáveis)

Passos

1. Verificar se _memoria/* já tem conteúdo real; se sim, perguntar se é para sobrescrever ou complementar.
2. Perguntar qual perfil combina mais: agência, empresa, freelancer, solopreneur.
3. Conduzir a entrevista, uma pergunta de cada vez, até 10 perguntas: nome do negócio, o que entrega, cliente ideal, tamanho de equipa, um exemplo real de escrita do usuário, o que incomoda em texto genérico, gargalo atual do negócio, tarefa repetitiva que quer eliminar, dados de identidade visual (cores/fonte), existência de arquivo de logo. Resposta vaga: repetir a pergunta uma única vez pedindo algo mais concreto; na segunda resposta vaga, aceitar e seguir.
4. Perguntar em que idioma o negócio quer o conteúdo de saída (pt-BR ou en-US; default pt-BR) e gravar em ## Idioma de saída.
5. Preencher _memoria/empresa.md: ## Nome · ## Segmento · ## O que vende · ## Cliente ideal · ## Equipa · ## Ferramentas · ## Entregas principais · ## Mercado · ## Idioma de saída · ## Contexto adicional.
6. Preencher _memoria/preferencias.md: ## Tom de voz (derivado do exemplo real de escrita) · ## Evitar · ## Estilo · ## Formatos preferidos · ## Preferências adicionais.
7. Preencher _memoria/estrategia.md: ## Fase · ## Prioridade do trimestre (a partir do gargalo relatado) · ## Meta mensurável · ## Canais ativos · ## Prazos.
8. Preencher identidade/design-guide.md (## Cores · ## Tipografia · ## Estilo · ## Elementos · ## Nunca fazer · ## Logo · ## Observações) se houver dados de marca; senão deixar vazio e avisar uma vez — sem gravar aviso de “será preenchido depois” no arquivo.
9. Substituir CLAUDE.md da raiz pelo template do perfil escolhido em templates/perfis/, adaptado ao nome do negócio.
10. Criar .env a partir de .env.example, incluindo só as variáveis das integrações que o cliente confirmou ter — perguntar rapidamente quais integrações já existem, nunca pedir os valores em texto na conversa.
11. Mostrar um checklist do que foi configurado.
12. Se o nome da pasta ainda for genérico (variações de “nutek-os”/“nutekos”), sugerir renomear e dar os passos manuais.
13. Terminar com 3 comandos sugeridos: /abrir, /mapear-rotinas (para transformar a tarefa repetitiva relatada em automação), /salvar (backup).

O que grava

_memoria/empresa.md, _memoria/preferencias.md, _memoria/estrategia.md, identidade/design-guide.md (seções exatas acima), CLAUDE.md (raiz, substituído pelo template do perfil), .env (só os nomes de variável confirmados pelo cliente).

Aprovação do usuário

Implícita a cada resposta da entrevista; explícita só quando há conteúdo prévio em _memoria/* e é preciso decidir entre sobrescrever ou complementar.

Falha cedo

• Resposta vaga na 2ª tentativa: aceitar como veio, nunca inventar — gravar só o que foi dito, sem preenchimento especulativo.
• Sem dados de identidade visual: deixar identidade/design-guide.md vazio e avisar; /carrossel aplica defaults internos depois.
• templates/perfis/<perfil>.md correspondente ausente: parar e apontar o arquivo em falta, em vez de inventar um CLAUDE.md novo.

Verificação final

Os quatro arquivos de _memoria/ e identidade/ têm todas as seções exatas preenchidas ou deliberadamente vazias (nunca com “será preenchido depois”); CLAUDE.md da raiz deixou de ser o template genérico; .env existe no disco com os nomes de variável confirmados.