MÓDULO 2.1

🧬 Identidade e Personalidade

SOUL.md como núcleo da personalidade, AGENTS.md para regras de comportamento, USER.md para contexto do criador, AIEOS para exportar identidade e perfis intercambiáveis por contexto.

6
Tópicos
60
Minutos
Básico
Nível
Prático
Tipo
1

📜 SOUL.md — A Essência do Jarvis

O SOUL.md é o arquivo mais transformador do projeto. É aqui que você define quem é seu assistente — não apenas como ele responde, mas o que ele valoriza, como pensa e como se expressa. Um SOUL.md bem escrito transforma o ChatGPT genérico em um parceiro com voz própria.

📄 Anatomia de um SOUL.md

# SOUL — Identidade do Assistente

## Nome e Identidade
Você é Atlas, assistente pessoal de desenvolvimento.

## Tom de Voz
- Direto e técnico, sem rodeios
- Usa humor seco quando apropriado
- Prefere exemplos concretos a abstrações

## Valores
- Segurança sempre primeiro
- Código limpo sobre código rápido
- Explica o raciocínio, não só a resposta

✓ SOUL.md Eficaz

  • ✓Valores claros e testáveis
  • ✓Tom específico com exemplos
  • ✓Limites éticos explícitos
  • ✓Estilo de resposta definido

✗ SOUL.md Fraco

  • ✗"Seja útil e amigável" — vago demais
  • ✗Sem valores, só comportamentos
  • ✗Contradições internas (formal E casual)
  • ✗Muito longo — dilui o foco

💡 Dica Prática

Escreva o SOUL.md como se estivesse contratando um assistente humano. O que você diria na entrevista? Quais são os valores inegociáveis? Como você quer que ele se comunique com você?

2

📋 AGENTS.md — Regras de Comportamento

AGENTS.md é o contrato operacional. Enquanto SOUL.md define quem é o assistente, AGENTS.md define o que ele faz e o que nunca faz. Regras explícitas são mais confiáveis do que esperar que o LLM inferira intenções.

📋 Exemplo de AGENTS.md

# AGENTS — Regras Operacionais

## SEMPRE
- Confirmar antes de deletar qualquer arquivo
- Mostrar o diff antes de aplicar mudanças
- Explicar por que está tomando cada ação

## NUNCA
- Executar rm -rf sem confirmação explícita
- Fazer push para main diretamente
- Compartilhar credenciais em logs
3

👤 USER.md — Contexto do Criador

USER.md contém tudo que o Jarvis precisa saber sobre você sem precisar ser perguntado a cada sessão. Stack técnica, empresa, projetos em andamento, preferências de ferramentas — contexto que personaliza cada resposta.

👤 Exemplo de USER.md

# USER — Perfil do Criador

**Nome:** João Silva
**Stack:** Python 3.11, FastAPI, PostgreSQL, Redis
**Editor:** Neovim (não VS Code)
**Empresa:** Acme Corp (startup B2B SaaS)
**Fuso:** America/Sao_Paulo
**Projetos ativos:** API de pagamentos, refactor do monolito

💡 Mantenha USER.md Atualizado

O USER.md é um arquivo vivo. Quando mudar de emprego, iniciar um novo projeto ou aprender uma nova tecnologia, atualize o USER.md. O Jarvis não tem como saber de mudanças que não foram escritas.

4

🔄 AIEOS — Exportar Personalidade

AIEOS (AI Entity Operating System) é o formato de serialização de identidade do INTELECTO. Permite criar um snapshot portável de toda a personalidade — SOUL + AGENTS + USER — em um único arquivo que pode ser versionado, compartilhado e restaurado.

1

Exportar Personalidade

python -m intelecto export-soul --output atlas-v1.aieos

2

Versionar com Git

git add atlas-v1.aieos && git commit -m "chore: snapshot de personalidade v1"

3

Restaurar em Nova Máquina

python -m intelecto import-soul atlas-v1.aieos — instala toda a personalidade instantaneamente

5

🎭 Perfis Intercambiáveis

Um Jarvis com uma única personalidade é limitado. Perfis intercambiáveis permitem ter "Atlas-Dev" para codificação intensa e "Atlas-Meeting" para comunicação corporativa, alternando com um simples comando.

💻 Atlas-Dev

Tom: técnico, direto. Foca em código, arquitetura, debugging. Usa jargão técnico livremente. Para sessões de desenvolvimento intenso.

👔 Atlas-Meeting

Tom: formal, diplomático. Adapta linguagem técnica para não-técnicos. Ideal para preparar apresentações e comunicações com clientes.

🎯 Atlas-Focus

Tom: minimalista, sem conversa. Respostas curtas, sem explicações não solicitadas. Para quando você só precisa de respostas rápidas.

6

🧪 Testando e Iterando o SOUL.md

Escrever um SOUL.md eficaz é um processo iterativo. A primeira versão nunca está certa. Você precisa testar com casos reais e observar onde o comportamento diverge do esperado.

🔄 Processo de Refinamento

1

Escreva a primeira versão do SOUL.md

2

Teste com 20 perguntas reais do seu dia a dia

3

Marque respostas que não soaram como você esperava

4

Identifique qual instrução no SOUL.md causou o comportamento inesperado

5

Refine e repita — geralmente 3-5 iterações chegam a um SOUL.md estável

✅ Resumo do Módulo 2.1

✓
SOUL.md — Núcleo de personalidade: nome, tom, valores, estilo de comunicação
✓
AGENTS.md — Contrato operacional: SEMPRE / NUNCA / prioridades
✓
USER.md — Contexto permanente: stack, empresa, projetos, preferências
✓
AIEOS — Exportar e importar identidade completa em um arquivo portável
✓
Perfis — Dev, Meeting, Focus — alternância por contexto
✓
Iteração — Processo de 5 etapas para refinar o SOUL.md até estabilizar

Próximo Módulo:

2.2 — Canais de Comunicação: Telegram, WhatsApp, Discord, Slack e BaseChannel

← Trilha 2 Próximo: Módulo 2.2 →