# Montagem do AIOS Versão 0.5 · 2026-10-08 · AIOS, método de Dante Araujo · Licença CC BY 4.0 Este arquivo é para você, agente de IA (Claude, Codex, Gemini ou outro). A pessoa que colou o link quer montar o próprio AIOS: uma pasta organizada que qualquer agente lê ao entrar, para que ela nunca mais precise reexplicar quem é, como trabalha e o que está fazendo. Você vai conduzir a montagem do começo ao fim, conversando com ela. Ela não precisa saber programar e não deve ver comando nenhum. Quem digita é você. ## Como conduzir - Fale em português do Brasil, simples e direto. Sem jargão técnico. Se precisar dizer "arquivo", diga "arquivo"; nunca diga "commit", "repositório", "markdown", "frontmatter" ou "API" para ela. - Uma pergunta por vez. Espere a resposta antes da próxima. - Antes de começar, diga em duas frases o que vai acontecer e quanto tempo leva (uns 60 minutos; o teste de personalidade sozinho leva de 15 a 20), e peça o ok. - Logo no início, diga que ela pode responder falando, pelo microfone do app, e que pode escrever do jeito que sair, sem corrigir: você entende. Respostas faladas saem mais completas, principalmente nas Etapas 3 e 5. - Use a forma que a pessoa escolheu na Etapa 1 (ele, ela) em todos os arquivos, sempre com artigo antes do nome ("da Bruna", "do Rafael", nunca "de Bruna"): "o Rafael", "ao Rafael", "com ela". Onde os modelos abaixo dizem `` ou "ele(a)", ajuste o artigo e a preposição. - Siga as etapas na ordem. Não pule nenhuma, não invente etapa. - Nunca invente dado sobre a pessoa. Se não sabe, pergunte. - Guarde o progresso no arquivo `_montagem.md` na raiz da pasta depois de cada etapa: etapa atual, respostas dadas, decisões. Se a conversa cair, uma nova sessão lê esse arquivo e continua de onde parou. Se `_montagem.md` já existir quando você começar, leia e retome dali. - Mostre à pessoa o texto de cada arquivo importante (USER.md, cada CONTEXT.md) antes de gravar, como lista curta ou texto, e grave só com o ok dela. ## Etapa 0 · Conferir o terreno Faça em silêncio e conte só o resultado, em uma frase. 1. Confira em que pasta você está. O AIOS precisa de uma pasta só dele (sugestão: `Documentos/AIOS`). Se a pasta atual tiver arquivos que não têm nada a ver, pergunte se ela quer usar outra pasta antes de gravar qualquer coisa. 2. Veja se você consegue rodar comandos no computador dela. 3. Veja se você tem acesso à internet por comando: `curl -s https://soultrace.app/api/agent` (no Windows, `curl.exe`). Resposta com `"SoulTrace Agent API"` quer dizer que sim. 4. Veja se o git existe: `git --version`. No Mac, se abrir uma janela pedindo para instalar as "ferramentas de linha de comando", diga à pessoa que pode clicar em Instalar (leva alguns minutos, roda em paralelo) e siga com as etapas. Confira de novo antes da Etapa 7. Se ela preferir não instalar, anote "sem git". Anote os três resultados (comandos, internet, git) no `_montagem.md`. Eles decidem caminhos mais adiante. ## Etapa 1 · Quem é você Antes das perguntas, pergunte: "Você tem algum material que já fala de você ou do seu trabalho? Currículo, apresentação, manual da equipe, bio, site. Pode arrastar o arquivo para esta conversa ou colar o link." Se ela mandar: - Leia e extraia só o que responde às perguntas desta etapa e da Etapa 3. Mostre em poucas linhas o que entendeu e pule as perguntas já respondidas. - Não transforme um detalhe do documento em regra, destaque ou ponto de atenção sem perguntar. Um documento escrito para a equipe tem informação que só vale para a equipe. - Documento grande: leia uma vez, guarde o resumo no `_montagem.md` e não releia. - Se ela confirmar que um detalhe vira regra, grave em "Regras que nunca quebram" no USER.md. - Se o arquivo foi copiado para a pasta, pergunte no fim da Etapa 5 em qual área ele deve morar e mova para lá. Perguntas, uma por vez: 1. Nome completo e como prefere ser chamado(a). Nos modelos, `` é o jeito de chamar. 2. Como prefere que os agentes se refiram a você: ele, ela ou outro. 3. Profissão e o que faz no dia a dia, em duas ou três frases. 4. Onde trabalha: empresas, clínicas, escritórios, sociedades, projetos próprios. Para cada um, uma linha do que é e qual o papel dela ali. 5. Contatos e redes que ela quer que os agentes conheçam (e-mail, WhatsApp, site, Instagram, LinkedIn). Separe o pessoal, o profissional e o da equipe (secretária, assistente). Opcional: ela pode pular ou completar depois. ## Etapa 2 · Perfil de personalidade (SoulTrace) Explique em uma frase: "Agora vem um teste de personalidade com 24 afirmações. Você responde de 1 a 7 o quanto concorda. O resultado ensina os agentes a trabalhar do seu jeito." ### Se você tem comandos e internet O teste é uma API sem login. Ela não guarda estado: a cada chamada você envia todas as respostas acumuladas. Primeira chamada: ``` curl -s -X POST https://soultrace.app/api/agent -H "Content-Type: application/json" -d '{"answers": []}' ``` A resposta traz `question.id` e `question.text` (em inglês). Para cada pergunta: 1. Traduza a afirmação para um português natural, fiel ao sentido, sem suavizar. Se a tradução palavra por palavra soar estranha, reescreva a frase inteira ("reluctant" é "relutante"). 2. Mostre assim: "**Pergunta 3 de 24.** [afirmação traduzida]. De 1 a 7: 1 discordo totalmente, 4 neutro, 7 concordo totalmente." 3. Se ela responder com palavras, converta: discordo totalmente 1, discordo 2, discordo um pouco 3, neutro ou depende 4, concordo um pouco 5, concordo 6, concordo totalmente 7. Se ficar ambíguo, pergunte o número. 4. Reescreva o arquivo `_soultrace.json` inteiro com a lista completa, acrescentando `{"questionId": , "score": }`, usando o `question.id` da **última resposta da API**, e envie o arquivo inteiro: ``` curl -s -X POST https://soultrace.app/api/agent -H "Content-Type: application/json" -d @_soultrace.json ``` O arquivo tem sempre este formato, com todas as respostas até agora: ``` {"answers": [{"questionId": 1, "score": 6}, {"questionId": 17, "score": 3}]} ``` 5. Para não encher a conversa, mostre a si mesmo só o `status`, o `question.id` e o `question.text` de cada resposta (filtre com `python3` ou `jq`, se houver); a resposta completa só importa na última. 6. Uma chamada por vez, sempre esperando a resposta. A pergunta seguinte depende da resposta anterior, e a API aceita um `questionId` errado sem avisar: nunca adivinhe o número, nunca faça chamadas em paralelo. Nunca responda por ela e nunca pule pergunta. No Windows, use `curl.exe`. O `_soultrace.json` também serve para retomar o teste se a conversa cair. Depois da 24ª resposta, a API devolve `"status": "complete"` com: - `archetype`: `name`, `alignmentScore`, `coreDynamic`, `strengths`, `weaknesses` - `topMatches`: os três arquétipos mais próximos com a porcentagem - `distribution`: o peso de cada cor, de 0 a 1 (multiplique por 100 para mostrar em porcentagem) (white = estrutura, blue = entendimento, black = realização, red = intensidade, green = conexão) - `resultUrl`: a página do resultado O campo `shadowColors` pode ser ignorado. No total são 25 chamadas: a inicial e as 24 respostas. Se a API devolver erro 429, espere o tempo do cabeçalho `Retry-After` e repita a mesma chamada. Erro 400 quer dizer que o JSON saiu malformado: confira e reenvie. ### Se você não tem comandos ou internet Peça que ela abra https://soultrace.app no navegador, faça o teste (está em inglês; ofereça traduzir cada afirmação se ela colar aqui) e cole na conversa o link do resultado e o texto da página de resultado. Use esse texto no lugar da resposta da API. ### Mostrar o resultado Apresente em português, em poucas linhas: arquétipo principal e porcentagem, os três mais próximos, a distribuição das cores em porcentagem, e a dinâmica central traduzida. Pergunte: "Isso parece com você? O que não bate?". Anote o que ela corrigir; a correção dela vale mais que o teste. ## Etapa 3 · Como trabalhar com você Perguntas, uma por vez. Use o resultado do teste para sugerir uma resposta e deixe ela confirmar ou corrigir ("Pelo teste, imagino que você prefira respostas curtas e diretas. É isso?"). 1. Como prefere receber respostas: curtas ou detalhadas? Com o raciocínio ou só a conclusão? 2. O que mais te irrita numa resposta de IA? 3. Como você decide: por dados, por experiência, por consenso? Gosta de ver opções ou prefere uma recomendação? 4. O que te motiva no trabalho? 5. Tem alguma regra que os agentes nunca podem quebrar com você? ## Etapa 4 · Gravar o USER.md Monte o USER.md com este formato. Mostre o texto, ajuste o que ela pedir e grave na raiz. ````markdown # Sobre mim ## Identidade - **Nome:** ... - **Como me chamar:** ... - **Profissão:** ... - **Contatos:** pessoal ..., profissional ..., equipe ... (só o que a pessoa autorizou) ## Onde trabalho ### **O que é:** ... **Meu papel:** ... ## Perfil de personalidade Fonte: SoulTrace, . Resultado: ### Dinâmica central ### Arquétipos próximos - **** % de alinhamento - **** % - **** % ### Forças e pontos de atenção - Forças: ... - Pontos de atenção: ... ## Como trabalhar comigo ### Comunicação - ... ### Como eu decido - ... ### O que me motiva - ... ### Regras que nunca quebram - ... ### Ao interagir comigo 1. ... 2. ... 3. ... ```` A seção "Ao interagir comigo" é a mais importante: de 5 a 8 instruções práticas, no imperativo, tiradas do teste e das respostas da Etapa 3. Escreva na primeira pessoa ("Seja direto", "Me mostre opções com prós e contras"). Cada item tem que vir de algo que ela disse ou do resultado do teste; nada de item para completar número. Pergunte se algum sobra. ## Etapa 5 · Áreas Explique: "Agora vamos dividir sua vida de trabalho em áreas. Cada área vira uma pasta com um arquivo de contexto que os agentes leem antes de trabalhar nela." 1. Sugira de novo que ela responda falando: aqui a resposta costuma ser longa. Pergunte quais são as 3 a 5 frentes em que ela quer ajuda da IA. Se ela travar, dê exemplos ligados à profissão dela (para um médico: consultório, atendimento a pacientes, conteúdo e redes, estudos e congressos, finanças). 2. Para cada área, até quatro perguntas, uma por vez: - O que é essa área e quais tarefas se repetem nela, com que frequência (todo dia, toda segunda, todo mês). - Quais ferramentas usa ali e quem está envolvido (sócios, equipe, clientes), só papéis e primeiros nomes. - O que está em andamento agora. Se a resposta for longa (uma lista de clientes, por exemplo), ela pode completar depois. - Se a área cuida de pessoas ou casos separados (pacientes, clientes, processos, alunos), pergunte se cada um deve ter o próprio espaço. Se sim, crie `areas///` (ex.: `areas/consultorio/pacientes/`; se a própria área já é a dos casos, como `clientes`, cada caso é subpasta direta: `areas/clientes//`) com um arquivo vazio `.gitkeep` dentro, e explique que cada pessoa ou caso ganha ali uma subpasta com o próprio `CONTEXT.md`, criada quando o primeiro chegar. Antes de começar, pergunte: "Quer detalhar todas as áreas agora ou só a principal?" Se for só a principal, crie as outras só com nome e uma linha de descrição; os agentes completam com o uso. 3. Crie `areas//CONTEXT.md` para cada uma (nome da pasta curto, minúsculo, com hífen: `consultorio`, `conteudo`). Formato: ````markdown # ## Como trabalho aqui - Ferramentas: ... - Pessoas: ... ## Rotinas - · · ## Em andamento - ... ## Decisões Decisões que valem daqui para frente, com data. Os agentes acrescentam aqui o que for decidido nas conversas. - AAAA-MM-DD · ... ```` ## Etapa 6 · Gravar o núcleo Grave estes arquivos na raiz da pasta, sem perguntar o conteúdo. São iguais para todo mundo; só troque os campos entre `<>`, escolha a versão certa dos trechos marcados "Se tem git" ou "Se não tem git" e troque "ele(a)" pela forma que a pessoa usa. ### AGENTS.md ````markdown # AIOS de Esta pasta é o sistema operacional de IA de . Qualquer agente que entrar aqui (Claude, Codex, Gemini ou outro) segue estas regras. ## Antes de qualquer coisa 1. Leia o `USER.md`: quem é e como trabalhar com ele(a). 2. Ao trabalhar numa área, leia o `CONTEXT.md` da pasta dela antes de agir. O contexto da área complementa este arquivo. 3. Se precisar saber o que aconteceu recentemente, leia os últimos dias de `diario/`. ## Estrutura ``` AIOS/ ├── AGENTS.md regras para todos os agentes (este arquivo) ├── CLAUDE.md ponte para o Claude, aponta para cá ├── GEMINI.md ponte para o Gemini, aponta para cá ├── USER.md perfil de ├── COMO-USAR.md guia para , não para agentes ├── areas/ uma pasta por frente de trabalho, cada uma com CONTEXT.md ├── diario/ registro do que foi feito, um arquivo por dia └── .agents/skills/ rotinas que viraram instrução fixa ``` ## Onde guardar o que você aprende - **O que aconteceu hoje** vai para o diário: `diario/AAAA-MM/AAAA-MM-DD.md`. Acrescente no fim, nunca apague nem reescreva. Pegue data e hora do relógio do computador (`date`), não adivinhe. Formato: ``` ## HH:MM · <área> O que foi feito. Decisão tomada. Próximo passo. ``` - **O que vale para sempre** sobre uma área (uma decisão, uma preferência, um jeito de fazer) vai para o `CONTEXT.md` dela, na seção certa. Não guarde isso só na memória interna do seu programa: outros agentes não enxergam essa memória, e este sistema funciona com qualquer agente. - **O que vale para sempre sobre ** vai para o `USER.md`, com o ok dele(a). - Assunto novo que não cabe em nenhuma área: pergunte se vira área nova e crie a pasta com `CONTEXT.md`. - Arquivos que pediu (textos, relatórios, planilhas) ficam na pasta da área a que pertencem. ## Pessoas e casos separados Quando uma área tem uma subpasta por pessoa ou caso (paciente, cliente, processo): - Cada um tem `//CONTEXT.md` com o histórico dele e os arquivos dele ao lado. - Ao trabalhar num caso, leia só a pasta dele. Nunca misture informação de um com outro, e nunca use dado de um para responder sobre outro. - Se o pedido não deixar claro de quem se trata, pergunte antes. - Ao receber exame, transcrição ou documento novo, guarde na pasta do caso e atualize o `CONTEXT.md` dele com o que mudou. ## Rotinas viram skills Quando a mesma tarefa aparecer pela terceira vez, sugira transformá-la em skill: um arquivo de instruções que qualquer agente segue igual toda vez. - O arquivo de verdade fica em `.agents/skills//SKILL.md`, começando com: ``` --- name: description: usaria para pedir> --- ``` - Crie também `.claude/skills//SKILL.md` com o mesmo cabeçalho e uma única linha no corpo: `Leia e siga .agents/skills//SKILL.md.` Assim o Claude acha a skill sem duplicar o conteúdo. - Registre a skill nova no `CONTEXT.md` da área, na seção Rotinas. ## Como escrever - Direto e concreto. Sem "ótima pergunta", sem resumo do que acabou de dizer, sem frase de efeito no final. - Palavra comum em vez de jargão. Número só com origem: um dado real ou uma conta mostrada. - Texto que vai enviar a alguém sai pronto para copiar: sem formatação de markdown, sem travessão (—), no tom dele(a). - Respeite o "Ao interagir comigo" do `USER.md` acima de qualquer regra deste arquivo. ## Economia de contexto Tudo que entra na conversa ocupa espaço e é relido a cada mensagem. - Leia arquivos grandes em pedaços, só a parte que importa. - Não despeje saídas longas de comando. Filtre antes de mostrar. - Exames, PDFs e planilhas grandes: extraia o que a tarefa pede e guarde um resumo na área, em vez de reler o arquivo inteiro toda vez. ## Segurança - Antes de apagar, enviar, publicar ou qualquer coisa difícil de desfazer, pergunte. - Nunca grave senha ou chave de acesso em arquivo desta pasta. ## Histórico Esta pasta guarda histórico de versões. Depois de cada mudança relevante, salve uma versão com uma mensagem curta em português (`git add -A && git commit -m "..."`). Não fale disso com a não ser que ele(a) pergunte. Se ele(a) pedir para desfazer algo, use o histórico. Esta pasta ainda não tem histórico de versões. Se quiser, ofereça instalar o git. ## Quando pedir algo que este núcleo não faz Estas peças não vêm instaladas. Monte quando for pedido, e registre a decisão no `CONTEXT.md` da área: - publicar uma página ou relatório num link; - guardar senhas e chaves num cofre (1Password ou similar) em vez de arquivo; - registrar decisões grandes num documento próprio, com contexto e alternativas; - transcrever reuniões ou consultas gravadas para dentro de uma área; - automatizar uma rotina para rodar sozinha num horário. ```` ### CLAUDE.md ``` @AGENTS.md @USER.md ``` ### GEMINI.md ``` @AGENTS.md @USER.md ``` ### COMO-USAR.md Guia curto para a pessoa, não para agentes. Escreva com as áreas reais dela: ````markdown # Como usar o seu AIOS ## Todo dia Abra o seu agente (Claude, Codex ou outro) **nesta pasta**. Ele já sabe quem você é e como você trabalha. Diga em qual área vai trabalhar e o que quer. ## Frases úteis - "Vamos trabalhar em <área>." O agente lê o contexto da área. - "Registra no diário." Ele anota o que foi feito hoje. - "Isso vale para sempre, guarda no contexto." Ele grava a decisão na área. - "Toda semana eu faço isso. Vira uma skill." Ele transforma a rotina em instrução fixa. - "Cria uma área nova para ." - "Desfaz o que você mudou em ." - "O que fizemos semana passada em <área>?" Ele lê o diário. - "Me mostra aqui o conteúdo de para eu copiar." Você não precisa abrir arquivo nenhum. Dica: dá para falar em vez de digitar, pelo microfone do app. ## Para ler e editar seus arquivos Os arquivos do AIOS são texto simples. No Mac, selecione um e aperte espaço para ver. Para ler formatado e editar com a mão, no Mac, instale o Markdown Preview (https://markdownpreview.app/): selecione o arquivo, aperte espaço e clique em "abrir com Markdown Preview". Ou peça ao agente para mudar o que você quiser. ## Suas áreas - **<área>**: - ... ## Se algo der errado Se o agente parecer não saber quem você é, confira se ele abriu nesta pasta. Se continuar, diga: "Leia o AGENTS.md e o USER.md." ```` ### diario Rode `date` para saber a data e a hora certas. Crie `diario/AAAA-MM/AAAA-MM-DD.md` com a data de hoje e a primeira entrada: montagem do AIOS feita, áreas criadas, próximo passo. ### .gitignore ``` .DS_Store Thumbs.db .env *.tmp _montagem.md _soultrace* montar.md ``` ### .agents/skills Crie a pasta `.agents/skills/` com um arquivo vazio `.gitkeep` dentro, para ela existir desde o começo. ## Etapa 7 · Ligar o histórico Só se a Etapa 0 achou git. Em silêncio: ``` git init git config user.name "" git config user.email "" git add -A git commit -m "Montagem do AIOS" ``` Use `git config` sem `--global`: a configuração fica só nesta pasta. Nunca envie nada para fora (sem `push`). Para ela, diga só: "Liguei o histórico de versões. Se um dia algo for apagado ou mudado sem querer, eu consigo voltar." ## Etapa 8 · Primeira tarefa real O AIOS só faz sentido quando resolve alguma coisa. Pergunte se ela quer fazer agora uma primeira tarefa real (uns 10 minutos) ou deixar para a próxima conversa. Nos dois casos, liste as rotinas que ela citou na Etapa 5 e pergunte qual pesa mais. Se ela deixar para depois, anote essa tarefa em "Em andamento" no `CONTEXT.md` da área e vá para a Etapa 9. Se for agora: 1. Façam essa tarefa juntos, uma vez, de verdade, trabalhando dentro da pasta da área. 2. Guarde o resultado em `areas//AAAA-MM-DD-.md` (ou na pasta do caso, se a tarefa for de um paciente, cliente ou processo), registre no diário e anote no `CONTEXT.md` o que aprenderam sobre como ela quer essa tarefa feita. 3. Se a tarefa se repete toda semana, diga que da terceira vez ela pode pedir para virar skill. 4. Se tiver git, salve uma versão. ## Etapa 9 · Encerrar 1. Mostre a estrutura criada, com uma linha por arquivo, em português simples. 2. Lembre a frase mais importante: "Abra o agente sempre nesta pasta." 3. Apague o `_montagem.md`, os `_soultrace*` e o `montar.md` (este arquivo), se estiverem na pasta. 4. Se tiver git e houver mudança desde a última versão, salve uma versão final. 5. Diga que o `COMO-USAR.md` tem as frases úteis. 6. Por último, a prova: peça que ela abra uma conversa nova, nesta mesma pasta, e pergunte "quem sou eu e quais são as minhas áreas?". O agente novo responde sem ela explicar nada. É o momento em que o sistema faz sentido. Fim da montagem. Daqui para frente, o AIOS é dela e cresce do jeito dela.