Do briefing bagunçado a um escopo que se sustenta.
A skill lê tudo o que o cliente mandou e decide o que vai ser feito: a dor única que justifica o projeto, uma primeira entrega que resolve essa dor, e o que fica de fora, citando a ferramenta que já faz o trabalho.
npx skills add c0le0ni/skills --skill coleoni-briefing
O que entra e o que sai.
Uma padaria fictícia pediu “um app igual aos grandes de delivery”. As respostas mostraram um problema menor: encomendas de bolo perdidas no WhatsApp.
WHAT DO YOU WANT TO BUILD? An app like the big delivery platforms, where customers order, pay, track the driver, earn points, leave reviews. Also a website. Maybe a page for wholesale clients. HOW DO CUSTOMERS ORDER TODAY? Mostly WhatsApp. On Saturdays we get 60 to 90 messages before 10am. WHAT WENT WRONG RECENTLY? Last Saturday we forgot two cake orders that were buried in the chat. One was for a birthday. We refunded and lost the customer. This happens every few weeks. WHAT TOOLS DO YOU ALREADY USE? - Square for the card machine and payments in the shop. - Instagram for photos and promotions (8k followers). - A Google Sheet with wholesale standing orders. It works fine. NICE TO HAVE? Loyalty points, delivery with our own driver, reviews, gift cards, wholesale portal, an app in the stores. DEADLINE? 7 weeks. BUDGET? Not sure yet. Small. CALL NOTES - Repeated the forgotten cakes story twice. - Delivery: "maybe next year, we only have one car". - Loyalty: paper stamp card "works ok". - Menu photos: "I'll forward them" (not received). - Domain: not sure who registered it.
Seis perguntas antes de qualquer funcionalidade.
O cliente descreve o produto que imagina. As respostas dele mostram o problema que ele tem. A skill constrói pras respostas.
-
Lê tudo
Formulário, anotações de call, e-mails e conversas exportadas, antes de decidir qualquer coisa.
-
Acha a dor única
O problema que sozinho justifica o projeto, citado das respostas do próprio cliente.
-
Mantém o que já funciona
Cada ferramenta que o cliente cita continua com a função dela. O escopo diz o nome quando corta.
-
Primeira entrega, depois roadmap
Só o que resolve a dor sai primeiro. O resto espera, numa ordem sugerida.
-
Pergunta, nunca chuta
Resposta faltando ou vaga vira pergunta em aberto, na ordem do que trava o início.
-
Confere o prazo
Uma leitura honesta se cabe ou não, e o que mais ameaça.
Dez seções, dez minutos de leitura.
Cada item da primeira entrega volta a alguma coisa que o cliente disse. A seção 4 é a que protege o prazo.
| Seção | O que tem |
|---|---|
| 1. Resumo | Como funciona hoje, o que muda e o projeto numa frase |
| 2. O problema | A dor que justifica, nas palavras do cliente, e quais dores esperam |
| 3. Primeira entrega | Páginas, telas e fluxos, com campos e ações concretos |
| 4. Fora do escopo | O que fica nas ferramentas que o cliente já usa, e por quê |
| 5. Quem usa | Cada perfil e o que faz na primeira entrega |
| 6. Roadmap | O que vem depois, em ordem, com o motivo da espera |
| 7. Requisitos | Só o que o projeto precisa: LGPD, aparelhos, idiomas, velocidade |
| 8. Prazo | A meta, se cabe e a maior ameaça |
| 9. Perguntas em aberto | O que falta, começando pelo que trava o trabalho |
| 10. Abordagem sugerida | Plataforma ou stack, escolhida pela velocidade e por quem vai manter |
Um comando, em qualquer agente.
O escopo não precisa de mais nada. Pro PDF, o agente instala o marked e o playwright-core no primeiro uso e imprime com o Chrome ou o Edge que você já tem.
npx skills add c0le0ni/skills --skill coleoni-briefing
/coleoni-briefing briefing/respostas.csv
-g-a claude-code-a codexnpx skills add c0le0ni/skillsAponte pro que o cliente mandou.
Um arquivo, uma pasta ou o texto colado no chat. Responde no seu idioma e escreve o escopo no idioma do briefing.
Revisar o escopo no chat, sem escrever nada.
/coleoni-briefing cliente/respostas.csv
Salvar o escopo ao lado do briefing.
/coleoni-briefing anotacoes.md --write
Um PDF pronto pro cliente, com sua cor e sua logo.
/coleoni-briefing briefing/ --pdf, cor #2f6fed, logo assets/logo.svg
O PDF do seu jeito.
Pelo agente você não precisa decorar nada. No terminal, o scripts/render.mjs aceita estas.
| Opção | Para quê |
|---|---|
--out docs/ | Pasta de saída. Padrão: ao lado do markdown |
--accent "#2f6fed" | Cor dos números, das linhas e do destaque da frase |
--logo logo.svg | Logo do estúdio na capa (svg, png ou jpg) |
--by "Estúdio" | Quem preparou, na capa e no rodapé |
--lang en|pt | Idioma dos rótulos da capa. Padrão: detectado |
--no-pdf | Só o HTML autossuficiente |
O próximo projeto começa por uma dor.
npx skills add c0le0ni/skills --skill coleoni-briefing