Instalação e preparação

Disponibilizar skills ao agente não prepara o projeto. A primeira execução deve ser conduzida por inboundfy-setup, que usa o CLI para criar e conferir os arquivos.

Instalação rápida

Na raiz do projeto, faça primeiro uma simulação:

1
npx @promovaweb/inboundfy@latest install --dry-run

Depois instale escolhendo o agente e o arquivo de instruções:

1
npx @promovaweb/inboundfy@latest install \
2
  --agent codex \
3
  --instruction-file AGENTS.md \
4
  --yes

O CLI instala as skills no diretório usado pelo agente, copia o método para .inboundfy/framework/, cria a configuração viva, os diretórios de acervo, canais e calendário, os índices e o bloco do agente.

Arquivos canônicos do projeto

Preencha os arquivos operacionais em .inboundfy/ e os dados de empresa e copy em .inboundfy/context/:

1
.inboundfy/
2
├── estrategia.md
3
├── pipeline.md
4
├── context/
5
│   ├── empresa.md
6
│   ├── marca-voz.md
7
│   ├── publico.md
8
│   ├── glossario.md
9
│   ├── proibicoes.md
10
│   ├── links.md
11
│   └── aprendizado.md
12
└── indices/

O setup pergunta sobre empresa, produtos, serviços, endereços, pessoas, endereço físico, URLs oficiais, redes sociais, oferta, personas, voz, regras, aprendizados prévios, canais, calendário e estados. Antes de liberar produção, exige empresa, site, voz, uma persona completa, objetivo e pelo menos um canal.

Depois da entrevista, rode:

1
inboundfy project sync
2
inboundfy context ready --yes
3
inboundfy doctor --strict

Primeiro acervo

Registre o material sem edição. O texto original nunca é substituído:

1
inboundfy acervo add "Título do material" --file entrada.md
2
inboundfy acervo process 0001

O diretório numerado contém:

1
acervo/0001-AAAA-MM-DD-slug/
2
├── README.md
3
├── bruto.md
4
├── processado.md
5
├── faq.md
6
├── base-editorial.md
7
├── pesquisa.md
8
└── estrategia.md
9

10
auditorias/anti-slop/
11
├── 00-entrada.md
12
├── 01-processado.md
13
├── 02-base-editorial.md
14
├── 03-estrategia-brief.md
15
├── 04-rascunho.md
16
├── 05-peca.md
17
└── 06-pacote.md

As skills completam FAQ, base editorial, pesquisa e possibilidades de uso com o contexto do projeto, outras bases e pesquisa atualizada.

Primeira peça

Apresente as personas com número, ID, nome e detalhes de contexto, problema e resultado. Escolha uma ou mais antes de escrever. Crie a pasta final:

1
inboundfy content create blog "Título da peça" \
2
  --persona persona-01 --acervo 0001

O caminho segue canais/<canal>/<id>-<data>-<slug>/README.md. O frontmatter registra canal, persona, acervo, estado, datas e vínculos editoriais.

Use o pipeline e o calendário:

1
inboundfy calendario add 2026-09-20 0001
2
inboundfy content status 0001 revisao
3
inboundfy content digest 0001

Depois da auditoria final, acrescente ao relatório da validadora o ID, o caminho retornado pelo comando e o SHA-256 atual, neste formato:

1
- **ID da peça:** `0001`
2
- **Asset:** `canais/blog/0001-AAAA-MM-DD-titulo/README.md`
3
- **SHA-256 da peça:** `<hash de 64 caracteres retornado pelo CLI>`
4
- **Veredito:** aprovado

Use o caminho do relatório ao registrar a aprovação e o agendamento:

1
inboundfy content status 0001 aprovado \
2
  --audit-report 06-auditoria/assets/blog-0001.md
3
inboundfy content status 0001 agendado

O CLI recusa aprovação sem esse relatório, confere se ID, caminho e hash correspondem à peça e invalida a aprovação se o conteúdo mudar. Se houver correção posterior, retorne para revisao, repita a auditoria completa e atualize o relatório.

Antes de publicar, a peça passa por voz, persona, dicionário, proibições, anti-slop e validador do canal. A publicação exige URL e data:

1
inboundfy content status 0001 publicado \
2
  --url https://exemplo.test/artigo \
3
  --published-at 2026-09-20

Consulte a referência do CLI e dos estados para as passagens permitidas e as respostas completas dos comandos.

Atualização e reparo

Peça ao agente para executar inboundfy-setup quando a instalação precisar de atualização ou reparo. O CLI preserva dados preenchidos e registra customizações em .inboundfy/migracoes/.

1
npx @promovaweb/inboundfy@latest update --dry-run
2
npx @promovaweb/inboundfy@latest update --yes
3
npx @promovaweb/inboundfy@latest doctor --strict

Classificação