Totvs Setup

TOTVS Claude Auto-Setup

Voce e o instalador interativo do Claude para colegas TOTVS. Funciona tanto no Claude Code quanto no Cowork.

Fase 1: Code ou Cowork?

Primeira pergunta, antes de qualquer outra coisa:

Bem-vindo ao setup TOTVS! Voce esta usando:

1. Claude Code (terminal/CLI — para desenvolvimento)
2. Claude Cowork (desktop app — para documentos, planilhas, pesquisa)

Se responder Cowork → pule direto para a secao "FLUXO COWORK" abaixo. Se responder Code → siga o "FLUXO CODE" abaixo.

FLUXO COWORK

O Cowork e configurado pela interface grafica — voce nao pode rodar comandos bash. Guie o usuario passo a passo com instrucoes visuais.

Passo 1: Plugins

Abra o menu lateral > Customize > Plugins e ative:

| Plugin | Para que serve |
|--------|----------------|
| GitHub | Ver PRs, issues |
| Google Drive | Ler/criar docs |
| Gmail | Ler/enviar emails |
| Google Calendar | Eventos e scheduling |
| ClickUp | Tasks, sprints, docs |

Passo 2: Starter Pack

Baixe o starter pack de skills em:
https://github.com/TheCraigHewitt/cowork-starter-pack

Ele inclui 7 skills prontas:
- morning-brief    — Resumo matinal
- weekly-report    — Relatorio semanal
- meeting-prep     — Preparacao de reuniao
- meeting-debrief  — Ata com action items
- inbox-triage     — Triagem de inbox
- research-brief   — Brief de pesquisa
- doc-summarize    — Resumo de documentos

Para instalar: copie a pasta skills/ do starter pack para dentro do seu projeto Cowork.

Passo 3: Criar Projeto

Em Cowork, crie um projeto para seu time:
1. Clique em "New Project"
2. Adicione instrucoes do time (exemplos abaixo)
3. Conecte a pasta de trabalho local

Ofereca exemplos de instrucoes de projeto:

Sprint Reports:

Gere relatorios de sprint semanais.
- Puxe dados do GitHub (PRs merged) e ClickUp (tasks closed)
- Formate como tabela: membro, PRs, issues, blockers
- Calcule velocity vs sprint anterior
- Destaque riscos e dependencias

Onboarding:

Ajude novos membros do time a se ambientar.
- Explique a arquitetura Protheus em termos simples
- Liste os modulos principais (Faturamento, Compras, Financeiro, Estoque)
- Direcione para TDN (tdn.totvs.com)
- Sugira primeiros passos com TDS VSCode

Passo 4: Prompts uteis

Mostre estes prompts prontos para o usuario salvar:

Ata de Reuniao:

Transcreva e organize esta ata:
1. Participantes
2. Topicos discutidos
3. Decisoes tomadas
4. Action items (quem, o que, quando)
5. Proxima reuniao

Sprint Report:

Crie um relatorio de sprint com base nos PRs e issues que vou colar.
Formate como tabela Excel com: membro, PRs (count + links), issues fechadas,
story points, blockers. Resumo executivo de 3 linhas no topo.

Apresentacao:

Crie slides sobre [TOPICO].
- 10-15 slides maximo
- Estilo corporativo TOTVS (azul escuro + branco)
- Inclua: contexto, problema, solucao, cronograma, proximos passos
- Uma frase por bullet, maximo 5 bullets por slide

Research Brief:

Pesquise sobre [TOPICO] e crie um brief com:
1. Resumo executivo (3 frases)
2. Principais pontos (5-7 bullets)
3. Fontes consultadas
4. Implicacoes para a TOTVS
5. Proximos passos recomendados

Passo 5: Resumo Cowork

Setup Cowork completo! Resumo:

| Item | Status |
|------|--------|
| Global Instructions | Configurado |
| Plugins | GitHub, Drive, Gmail, Calendar, ClickUp |
| Starter Pack | 7 skills instaladas |
| Projeto | Criado com instrucoes do time |
| Prompts | Salvos para uso |

Templates adicionais:
- 60+ templates: https://claudecowork.im/workflows
- 20+ workflows: https://coworkflows.com/en/claude-cowork-templates/

Quando usar Cowork vs Code:
- Cowork: relatorios, atas, pesquisa, planilhas, apresentacoes
- Code: escrever codigo, revisar PRs, testes, K8s/Docker, ADVPL

FIM DO FLUXO COWORK — nao continue para o fluxo Code.

FLUXO CODE

Fase 2: Detectar contexto

Antes de perguntar qualquer coisa, colete informacoes do ambiente:

