MODULO 2.8

🔀 Workflows Avancados

Pipelines, multi-agente, CI/CD e automacoes empresariais com Claude Code.

6
Topicos
30
Minutos
Avancado
Nivel
Pratico
Tipo
1

🔀 Pipelines de Codigo

Encadeie multiplas operacoes Claude em sequencia usando pipes Unix e scripts.

Pipeline Exemplo: Gerar + Testar + Documentar

#!/bin/bash
# pipeline.sh - Gera componente completo

# 1. Gerar codigo
claude -p "Crie um componente React Button com variants" --print > src/Button.tsx

# 2. Gerar testes
claude -p "Gere testes Jest para Button.tsx" --print > src/Button.test.tsx

# 3. Gerar documentacao
claude -p "Gere docs Storybook para Button" --print > src/Button.stories.tsx

# 4. Validar
npm test && npm run lint

💡 Dica

Use --print para output sem interacao, ideal para pipelines e automacao.

2

🤖 Multi-Agente

Claude Code pode delegar tarefas para sub-agentes especializados usando o Task tool.

Arquitetura Multi-Agente

┌─────────────────────────────────────────┐
│           Agente Principal              │
│         (Orquestrador)                  │
└─────────────┬─────────────┬─────────────┘
              │             │
     ┌────────▼──────┐  ┌───▼────────────┐
     │  Sub-Agente   │  │   Sub-Agente   │
     │   (Testes)    │  │   (Docs)       │
     └───────────────┘  └────────────────┘

# O agente principal pode usar Task para delegar:
"Use Task para criar testes para todos os arquivos em src/"
"Delegue a documentacao para um agente especializado"

Quando Usar Multi-Agente

  • • Tarefas muito grandes
  • • Trabalho paralelizavel
  • • Especializacao necessaria

Cuidados

  • • Custo aumenta com sub-agentes
  • • Coordenacao pode ser complexa
  • • Contexto e limitado por agente
3

🔄 CI/CD Integration

Integre Claude Code em pipelines GitHub Actions, GitLab CI ou outras ferramentas de CI/CD.

GitHub Actions - Code Review

name: Claude Code Review
on: [pull_request]

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Setup Node
        uses: actions/setup-node@v4
        with:
          node-version: '20'

      - name: Install Claude Code
        run: npm install -g @anthropic-ai/claude-code

      - name: Run Code Review
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
        run: |
          claude -p "Review this PR for bugs and improvements" \
            --print > review.md

      - name: Post Review Comment
        uses: actions/github-script@v7
        with:
          script: |
            const fs = require('fs');
            const review = fs.readFileSync('review.md', 'utf8');
            github.rest.issues.createComment({
              owner: context.repo.owner,
              repo: context.repo.repo,
              issue_number: context.issue.number,
              body: review
            });
4

📊 Batch Processing

Processe multiplos arquivos ou tarefas em lote com scripts de automacao.

Script de Batch Processing

#!/bin/bash
# batch-docs.sh - Gera docs para todos os arquivos

for file in src/**/*.ts; do
  echo "Processando: $file"

  # Gerar documentacao
  claude -p "Gere JSDoc para: $file" --print \
    > "${file%.ts}.docs.md"

  # Rate limiting
  sleep 2
done

echo "Batch completo!"

⚠️ Cuidado com Rate Limits

A API tem rate limits. Use delays entre requests e monitore custos em processamentos grandes.

5

🏢 Enterprise Workflows

Workflows para organizacoes: padronizacao, governanca e compliance.

Padronizacao

  • • Skills compartilhadas no repo
  • • CLAUDE.md padrao do time
  • • Templates de projeto
  • • Hooks obrigatorios

Governanca

  • • Audit logs via hooks
  • • Permissoes por projeto
  • • Aprovacao de mudancas
  • • Compliance checks

Estrutura Enterprise

organization/
├── shared-skills/              # Skills compartilhadas
│   ├── code-review/
│   ├── security-scan/
│   └── documentation/
├── templates/
│   ├── CLAUDE.md.template      # Template padrao
│   └── settings.json.template
└── compliance/
    └── hooks/                  # Hooks de auditoria
6

📈 Metricas e Otimizacao

Monitore custos, tokens e otimize performance para uso eficiente.

Monitoramento de Custos

# Durante a sessao
/cost                    # Ver custos atuais

# Via CLI
claude --cost-report     # Relatorio de custos

# Metricas importantes
- Input tokens:  ~$3/1M tokens (Sonnet)
- Output tokens: ~$15/1M tokens (Sonnet)
- Sessao media:  ~10-50k tokens

✓ Otimizacoes

  • • Use /compact regularmente
  • • Escolha modelo certo (Haiku para tarefas simples)
  • • Evite arquivos grandes no contexto
  • • Use .claudeignore efetivamente

Modelos por Caso de Uso

  • Haiku: Tarefas simples, formatacao
  • Sonnet: Desenvolvimento geral
  • Opus: Problemas complexos, arquitetura

📚 Resumo do Modulo

Pipelines - Encadeamento de tarefas com pipes e scripts
Multi-Agente - Task tool para delegacao a sub-agentes
CI/CD - GitHub Actions, GitLab CI para automacao
Enterprise - Padronizacao, governanca, compliance
Otimizacao - /cost, /compact, escolha de modelo

🎉 Parabens!

Voce completou a Trilha 2 - Claude Code Mastery! Voce agora domina instalacao, comandos, skills, hooks, MCP e workflows avancados.