# Instalação e configuração do /planejar

Guia de auto-instalação para o Claude executar sozinho, no terminal. Siga a ordem abaixo. Depois de cada bloco, rode a verificação indicada antes de seguir pro próximo — se algo falhar, pare e avise o usuário em vez de continuar. Dois blocos (Firecrawl e Wrangler) abrem o navegador pedindo autorização — isso é esperado, avise o usuário que ele precisa clicar em "Allow" lá; não é possível automatizar essa parte.

## Antes de começar

Firecrawl e Context7 autenticam por **OAuth no navegador** — não precisam de chave copiada e colada. Só avise o usuário que, quando os blocos 2 e 3 abrirem o navegador, ele precisa entrar/autorizar lá (conta grátis, criada na hora se ele não tiver uma). Se ele já tiver uma `FIRECRAWL_API_KEY` (`fc-...`) e preferir usá-la em vez de logar de novo, tudo bem também — pergunte isso uma vez, no início, não no meio do processo.

## 1. Skill de descoberta (find-skills)

```bash
npx skills add https://github.com/vercel-labs/skills --skill find-skills -g
```

**Verificação:** confirme que o comando terminou sem erro. Essa skill é usada por você mesmo mais adiante, não precisa de teste funcional agora.

## 2. Firecrawl (CLI + MCP + skills)

Leia e siga as instruções de **https://www.firecrawl.dev/agent-onboarding/SKILL.md** — esse arquivo te guia pela instalação completa (CLI, MCP e skills) e pelo login, incluindo abrir o navegador quando precisar de autorização.

Use a chave do usuário se ele já tiver uma (`FIRECRAWL_API_KEY: fc-...`); senão, siga o fluxo de login por navegador que o próprio guia descreve.

**Verificação:** rode `firecrawl --status` (ou equivalente indicado no guia). Se não responder, pare e diga ao usuário o que faltou antes de seguir.

## 3. Context7 (OAuth) + plugins do Claude Code

Primeiro o Context7, pelo instalador oficial dele — faz login por OAuth no navegador, gera a chave sozinho e já instala a skill certa, sem precisar copiar nada:

```bash
npx ctx7 setup --claude
```

Depois os outros dois plugins, em sequência:

```bash
claude plugin marketplace add obra/superpowers-marketplace
claude plugin install superpowers@superpowers-marketplace

claude plugin marketplace add cloudflare/skills
claude plugin install cloudflare@cloudflare
```

**Verificação:** rode `claude plugin list` (ou equivalente) e confirme que superpowers e cloudflare aparecem instalados; para o Context7, confirme que o setup terminou sem erro (ele mesmo informa quando autenticou). Plugins só ficam ativos depois que o Claude reinicia — avise o usuário disso no checklist final, não tente contornar reiniciando você mesmo.

## 4. Wrangler (CLI da Cloudflare)

```bash
npm install -g wrangler
wrangler login
```

O `wrangler login` abre o navegador pedindo autorização — avise o usuário que ele precisa clicar em "Allow" lá.

**Verificação:** rode `wrangler whoami`. Se retornar a conta do usuário, está autenticado.

## 5. As seis skills principais (baixe direto, sem precisar de anexo)

Cada `.skill` é um zip hospedado na mesma pasta de onde veio este onboarding.md. Pegue a URL que o usuário te passou pra este arquivo, tire o `onboarding.md` do final — essa é a `<BASE_URL>` (ex.: se você recebeu `https://exemplo.com/instalar-planejar/onboarding.md`, `<BASE_URL>` é `https://exemplo.com/instalar-planejar`).

Baixe e instale globalmente cada um dos seis arquivos abaixo — exatamente como faria se o usuário tivesse anexado o arquivo `.skill` na conversa e pedido pra instalar. Escolha você mesmo o comando certo pro sistema operacional que está rodando agora (no Windows/PowerShell, `unzip` não existe — use `Expand-Archive`; no Mac/Linux, `curl` + `unzip` funcionam):

- `<BASE_URL>/planejar.skill`
- `<BASE_URL>/search.skill`
- `<BASE_URL>/cloudflare-atlas.skill`
- `<BASE_URL>/cloudflare-forum.skill`
- `<BASE_URL>/design-lab.skill`
- `<BASE_URL>/design-taste-frontend.skill`

Todos vão pra `~/.claude/skills/` (no Windows, `%USERPROFILE%\.claude\skills\`), cada um na sua própria pasta com o nome da skill. Não importa a ordem.

**Se alguma pasta já existir**, é reinstalação — avise que vai sobrescrever pela versão mais nova e confirme com o usuário antes de continuar, em vez de sobrescrever calado.

**Verificação:** confirme que as seis pastas existem em `~/.claude/skills/` (`planejar`, `search`, `cloudflare-atlas`, `cloudflare-forum`, `design-lab`, `design-taste-frontend`).

## No final

Devolva ao usuário um checklist único com ✅ ou ❌ para cada um dos cinco blocos acima (não item por item dentro do bloco — o bloco inteiro). Para todo ❌, explique em uma frase o que faltou e o que o usuário precisa fazer. Se tudo estiver ✅, diga que ele já pode fechar e abrir o Claude de novo antes de rodar o `/planejar` — os plugins só valem depois de reiniciar.