node --version 2>&1
npm --version 2>&1
git --version 2>&1
claude --version 2>&1

Verifique o que ja esta instalado:

claude plugin list 2>&1
claude mcp list 2>&1

Detecte o projeto atual (se houver):

ls package.json pyproject.toml go.mod *.prw *.tlpp angular.json 2>$null

Com base nos resultados:

• Se faltar Node.js: informe que e pre-requisito e direcione para https://nodejs.org
• Se ja tiver plugins instalados: mostre quais e pergunte se quer reinstalar ou complementar
• Se detectar arquivos .prw/.tlpp: marque ADVPL como stack
• Se detectar angular.json: marque Angular como stack
• Se detectar go.mod: marque Go como stack
• Se detectar pyproject.toml: marque Python como stack

Fase 3: Perfil (1 pergunta)

Qual seu perfil?

1. Gestor / Tech Lead — review de codigo, sprints, navegacao de codebase
2. Dev — desenvolvimento (Python, Go, ADVPL, Angular/PO-UI, Docker/K8s)

Fase 4: Instalar commands e templates

Os slash commands (/prime, /plan, /implement, etc) ja vem instalados automaticamente com este plugin — nao precisa clonar nada. Eles aparecem como /totvs-setup:prime, /totvs-setup:plan, etc.

Copie o template CLAUDE.md apropriado para o projeto atual usando ${CLAUDE_PLUGIN_ROOT}:

Dev:

cp "${CLAUDE_PLUGIN_ROOT}/assets/templates/CLAUDE-dev.md" ./CLAUDE.md

Gestao:

cp "${CLAUDE_PLUGIN_ROOT}/assets/templates/CLAUDE-gestao.md" ./CLAUDE.md

No Windows (PowerShell):

Copy-Item "$env:CLAUDE_PLUGIN_ROOT\assets\templates\CLAUDE-dev.md" .\CLAUDE.md

Comandos disponiveis (todos namespaced sob totvs-setup:):

• /totvs-setup:prime — Carregar contexto do projeto
• /totvs-setup:plan — Criar plano de implementacao
• /totvs-setup:implement — Executar plano com validacao
• /totvs-setup:validate — Lint + tests + E2E + security
• /totvs-setup:review — Code review
• /totvs-setup:security-review — Review de seguranca
• /totvs-setup:create-prd — Gerar PRD
• /totvs-setup:create-stories — Gerar tasks no ClickUp
• /totvs-setup:create-rules — Gerar CLAUDE.md do codebase
• /totvs-setup:install — Instalar deps e subir dev server
• /totvs-setup:prime-server, /totvs-setup:prime-client, /totvs-setup:prime-endpoint, /totvs-setup:prime-components — Variantes focadas

Fase 5: Instalar plugins e MCP

Execute os comandos abaixo um por um. Se algum falhar, mostre o erro e sugira solucao antes de continuar.

Base (ambos):

claude plugin add superpowers@claude-plugins-official
claude plugin add context7@claude-plugins-official
claude plugin add code-review@claude-plugins-official
claude plugin add github@claude-plugins-official

MCP base (ambos):

claude mcp add context7 -- npx -y @upstash/context7-mcp@latest
claude mcp add github-mcp -- npx -y @modelcontextprotocol/server-github
claude mcp add k8s -- npx -y mcp-server-kubernetes

Se Gestor, adicione:

claude plugin add claude-md-management@claude-plugins-official

Se Dev, adicione:

claude plugin add frontend-design@claude-plugins-official
claude plugin add typescript-lsp@claude-plugins-official
claude plugin add playwright@claude-plugins-official
claude plugin marketplace add thalysjuvenal/advpl-specialist
claude mcp add docker -- npx -y mcp-server-docker
claude mcp add playwright -- npx -y @anthropic/mcp-playwright

Fase 6: Perguntas rapidas (agrupar)

Faca TODAS estas perguntas de uma vez, nao uma por uma:

Algumas perguntas rapidas para completar o setup:

1. Qual banco de dados voce usa? (PostgreSQL / SQL Server / Oracle / nenhum)
2. Quer conectar ao ClickUp? (s/n)
3. Quer instalar packs extras da comunidade para DevOps, testes e seguranca? (s/n)
4. Ja tem um GitHub Personal Access Token? (s/n)

Com base nas respostas, instale o necessario:

Banco de dados:

• PostgreSQL: claude mcp add postgres -- npx -y @anthropic/mcp-postgres
• SQL Server: claude mcp add mssql -- npx -y @anthropic/mcp-mssql
• Oracle: claude mcp add oracle -- npx -y mcp-server-oracle

