Promovaweb · Vitor Canoas · claude-mods (ctx & frota) · Omarchy · Hub Solia

🚀 Guia Prático: Como Iniciar um Projeto Hub (Promovaweb) + Colinha `claude-mods`

Baseado em como o adson-hub (Solia) foi criado em agentes-02:/home/dev-adson-site/adson-hub, na Colinha dos mods ctx e frota e no dossiê da conversa com o Vitor Canoas sobre o sistema operacional Omarchy ("opmarch").

📚 promovaweb.com/docs/ (Portal das Skills) ⚡ Colinha claude-mods (ctx e frota) 🖨️ Versão para Imprimir (Colinha) 🔗 Artifact Original (claude.ai) 🌐 Site Promovaweb 🐙 GitHub @promovaweb 🐧 Guia Omarchy (Vitor Canoas)

⚡ Jeito Mais Rápido (1 Comando + 1 Prompt no Claude Code)

Foi exatamente assim que você iniciou o adson-hub no dia 17/10:

1 Crie a pasta do novo Hub e abra o Claude Code nela

# 📍 Terminal SSH do servidor (Termius / VSCode)
mkdir -p ~/meu-novo-hub && cd ~/meu-novo-hub && git init -b main && claude

2 Cole este prompt no Claude Code

instala nessa pasta todo o ecossistema do link https://promovaweb.com/docs/ - não instale o setupvibe

Pronto! O Claude baixa e instala localmente em .tools/ os 6 projetos (MVPFy, Specsfy, Brandfy, Inboundfy, ClickUpfy e Astrofy) sem precisar de sudo.

📦 Os 7 Projetos em `promovaweb.com/docs/` (Onde ficam as Skills)

Ferramenta	Pacote NPM	Documentação Oficial	GitHub	O que faz no Hub
1. MVPFy	`@promovaweb/mvpfy`	promovaweb.com/docs/mvpfy/	promovaweb/mvpfy	Entrevista de até 8 perguntas (5 opções por turno) → gera `MVP.md` e `.mvpfy/` (15 skills).
2. Specsfy	`@promovaweb/specsfy`	promovaweb.com/docs/specsfy/	promovaweb/specsfy	Transforma o `MVP.md` em `PROJECT.md`, `DESIGNSYSTEM.MD`, `INTERFACE.md` e `specs/` (19 skills).
3. Brandfy	`@promovaweb/brandfy`	promovaweb.com/docs/brandfy/	promovaweb/brandfy	Cria marca, nome, paleta, fontes e logos SVG/PNG direto do `MVP.md` → gera `BRAND.md` e `brand/` (19 skills).
4. Inboundfy	`@promovaweb/inboundfy`	promovaweb.com/docs/inboundfy/	promovaweb/inboundfy	Produção de Inbound Marketing com IA em `.inboundfy/` (117 skills).
5. ClickUpfy	`@promovaweb/clickupfy`	promovaweb.com/docs/clickupfy/	promovaweb/clickupfy	Sincroniza épicos, sprints e tasks do Specsfy com o ClickUp (5 skills + MCP).
6. Astrofy	`@promovaweb/astrofy`	promovaweb.com/docs/astrofy/	promovaweb/astrofy	Criação e skills para sites/landing pages em Astro.
7. SetupVibe	`setupvibe.dev`	promovaweb.com/docs/setupvibe/	promovaweb/setupvibe	Provisionador de máquina/servidor (não vai dentro da pasta do projeto Hub).

🛠️ Passo a Passo Completo: Da Pasta Vazia até o Código Rodando

1 Instalar as CLIs localmente em `.tools/` (se quiser rodar via terminal)

# 📍 Terminal SSH no servidor
mkdir -p ~/meu-novo-hub/.tools ~/meu-novo-hub/projetos
cd ~/meu-novo-hub
git init -b main

npm --prefix .tools install --save-exact \
  @promovaweb/specsfy \
  @promovaweb/mvpfy \
  @promovaweb/brandfy \
  @promovaweb/clickupfy \
  @promovaweb/astrofy

export PATH="$PWD/.tools/node_modules/.bin:$PATH"
echo "export PATH=\"$PWD/.tools/node_modules/.bin:\$PATH\"" >> ~/.bashrc

2 Instalar as Skills dentro da pasta do Hub

# 📍 Terminal SSH (dentro de ~/meu-novo-hub)
mvpfy install --project .
brandfy install .
specsfy install --project . --detected
inboundfy install --agent claude --instruction-file CLAUDE.md --yes

Confira se está tudo verde rodando: mvpfy doctor && brandfy doctor && specsfy doctor.

3 Definir o MVP com o MVPFy (Gera o `MVP.md`)

Abra o Claude Code na pasta (claude) e chame a skill:

/mvpfy

Ele faz até 8 perguntas objetivas (com 5 opções numeradas em cada uma) e cria o MVP.md na raiz + estado em .mvpfy/.

4 Criar a Marca com o Brandfy (Gera o `BRAND.md` e `brand/`)

Ainda no Claude Code, rode:

/brandfy

Como o MVP.md já está na raiz, ele aciona automaticamente o brandfy-mvp e cria toda a identidade visual, cores, tipografia e logos sem repetir perguntas.

