Onboarding — setup de um dev novo¶
O que é¶
O que o git clone não te dá: o repo já traz tudo que é versionado (skills, agentes, o
grafo, o enable dos plugins, os hooks). Mas algumas coisas são por-máquina/por-dev (binário
de CLI, git hooks, chaves) e você configura uma vez ao entrar no projeto. Ordem sugerida:
1→2 obrigatórios pra rodar o repo; 3→6 conforme for tocar aquela parte.
1. Base do monorepo¶
pnpm install # instala todos os workspaces
pnpm up # sobe o stack local (Supabase + Redis + apps) via Docker
2. graphify — CLI + git hooks são por-máquina¶
O grafo (graphify-out/) vem no clone, mas a CLI e os git hooks (que rebuildam a cada
commit) não. Rode uma vez: bash scripts/setup-graphify.sh. Detalhe: codebase-grafo.
3. mem0 — sua própria API key¶
O plugin já vem ligado pelo repo (escopo project). Só falta a sua key individual como
env MEM0_API_KEY em .claude/settings.local.json (gitignored, por-dev). Vale na próxima
sessão. Nunca committar a key. Detalhe: mem0.
4. Design system + prototipagem (só se for mexer em UI)¶
npx impeccable install → /impeccable init (escolha "product"). O DESIGN.md é
único, na raiz do monorepo (compartilhado por todos os apps — cada app symlinka
apps/<app>/DESIGN.md → ../../DESIGN.md); o PRODUCT.md é por app. Conecte também o
shadcn MCP no .mcp.json. Prototipagem opcional: Claude Design (/design-sync). Detalhe:
impeccable.
5. TestSprite (só se for gerar e2e)¶
MCP local + 2 secrets no GitHub (a Action roda contra staging). Detalhe: testsprite.
6. MCPs que autenticam por-dev¶
Linear, Sentry, PostHog, Supabase (local aponta pra localhost:54321) — conecte os que for
usar.
Modelo & effort¶
Padrão de sessão recomendado: Opus 4.8 (/model). Régua completa: reguas-modelo-effort.
TL;DR¶
pnpm install && pnpm up → bash scripts/setup-graphify.sh → põe a MEM0_API_KEY no
settings.local.json. O resto (impeccable/TestSprite/MCPs) só quando a tarefa pedir.
Relacionado¶
codebase-grafo · mem0 · impeccable · testsprite · reguas-modelo-effort · visao-geral