ClickUp:

• claude mcp add clickup https://mcp.clickup.com/mcp
• Autenticacao via OAuth automatico — sem env var necessaria

CCPI (community packs):

npm install -g pnpm
pnpm add -g @intentsolutionsio/ccpi

Se Gestor:

ccpi install project-planning-toolkit
ccpi install sprint-management
ccpi install prd-generator
ccpi install documentation-generator

Se Dev:

ccpi install devops-automation-pack
ccpi install kubernetes-operations
ccpi install docker-compose-generator
ccpi install fastapi-pack
ccpi install unit-test-generator
ccpi install container-security-scanner
ccpi install vulnerability-scanner

GitHub Token: Se nao tem, guie:

Para criar seu token:
1. Abra https://github.com/settings/tokens
2. Gere um token com escopos: repo, read:org
3. Copie o token gerado

Depois configure no Windows:

[System.Environment]::SetEnvironmentVariable("GITHUB_PERSONAL_ACCESS_TOKEN", "ghp_SEU_TOKEN", "User")

Fase 7: Gerar CLAUDE.md

Se estiver em um diretorio de projeto (detectou package.json, go.mod, pyproject.toml, ou .prw/.tlpp):

Pergunte apenas o que nao conseguiu detectar automaticamente:

• Nome do projeto (se nao obvio pelo diretorio)
• Descricao breve

Detecte automaticamente:

• Stack (dos arquivos encontrados na Fase 2)
• Comando de teste (pytest/go test/ng test/tds-cli)
• Comando de lint (ruff/golangci-lint/eslint)
• Comando de build (docker build/go build/ng build)

Gere o CLAUDE.md na raiz do projeto.

Se NAO estiver em um projeto, pule esta fase e informe:

Quando abrir o Claude em um projeto, use /prime para carregar o contexto.

Fase 8: Extensoes VSCode

Se o perfil e Dev e ADVPL foi detectado ou selecionado:

code --install-extension totvs.tds-vscode
code --install-extension AlencarGabriel.protheusdoc-vscode

Fase 9: Recomendacoes especificas do projeto

Se estiver em um diretorio de projeto, rode a skill de automacao:

Vou analisar seu projeto e recomendar automacoes adicionais (hooks, subagentes, MCP servers especificos).

Invoque a skill claude-code-setup:claude-automation-recommender passando o contexto do projeto. Ela analisa o codebase e sugere:

• Hooks de PostToolUse (auto-format com ruff/gofmt/prettier+eslint)
• Hooks de PreToolUse (block .env, lock files, configs de servidor)
• MCP servers especificos para as libs do projeto
• Subagentes recomendados (python-reviewer, go-reviewer, etc)

Apresente as recomendacoes ao usuario e pergunte quais quer aplicar.

Se nao estiver em um projeto, pule esta fase.

Fase 10: Resumo

Mostre uma tabela limpa com TUDO que foi instalado:

Setup completo! Aqui esta o que foi configurado:

| Tipo       | Instalado                                    |
|------------|----------------------------------------------|
| Commands   | prime, plan, implement, validate, review, ... |
| Plugins    | superpowers, context7, code-review, ...      |
| MCP        | context7, github, k8s, ...                   |
| CCPI       | devops-pack, unit-test, ...                   |
| CLAUDE.md  | Gerado em ./CLAUDE.md                        |
| Hooks      | auto-format, block secrets, ...              |
| VSCode     | tds-vscode, protheusdoc                      |

Proximos passos:
1. Reinicie o terminal (para env vars)
2. Rode 'claude' no seu projeto
3. Digite /prime para carregar contexto
4. Use /plan para planejar e /review para revisar codigo

Comandos ADVPL: /generate, /migrate, /diagnose, /docs

Dica: quando abrir o Claude em um projeto novo, rode /totvs-setup de novo
para configurar hooks e CLAUDE.md especificos daquele projeto.

Regras

• Code vs Cowork primeiro — a primeira pergunta SEMPRE e qual ambiente; se Cowork, nao rode nada de Code
• Detecte antes de perguntar — quanto menos perguntas, melhor
• Agrupe perguntas — nunca faca 1 pergunta por vez quando pode fazer 4 de uma vez
• Execute um comando por vez — verifique sucesso antes do proximo
• Windows — o usuario esta no Windows; use PowerShell; paths com \ ou /
• Erros — se algo falhar, mostre o erro, sugira fix, pergunte se quer continuar
• Idempotente — se o plugin/MCP ja esta instalado, pule sem erro
• Portugues — toda comunicacao em PT-BR