O projeto sabe o que é antes do primeiro commit.
A partir do escopo e dos mockups, a skill escreve tudo o que uma pessoa ou um agente precisa pra começar certo: o que o projeto é e o que não é, o roadmap, as decisões em aberto, os tokens de design reais. Nunca escolhe a stack e nunca escreve código.
npx skills add c0le0ni/skills --skill coleoni-init
Do escopo a um projeto que qualquer um abre.
A padaria da /coleoni-briefing continua aqui: o escopo e as notas de marca viram a documentação do projeto, e a documentação vira uma página.
# Juniper Bakery: scope (from /coleoni-briefing) ## 3. First release Order page (customers, on the phone) - Today's menu: name, photo, price, "available today" - Cakes: flavor, size, message, pickup date (48h+) - Checkout without an account, payment at pickup Day board (counter, on a tablet) - One list per day, grouped by pickup time - States: new, ready, picked up WhatsApp confirmation · One-page site ## 4. Out of scope (and why) Card payments ......... Square Photos and promotions . Instagram Wholesale orders ...... Google Sheet Loyalty ............... paper stamp card Delivery, online payment, reviews ... roadmap ## 9. Open questions 1. Who owns juniperbakery.com 2. Menu photos (not received) 3. Product list with prices 4. Cake rules 5. WhatsApp sender number 6. Budget range + brand notes: cream #F6F0E6, sage #2F4A3A, terracotta #C8643B, Fraunces + Inter
Documentação primeiro. Decisões com o time.
O que é pesado e difícil de desfazer (framework, banco, hospedagem, pagamento) vira um registro de decisão a preencher, nunca uma escolha feita por trás.
-
Lê o que foi decidido
O escopo, os mockups ou a marca, e o que já existe no repositório, que ela junta em vez de sobrescrever.
-
Escolhe os arquivos
Dez documentos, cada um com motivo pra existir. Nota de privacidade só quando há dado pessoal.
-
Escreve o guia dos agentes
AGENTS.mdem oito seções fixas, lido por Codex, Cursor e outros; oCLAUDE.mdaponta pra ele. -
Tira os tokens reais
Cores, tipografia, espaçamento e raio do material que o cliente aprovou. O que é chute vira “a confirmar”.
-
Deixa as decisões abertas
A stack é sempre o ADR-0001, marcado “a registrar”. A skill lista as decisões; o time toma.
-
Mostra tudo numa página
A visão geral lê a documentação e mostra fases, paleta, decisões e bloqueios, pro projeto caber numa tela.
O que todo projeto ganha.
Os mesmos nomes e a mesma estrutura em todo projeto, pra trocar de um pro outro não custar nada.
| Arquivo | O que tem |
|---|---|
AGENTS.md | O que é, o que não é, stack (pendente), identidade, estado, fluxo, regras, índice |
CLAUDE.md | Uma linha apontando pro AGENTS.md |
README.md | O que é e como rodar, quando a stack existir |
docs/ROADMAP.md | Fases marcadas como feita, agora ou depois; a fase 1 é sempre as decisões que travam |
docs/STATUS.md | Bloqueios do cliente no topo, depois o que foi entregue e como testar |
docs/design-system.md | Tokens de cor, tipografia, espaçamento e regras, do material aprovado |
docs/glossary.md | As palavras do cliente, uma linha cada |
docs/adr/ | Índice das decisões e o modelo pra registrar |
docs/privacy.md | Que dado pessoal, por quê, onde fica, quem vê e por quanto tempo |
docs/overview.html | A visão de tudo isso numa página |
Um comando, em qualquer agente.
Nada mais pra instalar. A página de visão geral só precisa do Node.js, sem pacotes e sem navegador.
npx skills add c0le0ni/skills --skill coleoni-init
/coleoni-init ./meu-projeto --write --overview
-g-a claude-code-a codexnpx skills add c0le0ni/skillsRode onde o escopo está.
Sem flags ela só mostra o plano. Nada é escrito até você pedir.
Ver o plano antes: arquivos, decisões e bloqueios.
/coleoni-init
Escrever a documentação e a página de visão geral.
/coleoni-init ./padaria --write --overview
Usar os mockups pros tokens.
/coleoni-init --write, tokens dos mockups/home.png e mockups/painel.png
A visão geral, pelo terminal.
Rode o scripts/overview.mjs de novo sempre que a documentação mudar; a página é sempre refeita a partir dela.
| Opção | Para quê |
|---|---|
<pasta do projeto> | Onde está a documentação |
--accent "#hex" | Cor de destaque. Padrão: o --accent dos tokens de design |
--out arquivo.html | Arquivo de saída. Padrão: docs/overview.html |
O primeiro commit já sabe pra onde vai.
npx skills add c0le0ni/skills --skill coleoni-init