launch-feature
/octopus:launch-feature é o comando que dispara quando uma feature é
entregue e alguém precisa contar pro mundo. Ele resolve a feature a partir de
um ID de roadmap, caminho de spec ou PR e produz um kit de lançamento
pronto pra revisão em docs/marketing/launches/.
O que resolve
Uma feature entregue que ninguém ouve é aquisição perdida. Transformar uma feature concluída em copy coerente para Instagram, LinkedIn, X, email, landing page, roteiro de vídeo e changelog comercial normalmente significa trocar de contexto entre ferramentas, re-explicar a feature pra cada canal e perder consistência no caminho.
launch-feature faz o assembly de contexto uma vez — lendo a spec, os docs
de pesquisa e o histórico de commits — e depois renderiza templates por canal,
opcionalmente gera imagens, e escreve todos os artefatos em um diretório
versionado único que você entrega pra um revisor.
Como funciona
- Resolução do ref — o comando aceita um ID de roadmap, caminho de spec ou
research, ou referência de PR. Segue qualquer cross-link na entrada do
roadmap pra puxar contexto de spec e research, e aumenta tudo com
git logescopado nos arquivos afetados. - Override cascade — voz de marca, definição de audiência, hashtags,
ângulos de hook e templates de caption são resolvidos primeiro a partir dos
overrides do repo em
docs/marketing/, com fallback para os defaults embutidos do Octopus. OREADME.mddo kit registra qual fonte foi usada pra cada override, pra que revisores saibam exatamente de onde veio cada decisão de estilo. - Renderização de canais — cada canal selecionado recebe seu próprio arquivo populado a partir de um template. Placeholders são sempre preenchidos; aqueles que não têm resposta fundamentada são removidos e marcados com um comentário inline indicando o que falta, em vez de ficarem como estão.
- Geração de imagens — se
GEMINI_API_KEYestá definida, imagens são geradas via Gemini e salvas como PNGs emimages/. Pollinations.ai é o fallback sem chave. Quando nenhum funciona,image-prompts.mdé gerado pra que as imagens possam ser criadas separadamente.
Toda a saída vai pra docs/marketing/launches/YYYY-MM-DD-<slug>/. Nada é
publicado automaticamente — o kit é um rascunho até um revisor assinar.
Uso & parâmetros
/octopus:launch-feature <ref> [--channels=a,b,c] [--dry-run] [--no-images] [--images-only] [--angle=<label>] [--force]<ref>— ID de roadmap, caminho de spec/research, ou referência de PR (#123/ URL completa do GitHub). Obrigatório.--channels=<lista>— subconjunto separado por vírgula deinstagram,linkedin,x,email,lp,changelog,video. Default: todos os canais aplicáveis cujo template ou override está disponível.--dry-run— imprime o conteúdo gerado no chat sem criar arquivos.--no-images— pula geração de imagens mesmo quando um provider está configurado.--images-only— regenera só as imagens; reutiliza artefatos de texto existentes no diretório de lançamento.--angle=<label>— força um ângulo de hook específico dos overrides de marca, pulando a seleção automática.--force— sobrescreve um diretório de lançamento existente pra mesma data/slug.
Dupla
/octopus:launch-feature cuida da aquisição — falar com novas audiências
sobre o que mudou. /octopus:launch-release cuida da retenção — anunciar o
mesmo release para usuários existentes através de canais temáticos e
versionados. Um lançamento completo geralmente usa os dois.