Promovaweb · Vitor Canoas · Omarchy · Hub Solia

🚀 Guia Prático: Como Iniciar um Projeto Hub (Promovaweb)

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

📚 promovaweb.com/docs/ (Portal das Skills) 🌐 Site Promovaweb 🐙 GitHub @promovaweb 🐧 Guia Omarchy (Vitor Canoas) 🖥️ omarchy.org

⚡ 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.

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