🌱 Expansões & Cadência semanal
Crescer sem virar porão de acumulador. Saber o que adicionar, quando adicionar e como manter o AIOS enxuto, navegável e útil à medida que seu negócio escala.
Diagrama ilustrativo — Regra dos 3 Sins para expansão controlada do AIOS
Conteúdo detalhado
O que vem no kit (não remova)
O kit AIS-OS chega com uma estrutura mínima proposital. Cada pasta e arquivo tem função definida — remover ou renomear quebra os comandos /onboard, /audit e /level-up. Aprenda o que é cada peça antes de tocar.
📁 Estrutura base do AIS-OS (intocável)
aios/
├── CLAUDE.md ← instruções globais do agente
├── aios-intake.md ← formulário de onboarding
├── connections.md ← mapa de integrações
├── context/ ← snapshots de contexto ativo
├── references/ ← documentos de referência
├── decisions/
│ └── log.md ← registro de decisões
├── archives/ ← material arquivado
└── .claude/
└── skills/ ← skills do AIOS
💡 Dica Prática
Se você precisar renomear algo, edite também os prompts dos comandos que referenciam aquele caminho. O AIOS lê CLAUDE.md em toda sessão — qualquer caminho errado ali gera confusão silenciosa.
O que adicionar conforme cresce
Nem toda pasta precisa existir no dia 1. O AIOS cresce junto com você — mas de forma orgânica, reagindo a necessidades reais, não a "talvez um dia precise". Aqui estão os itens que aparecem naturalmente conforme o negócio amadurece:
Semana 1–4 · Kit base, sem adições
Use o kit como veio. Deixe o AIOS rodar. Observe o que você repete e o que gera fricção antes de criar qualquer coisa nova.
Mês 1–2 · Primeiras expansões orgânicas
Se você stopou de copiar o mesmo prompt, crie templates/. Se tem 2+ workstreams activos simultâneos, crie projects/ com sub-pastas.
Mês 3+ · Operação madura
Processos documentados em references/sops/. Identidade de marca em brand-assets/. Documentação de APIs em references/{tool}-api.md. Sub-OS para verticals separadas em youtube-os/, etc.
Anti-padrões: o que NÃO adicionar
A maioria dos AIOS que viram bagunça não foi por falta de organização — foi por excesso de estrutura prematura. Conheça os padrões que poluem o sistema e matam a clareza do agente.
✓ O que ADICIONAR
- ✓ Pasta que você vai usar 3+ vezes/mês — se não tem frequência, vai virar arquivo morto
-
✓
Arquivo com nome claro e específico —
stripe-api.mdsim,api-stuff.mdnão - ✓ SOP quando alguém novo precisar re-rodar — só documenta processo que se repete com outros
- ✓ Sub-OS para vertical genuinamente separada — youtube-os/ só se tem workflow próprio distinto
✗ O que NÃO ADICIONAR
- ✗ Dump de email/Slack em references/ — o agente vai tentar ler tudo; contexto inchado = respostas vagas
- ✗ Folder-of-folders sem arquivo — hierarquia profunda sem conteúdo é burocracia pura
- ✗ notes/ misc/ tmp/ inbox/ — cemitérios de intenção; tudo entra, nada sai
- ✗ Pré-criar pastas "para quando precisar" — estrutura sem uso engana o agente sobre o que existe
- ✗ Segundo CLAUDE.md em subpasta — um só na raiz; múltiplos criam conflito de autoridade
⚠️ Regra de Ouro
Duplicar a estrutura do decisions/log.md em outro lugar é o erro mais silencioso: duas fontes de verdade para decisões significa que o agente não sabe em qual confiar e você começa a ter comportamento inconsistente ao longo das sessões.
Cadências sugeridas
O AIOS é um sistema vivo. Sem manutenção, decisões ficam desatualizadas, arquivos se acumulam e o agente passa a operar com contexto podre. As cadências abaixo mantêm o sistema saudável com esforço mínimo.
Toda decisão → decisions/log.md
Ferramenta nova, mudança de processo, escolha de fornecedor. Quanto mais decisões logadas, mais o agente entende o "porquê" por trás da estrutura — não apenas o "o quê".
Cada ferramenta nova → connections.md
Adiciona a tool imediatamente, não "depois". O /audit lê este arquivo para saber o que está disponível — um connections.md desatualizado gera sugestões erradas.
Limpeza trimestral → archives/
A cada 3 meses, mova para archives/ qualquer contexto, projeto ou referência que não foi tocado. Não apague — arquive. O histórico tem valor, mas não precisa poluir o contexto ativo.
Revisão trimestral do CLAUDE.md
As instruções do agente envelhecem. A cada ciclo, revise se as preferências, ferramentas e processos descritos ainda refletem como você opera. Um CLAUDE.md defasado é pior que nenhum.
Quando re-rodar com alguém → references/sops/
SOP só precisa existir quando uma segunda pessoa (ou você mesmo, após 6 meses) precisar repetir o processo sem contexto. Documente o suficiente para isso — não mais.
⏱️ Dica Prática: o gatilho certo
Não agende "revisão do AIOS" no calendário — amarre cada cadência a um evento natural. Tomou uma decisão relevante? Log imediato. Fechou um trimestre? Archive + revise CLAUDE.md. Contratou alguém? Escreva o SOP. Gatilho claro = não esquece.
A Regra dos 3 Sins
Toda vez que sentir o impulso de criar uma nova pasta ou arquivo no AIOS, responda 3 perguntas. A resposta determina se você adiciona agora ou espera. Simples, rápida, infalível.
🔢 As 3 perguntas
É conceitualmente novo?
Não é apenas uma variação do que já existe em outro arquivo. Precisa de um "container" próprio para fazer sentido.
Vou tocar 3+ vezes no próximo mês?
Frequência é o principal indicador de utilidade. Uma pasta raramente visitada é ruído — o agente considera tudo na estrutura quando navega.
O /level-up rotearia uma skill futura para cá?
Se o agente, ao automatizar algo novo, naturalmente salvaria aqui, este é um destino legítimo. Bom sinal de que a abstração faz sentido.
✓ 2+ sins → Adiciona agora
- ✓Crie a pasta ou arquivo imediatamente
- ✓Nomeie de forma específica (não genérica)
- ✓Atualize o
CLAUDE.mdse for um novo destino recorrente - ✓Logue a decisão de criação em
decisions/log.md
✗ 1 sim (ou nenhum) → Espera
- ✗Não crie estrutura prematura
- ✗Use a estrutura existente, mesmo que "não seja perfeita"
- ✗Reavalie em 30 dias — a frequência real vai aparecer
- ✗Se continuar incomodando, o gatilho vai ficar claro sozinho
Branch frameworks (futuro) + filosofia
O AIS-OS é um kit intencional — não uma plataforma com features infinitas. Há frameworks avançados que podem ser adicionados conforme a operação amadurece. E há uma filosofia que os conecta: clareza acima de completude.
🌿 Branch frameworks (adicione quando a operação exigir)
Data Retrieval Hierarchy
Define a ordem de prioridade para busca de informação: contexto ativo → references → archives → web. Elimina ambiguidade quando há conflito de fontes.
Integration Ladder
Hierarquia de profundidade de integração: leitura → escrita → automação → orquestração. Útil quando você tem muitas tools e precisa priorizar.
Error Handling Playbook
Protocolos para quando o agente trava, erra ou entra em loop. Essencial em operações de alta frequência ou críticas.
Model Selection
Critérios para escolher qual modelo usar em qual tarefa — balanço entre custo, velocidade e capacidade de raciocínio.
Context Engineering
Técnicas para estruturar o contexto de forma que o agente encontre o que precisa sem ser sobrecarregado. Inclui chunking, resumo ativo e pinning.
Security & Permissions
Camadas de autorização para operações sensíveis: o que o agente pode fazer sem perguntar, o que pede confirmação e o que é proibido.
🏡 A filosofia final
"Seu AIOS deve parecer um negócio pequeno e bem-gerido — não um porão de acumulador."
Um negócio bem-gerido tem processos claros, espaços limpos, decisões documentadas e sabe exatamente o que tem. Um porão de acumulador tem tudo "por via das dúvidas", nada está onde deveria estar e ninguém tem coragem de mexer. O seu AIOS é qual dos dois?
✓ Negócio bem-gerido
- ✓Estrutura mínima e funcional — cada coisa tem lugar claro
- ✓Decisões logadas — o agente entende o histórico
- ✓Arquivos ativos vs arquivados — contexto limpo
- ✓Cresce sob demanda — sem overhead desnecessário
✗ Porão de acumulador
- ✗Pastas para tudo — nenhuma com conteúdo útil
- ✗Arquivos "por precaução" — que nunca são abertos
- ✗Contexto misturado com lixo — agente fica confuso
- ✗Cresce sem critério — cada ideia vira uma pasta nova
🌱 Resumo do Módulo
Você concluiu o AIS-OS!
Você passou pelas 3 trilhas — Mindset, Arquitetura e Operação na Prática. Agora tem os fundamentos, a estrutura e as rotinas para operar um AI Operating System real. O próximo passo é usar, iterar e deixar o sistema crescer com você.