Módulo 6.1 — Planejando Seu Assistente

1

O que é Planejamento de Assistente IA?

Planejar um assistente IA é diferente de planejar software tradicional. Você está definindo nao apenas funcionalidade, mas comportamento, identidade e fronteiras éticas de um agente que agirá em seu nome.

As 4 Dimensoes do Planejamento

1Escopo funcional: o que o assistente PODE e NAO PODE fazer

2Identidade: quem é o assistente, seus valores e tom de comunicacao

3Arquitetura: qual padrao Claw e quais componentes são necessários

4Roadmap: sequência de construcao do MVP ao assistente completo

2

Por que Planejar antes de Codificar?

Em sistemas de IA, o custo de mudanca tardia é muito maior do que em software tradicional. Mudar a arquitetura depois de ter memória, ferramentas e canais configurados pode exigir migracoes complexas.

Decisoes caras de mudar depois

· Schema do banco de memória
· Formato do SOUL.md
· Interface base dos Tools
· Padrao de autenticacao de canais

Decisoes fáceis de mudar

· Modelo de IA usado
· Estilo de comunicacao do SOUL.md
· Adicao de novos Tools
· Configuracoes de canal

3

Definindo Escopo e Casos de Uso

Use a técnica Jobs-to-be-Done para mapear o que você quer delegar ao assistente. Seja específico: "gerencie meu email" é vago; "filtre e categorize emails de trabalho, respondendo automaticamente agendamentos" é um job concreto.

Template de Definicao de Job

QUANDO recebo um email de cliente solicitando reuniao

QUERO QUE o assistente verifique meu calendario e proponha horários

PARA QUE eu nao precise fazer essa triagem manualmente

RESTRICOES: nunca aceitar sem minha aprovacao final

CANAL: Gmail + Google Calendar

ARQUITETURA: IronClaw (dados sensíveis)

4

Escolhendo a Arquitetura Claw Certa

Use esta decision tree para escolher o padrao certo com base nos seus requisitos de seguranca, escala e complexidade.

Dados sensíveis de terceiros?

SIM → IronClaw

NAO → continua...

Múltiplos agentes especializados?

SIM → TinyClaw

NAO → continua...

Sistema deve melhorar autonomamente?

SIM → Agent Zero

NAO → continua...

Ambiente offline ou edge?

SIM → ZeroClaw ou NanoClaw

NAO → OpenClaw (use e evolua depois)

5

Design de Identidade e SOUL.md

O SOUL.md é o documento mais importante do seu assistente. Dedique tempo real a ele — uma identidade bem definida evita comportamentos inconsistentes e respostas fora de contexto.

# SOUL.md template para projeto final

# Identidade

Nome: [SEU ASSISTENTE]

Papel: Assistente pessoal especializado em [SEU CONTEXTO]

# Personalidade

Tom: [direto/formal/casual/técnico]

Fortalezas: [lista das 3-5 principais]

# Valores e Restricoes

Sempre: [comportamentos obrigatórios]

Nunca: [comportamentos proibidos]

# Contexto

Usuário: [quem você é e seu contexto profissional]

6

Roadmap de Construcao em 4 Fases

Nao tente construir tudo de uma vez. Siga as 4 fases evolutivas para ter um assistente funcionando rapidamente e melhorá-lo com feedback real.

1

Fase MVP (semana 1-2)

Um canal, um modelo, SOUL.md básico, sem ferramentas externas. Foco: responder perguntas e manter contexto.

2

Fase Core (semana 3-4)

Memória persistente, 2-3 ferramentas essenciais, refinamento de identidade com base no uso real.

3

Fase Advanced (mês 2)

Múltiplos canais, automacoes, integracoes com Google/GitHub, seguranca hardening.

4

Fase Autonomous (mês 3+)

Multi-agentes, Agent Zero loop, auto-descoberta de tools, monitoramento completo.