Requisitos
O repositório de destino precisa estar acessível ao agente e usar um arquivo
AGENTS.md que possa receber o bloco gerenciado do Companify. O script de
setup usa Node.js 22 ou posterior e depende somente de módulos nativos.
Instale com o gerenciador de skills
Abra o terminal na raiz do projeto que receberá o plano de negócio e execute:
npx skills add promovaweb/companifyO comando instala o catálogo completo das 18 skills, num destino que varia
conforme o agente escolhido. A origem, o caminho e o hash de cada skill
ficam registrados em skills-lock.json do projeto consumidor.
Para listar o catálogo remoto antes de instalar, ou instalar apenas parte dele:
npx skills add promovaweb/companify --listnpx skills add promovaweb/companify --agent codex --skill '*' -y --copyPrepare o projeto
Depois de instalar as skills, execute o setup na raiz do projeto consumidor:
node <caminho-da-skill-instalada>/companify-setup/scripts/setup.mjs --project .O setup cria .companify/, prepara company/ e inclui um bloco delimitado
por <!-- companify:consumer:start --> e <!-- companify:consumer:end -->
no AGENTS.md. O conteúdo que já existir fora desses marcadores permanece
intacto. O script cria somente arquivos e diretórios ausentes, sem
sobrescrever .companify/ ou company/ já preenchidos.
Os arquivos criados são:
.companify/├── config.yaml├── company-context.md├── interview.md├── assumptions.md├── escolhas.md├── comprovacoes.md├── metrics.md├── ameacas.md└── reviews/
company/└── README.mdExecute novamente em modo de conferência:
node <caminho-da-skill-instalada>/companify-setup/scripts/setup.mjs --project . --checkO segundo comando comprova a idempotência e informa qualquer arquivo ou
diretório obrigatório que esteja ausente, ou um bloco do AGENTS.md
desatualizado. Confira as alterações no Git para confirmar que a escrita
ficou restrita aos caminhos previstos e só então avance.
Preencha a configuração
O arquivo .companify/config.yaml identifica a empresa, o país, o idioma, a
moeda e o estágio:
version: 1
company: name: "" country: BR language: pt-BR currency: BRL stage: idea
paths: workspace: .companify output: company brand: brandOs estágios possíveis são idea, validation, pre-revenue,
early-revenue, growth, scale e established. O estágio orienta
diretamente escolhas técnicas de outras skills, como a profundidade da
entrevista em $companify-interview e a arquitetura recomendada por
$companify-cto.
Escolha a entrada adequada
Quando o Company Context ainda tiver lacunas relevantes, comece com
$companify-interview. Quando o objetivo for construir o plano completo do
zero, use $companify-builder, que orquestra a esteira inteira e os quatro
gates. Uma tarefa de escopo menor pode chamar a especialidade correspondente
diretamente, por exemplo:
Use $companify-cfo para modelar o financeiro a partir do modelo de negócio jáaprovado.Quando a tarefa criar ou alterar uma marca em vez da empresa, use as skills
brandfy-* em vez do Companify. As duas bibliotecas leem os mesmos arquivos,
mas cada uma preserva os artefatos aprovados pela outra, veja
relação com o Brandfy.