Pular para o conteúdo
Triadeflow Docs

Como usar com Claude Code

Este repositorio foi desenhado para ser lido pelo Claude Code (CLI da Anthropic) e transforma-lo em engenheiro especialista da plataforma Triadeflow, conhecendo arquitetura, agentes, integracoes e processos.

Setup inicial

Terminal window
# Clone o repositorio
git clone git@github.com:triadeflow-ia/triadeflow-docs.git
cd triadeflow-docs


# Inicie Claude Code aqui
claude

Ao iniciar, Claude Code automaticamente:

  1. Le CLAUDE.md da raiz (contexto mestre)
  2. Carrega arquivos de .claude/ conforme necessario
  3. Conecta aos MCPs configurados em .mcp.json (Asana, Notion, Drive, GitHub, etc)
  4. Reconhece slash commands em .claude/commands/

A partir desse ponto, ele opera como engenheiro especialista da Triadeflow.

Em outros repositorios da organizacao

Os repositorios triadeflow-core, agent-sdr, agent-vendas, etc devem ter um CLAUDE.md curto que aponta para este repositorio:

# CLAUDE.md (em outro repo da organizacao)


Este repositorio faz parte da plataforma Triadeflow.


Contexto completo da plataforma:
https://github.com/triadeflow-ia/triadeflow-docs


Documentacao visual:
https://triadeflow.dev


Antes de qualquer alteracao, leia:
- triadeflow-docs/CLAUDE.md
- triadeflow-docs/.claude/agents/{tipo-deste-agente}.md
- triadeflow-docs/.claude/conventions.md

Claude Code seguira o link e carregara o contexto da plataforma alem do contexto especifico do agente.

Slash commands disponiveis

Comandos predefinidos que voce pode invocar:

/novo-cliente

Cria estrutura completa de tenant novo. Pergunta as informacoes faltantes e segue o workflow .claude/workflows/novo-cliente.md.

/novo-cliente Dra. Camila Borges agendamento saude evolution

/investigar-trace

Analisa trace problematico do Langfuse e propoe fix.

/investigar-trace trace_id=abc123

/otimizar-custo

Sugere otimizacoes de custo em ordem do mais seguro pro mais arriscado.

/otimizar-custo usa-salus

/auditar-config

Audita config.yaml de tenant contra boas praticas.

/auditar-config petisco

Exemplos de uso

Criar cliente novo

"Cria um novo cliente - Dra. Camila Borges, agente de agendamento,
nicho saude, integrado com Doctoralia, tom acolhedor"

Claude Code:

  1. Confirma o que entendeu
  2. Le o playbook novo-cliente.md
  3. Le a spec agents/agendamento.md
  4. Le o playbook playbooks/saude.md
  5. Cria estrutura de pastas, config, KB inicial
  6. Configura mensageria e CRM
  7. Faz deploy
  8. Documenta no Notion (via MCP)
  9. Cria projeto Asana (via MCP)
  10. Retorna resumo com proximos passos

Investigar problema

"O cliente Reverso Academy esta com custo 3x acima do normal
nos ultimos 3 dias, investiga"

Claude Code:

  1. Coleta metricas no Langfuse
  2. Analisa traces representativos
  3. Identifica causa raiz (top_k inflado, prompt sem cache, etc)
  4. Propoe fix mais barato e seguro primeiro
  5. Roda eval para validar
  6. Faz deploy se aprovado
  7. Documenta em .claude/reference/incidentes.md

Criar tipo de agente novo

"Cria a spec do agent-prospeccao seguindo o padrao dos Tier 1.
Foco: prospectar leads B2B em LinkedIn + cold outbound automatizado"

Claude Code:

  1. Le specs existentes de Tier 1 como referencia
  2. Cria .claude/agents/prospeccao.md com estrutura padrao
  3. Sugere repository setup via gh CLI
  4. Recomenda primeiro tenant piloto
  5. Atualiza catalogo central
  6. Cria entrada em ADRs justificando o tipo novo

Arquivos que Claude Code le automaticamente

ArquivoQuando le
CLAUDE.mdSempre, ao iniciar sessao
.claude/conventions.mdAntes de gerar codigo
.claude/architecture.mdEm decisoes arquiteturais
.claude/stack.mdAo escolher tecnologia
.claude/agents/{tipo}.mdAo trabalhar em agente especifico
.claude/playbooks/{nicho}.mdAo configurar tenant de nicho
.claude/integrations/{plataforma}.mdAo integrar com plataforma
.claude/workflows/{processo}.mdAo executar workflow
.claude/commands/{comando}.mdAo invocar slash command
.mcp.jsonSempre, configura MCPs disponiveis

MCPs configurados

O .mcp.json configura conexoes para:

  • Asana - projetos, tarefas, status (workspace Triadeflow)
  • Notion - documentacao interna, runbooks, KB
  • Google Drive - assets de cliente, contratos, propostas
  • Google Calendar - integracao para agentes de agendamento
  • Gmail - comunicacao com clientes
  • GitHub - operacoes em repositorios da org triadeflow-ia
  • Kommo - operacoes nos CRMs Kommo dos clientes (MCP proprio)
  • Stripe - cobranca recorrente
  • n8n - workflows existentes em transicao
  • Fireflies - transcricoes de reunioes

Voce nao precisa autorizar manualmente - eles ja estao configurados e Claude Code os usa quando relevante.

Boas praticas

  1. Confie no contexto: o CLAUDE.md e o .claude/ foram desenhados para serem suficientes. Nao copie/cole texto desnecessario na conversa.

  2. Use comandos: /novo-cliente e mais eficiente que descrever todo workflow textualmente.

  3. Atualize a documentacao: quando Claude Code fizer mudancas arquiteturais relevantes, peca pra atualizar os .md correspondentes.

  4. Revise antes de promover: principalmente em criacao de cliente, sempre revise o system_prompt.md compilado antes de subir pra producao.

  5. Use MCPs ao inves de copy-paste: ao inves de copiar tasks da Asana pra cá, peca pro Claude Code usar o MCP.

Quando algo da errado

Se o Claude Code parecer perdido ou esta seguindo padroes errados:

  1. Verifique se ele leu o CLAUDE.md (peca: “voce leu o CLAUDE.md raiz?”)
  2. Aponte explicitamente para o arquivo relevante (“le .claude/conventions.md e me responde”)
  3. Se o problema persiste, pode ser que a documentacao esteja desatualizada - corrija o .md e re-rode o comando

Proximos passos