5 Transformar o MVP em Especificações e Tasks com o Specsfy

No Claude Code, rode na ordem:

# 1. Inicializa PROJECT.md, DESIGNSYSTEM.MD, INTERFACE.md e .specsfy/Spec.md:
/specsfy-setup

# 2. Lê o MVP.md e gera as Milestones e Specs do projeto:
/specsfy-mvp-milestone-interviewer

Depois, coloque os repositórios de código dentro de projetos/<nome-do-repo> e execute cada entrega usando a escada do Specsfy: /specsfy-01-inbox → /specsfy-02-backlog → /specsfy-03-specify → /specsfy-04-validate → /specsfy-05-tasks → /specsfy-06-tdd-bdd → /specsfy-07-implement.

⚡ Colinha dos Mods `ctx` e `frota` (`claude-mods`)

Conteúdo integrado do seu Artifact claude.ai/artifact/SYidTQTzLUP1CW5xdoC5T1 (também disponível em página avulsa pronta para impressão). Imprima e deixe no monitor: à esquerda, o token exato; à direita, o que ele significa.

📦 Como instalar os mods `ctx` e `frota` no Claude Code (≥ 2.1.292)

claude plugin marketplace add ~/Work/claude-mods
/plugin install ctx@claude-mods
/plugin install frota@claude-mods

📊 1. Linha de status (`ctx`)

▲ ctx: ctx 142k 14% · cache 41m● · hit 98% · 5h 34% · sem 41% · 2,1M tok

Token na tela	O que significa
`▲`	Moldura amarela do Claude Code. Não é alarme.
`ctx 142k 14%`	Contexto usado. Perto de 80%+, a compactação automática está próxima.
`cache 41m`	Minutos até o cache expirar.
`cache frio`	O cache já expirou.
`●`	Keepalive armado.
`✗`	Keepalive falhou e parou.
`hit 98%`	Quanto da última resposta veio do cache.
`5h` e `sem`	Limites usados (janela de 5 horas e semanal).
`2,1M tok`	Tokens gastos na sessão.
`!`	Atenção: ≥ 80% ou cache expirando.

⌨️ 2. Comandos dos mods

Comando	O que faz
`/fresco`	Mostra o status do keepalive em uma linha.
`/fresco auto`	Padrão. Aquece o cache só durante trabalho em segundo plano.
`/fresco on`	Mantém o cache sempre aquecido.
`/fresco off`	Nunca aquece.
`/ctx`	Abre o painel desta sessão. `Esc` fecha.
`/frota`	Abre o painel de agy e Luna na máquina.

🚢 3. Painel `/frota`

Indicador	O que significa
`•`	Job desta sessão.
`saída há 30s`	Tempo desde a última saída do job.
`⚠`	Saída congelada há mais de 10 minutos.
`✓ entregue`	Entregável com dados reais.
`cota agy · gemini 5h 98% · sem 97%`	Cota restante.
`cota agy · lendo…`	Lendo a cota.
`cota agy · indisponível`	Não foi possível ler a cota.

🧭 4. O que fazer (Ação rápida por sinal)

Situação	Ação recomendada
Trabalho em segundo plano	Procure o `●`.
Apareceu `✗`	Envie uma mensagem.
Apareceu `!`	Desacelere o Claude e use agy/Luna.
Apareceu `⚠`	Confira o log do job.

🐧 Resumo do Bate-Papo com Vitor Canoas: O que é o "Opmarch" (Omarchy)

Pessoa da conversa: Vitor Canoas (fundador da Promovaweb).
Sistema Operacional ("opmarch"): Omarchy (omarchy.org · promovaweb.com/omarchy/) — distribuição Linux criada pela Basecamp/DHH sobre Arch Linux + Hyprland (Wayland tiling window manager, versão 4.0 "Quattro" configurada em Lua ~/.config/hypr/hyprland.lua).
Onde estão os arquivos dessa conversa no seu HUB (/mnt/hub/):
- 📄 Briefing completo de 52 páginas do agente do Vitor para o seu agente: /mnt/hub/.firecrawl/omarchy-briefing-anderson-FINAL.parsed.md
- 💿 ISO do Omarchy 4.0.2 + Rufus: /mnt/hub/arquivo-pc-2026-09/omarchy/omarchy-4.0.2.iso
- 🧩 Mods/plugins do Vitor (ctx e frota): /mnt/hub/disson/vitor mod - instalar.zip
- 🏗️ Hub do Solia montado com o ecossistema Promovaweb: agentes-02:/home/dev-adson-site/adson-hub

⚡ Jeito Mais Rápido (1 Comando + 1 Prompt no Claude Code)

1 Crie a pasta do novo Hub e abra o Claude Code nela

2 Cole este prompt no Claude Code

📦 Os 7 Projetos em promovaweb.com/docs/ (Onde ficam as Skills)

🛠️ Passo a Passo Completo: Da Pasta Vazia até o Código Rodando

1 Instalar as CLIs localmente em .tools/ (se quiser rodar via terminal)

2 Instalar as Skills dentro da pasta do Hub

3 Definir o MVP com o MVPFy (Gera o MVP.md)

4 Criar a Marca com o Brandfy (Gera o BRAND.md e brand/)