Configurar o Companify

Protocolo operacional

• Plano e progresso: criar um plano visível e atualizar o estado após a

inspeção, a configuração e a validação.

• Fontes de verdade: ler o AGENTS.md do projeto, os arquivos existentes

em .companify/ e company/, .brandfy/config.yaml quando existir, e a referência [agents-consumer.md](references/agents-consumer.md).

• Escopo e idempotência: preservar configurações e artefatos existentes.

O setup só cria arquivos e diretórios ausentes, substitui apenas o bloco Companify no AGENTS.md e, em arquivos templatizados já existentes (.companify/company-context.md, .companify/progresso.md), acrescenta ao fim de cada seção os campos Rótulo: que o template atual tem e o arquivo do usuário ainda não tem, e acrescenta ao fim do arquivo as seções ## inteiras que ainda não existem. Nunca remove, reordena ou reescreve seção, campo ou valor já preenchido pelo usuário.

• Validação: executar o setup com --check depois da escrita e revisar o

git diff.

• Resumo final: informar arquivos criados, arquivos preservados, estágio

configurado, validações e pendências.

Fluxo

1. Localizar a raiz do projeto e ler suas instruções.
2. Detectar Brandfy: verificar se .brandfy/config.yaml e brand/strategy.md

existem. Quando existirem, registrar na seção Brandfy do [template do Company Context](references/company-context-template.md) que o contexto de marca está disponível; quando não existirem, deixar explícito que o Companify está operando sem contexto de marca.

1. Executar:

``bash node <caminho-da-skill>/scripts/setup.mjs --project . ``

1. Abrir .companify/config.yaml e ajustar company.name, country,

language, currency e stage com o usuário. Estágios possíveis: idea, validation, pre-revenue, early-revenue, growth, scale, established.

1. Quando o briefing empresarial ainda estiver incompleto, usar

$companify-interview para conduzir a descoberta e preencher .companify/company-context.md sem inventar respostas.

1. Conferir o bloco delimitado por companify:consumer no AGENTS.md.
2. Conferir se .companify/progresso.md existe e, se o projeto já tinha um

.companify/ de uma versão anterior do Companify (sem esse arquivo), confirmar que o setup o criou: é o arquivo que toda skill companify-* usa para retomar uma entrevista sem repetir pergunta já respondida, veja [template do progresso](references/progresso-template.md).

1. Executar:

``bash node <caminho-da-skill>/scripts/setup.mjs --project . --check ``

Depois do setup, abrir .companify/config.yaml e company/README.md para confirmar o estágio e o status de cada artefato. Um segundo uso deve terminar sem alterações; qualquer diferença indica configuração incompleta ou bloco do agente antigo.

Raciocínio do especialista

Tratar o setup como preparação de governança, não como criação do plano de negócio. Confirmar responsáveis por respostas e aprovações, localização das comprovações, artefatos canônicos e forma de resolver pendências. Uma estrutura completa com informação fraca continua sendo um plano incompleto: o setup não deve ser confundido com o trabalho de $companify-interview.