🏛️ A Arquitetura (4 Cs)

O que é

Uma sessão Claude fresca deve responder "o que esse negócio faz e quem trabalha aqui?" sem navegar em nenhum arquivo. Se não responde com precisão, não há Context configurado.

Por que aprender

Context é o ponto de partida de todo output. Sem ele, o Claude responde de forma genérica — útil para qualquer empresa, específico para a sua.

Conceitos-chave

Sessão fresca: nova janela sem histórico. Teste de identidade: nome, papel, dor principal. Baseline: o que existe antes de construir.

O que é

Três arquivos: about-me.md (identidade, papel, top_pain), about-business.md (oferta, ICP, modelo de receita), priorities.md (prioridades de 90 dias). Fatos interpretados — não dump de documentos.

Por que aprender

Esses três arquivos são carregados em toda sessão. Eles definem o "personagem" do Claude para o seu contexto específico. Sem eles, cada conversa começa do zero.

Conceitos-chave

ICP: Ideal Customer Profile. top_pain: a dor mais frequente do operador. Fatos interpretados: o que significa aquele dado para o negócio, não o dado bruto.

O que é

Arquivo na raiz do projeto, carregado automaticamente pelo Claude Code. Documenta: quem você é, como pensa (3 Ms), onde as coisas moram no projeto, como trabalhar com você. É preenchido pelo /onboard.

Por que aprender

O CLAUDE.md é o "briefing permanente" do seu assistente. Ele reduz o trabalho de contextualização a zero em cada sessão — o Claude já sabe onde está e o que você espera dele.

Conceitos-chave

Canônico: uma única fonte de verdade. Auto-carregamento: Claude Code lê o CLAUDE.md automaticamente ao abrir o projeto. /onboard: skill que preenche o arquivo no Dia 1.

O que é

Amostras da sua voz real coladas literalmente no arquivo — nunca descritas ou digitadas no chat. A instrução ao Claude: "Combine este registro; não finja minha voz em conteúdo externo sem me mostrar antes."

Por que aprender

Descrever voz no chat é contaminação — o Claude interpreta a descrição, não aprende o padrão real. Amostras verbatim ensinam por exemplo. Outputs de conteúdo ficam indistinguíveis do seu estilo.

Conceitos-chave

Verbatim: cópia literal, sem edição. Contaminação: o risco de o Claude imitar uma descrição, não a voz real. Few-shot: técnica de aprendizado por exemplos concretos.

O que é

Registro append-only de decisões estratégicas. Formato padrão: data · Decisão · Por quê · Alternativas consideradas · Owner. O "por quê" é o campo mais importante — sem ele, o registro não tem valor.

Por que aprender

Decisões sem contexto geram re-debate. O log permite ao Claude entender o raciocínio anterior e evitar contradições. Também é audit trail para o /audit.

Conceitos-chave

Append-only: nunca edita entradas antigas, só adiciona. Audit trail: rastro verificável de decisões. Owner: responsável pela decisão.

O que é

Frameworks, SOPs, guias de API, voz. A regra: só fatos interpretados entram aqui — o que aquele dado significa para o negócio, não o dado bruto. O wiki NÃO é depósito de documentos.

Por que aprender

Conhecimento interpretado acelera sessões futuras. O Claude não precisa deduzir o significado de um dado — ele já está documentado. Referências de API salvas aqui evitam re-pesquisa toda vez.

Conceitos-chave

SOP: Standard Operating Procedure. Fato interpretado: dado + significado. Researched-once-saved-forever: princípio de não re-pesquisar o que já foi descoberto.

O que é

"O que tenho na agenda amanhã e quais tarefas vencem?" → o Claude responde com dado vivo, sem paste manual. Se precisou de paste, não há Connections.

Por que aprender

Conexões ao vivo eliminam o loop manual de copiar-colar dados para o chat. O AIOS torna-se proativo porque tem acesso às informações sem intervenção.

Conceitos-chave

Dado vivo: lido diretamente da fonte, não copiado. Paste: antipadrão — indica ausência de conexão real. Read vs write: conexão que lê vs que também escreve.

O que é

Os 7 domínios essenciais: (1) Receita/Financeiro · (2) Interações com cliente · (3) Calendário · (4) Comunicação · (5) Projetos/tarefas · (6) Inteligência de reunião · (7) Conhecimento/arquivos. Todo negócio tem equivalentes.

Por que aprender

O /audit pontua Connections com base na cobertura desses domínios. Conhecê-los ajuda a priorizar quais conexões constroem primeiro — começar pelos domínios de maior alavancagem.

Conceitos-chave

Tier-1: domínios presentes em qualquer negócio, independente de setor. Cobertura: quantos dos 7 estão conectados. Alavancagem: impacto de adicionar cada domínio.

O que é

Quatro mecanismos para conectar sistemas: mcp (servidor MCP) · script (Python/Bash batendo API) · export (dump CSV/JSON) · key+ref (chave .env + doc de API). O kit é API-first; o audit não prefere MCP.

Por que aprender

Não há uma única maneira de conectar. MCP é conveniente mas não obrigatório — um script Python que bate uma API é igualmente válido. O que importa é o dado estar acessível.

Conceitos-chave

MCP: Model Context Protocol. API-first: preferir API direta a automações frágeis. .env: arquivo de variáveis de ambiente para chaves de API.

O que é

Tabela com colunas: # · Domínio · Tool · Mecanismo · Auth · Última checagem. Uma linha por sistema conectado. É o inventário de Connections do seu AIOS.

Por que aprender

Sem um registro, você não sabe o que está conectado. O /audit lê o connections.md para calcular o score de Connections. Um registro completo garante que nenhum domínio seja esquecido.

Conceitos-chave

Inventário: lista auditável de sistemas. Auth: método de autenticação (API key, OAuth). Freshness: quando foi verificado pela última vez.

O que é

Ao conectar uma API, salve references/{tool}-api.md com endpoints, auth e queries principais. O /audit premia isso; skills futuras não re-pesquisam.

Por que aprender

Pesquisa de API consome tempo. Salvando o que descobriu, todo futuro uso daquele sistema começa do ponto onde parou — sem re-pesquisar docs, endpoints ou formatos de autenticação.

Conceitos-chave

API ref doc: documento de referência de endpoints. Endpoints: URLs da API com parâmetros. Compounding: cada conexão documentada acelera as próximas.

O que é

Pelo menos uma conexão precisa ESCREVER — mandar email, postar, criar tarefa. Se tudo é read-only, o AIOS é um visualizador, não um OS.

Por que aprender

Leitura sem escrita é monitoramento passivo. Um OS age. A capacidade de escrever (enviar, criar, atualizar) é o que diferencia um painel de um operador.

Conceitos-chave

Read-only: só lê dados, não modifica. Write permission: autorização para criar/atualizar/deletar. OS vs painel: distingue sistema operacional de simples dashboard.

O que é

Hierarquia de confiabilidade de integração: API direta (mais confiável) > CLI > Browser Automation > Scraping (mais frágil). Sempre prefira o degrau mais confiável disponível.

Por que aprender

Scraping quebra quando o layout muda. Browser automation quebra quando a UI muda. APIs são contratos estáveis — quando disponível, sempre preferível. Saber a hierarquia evita integrar pelo degrau errado.

Conceitos-chave

Integration Ladder: modelo de decisão de mecanismo. Confiabilidade: probabilidade de funcionar amanhã. Contrato de API: interface estável e versionada.

O que é

Uma frase curta dispara um workflow multi-passo que produz um artefato concreto. Se precisar de cinco mensagens explicando o que quer antes de receber algo útil, não há Capability configurada.

Por que aprender

Capabilities são o índice de automações do seu AIOS. Cada skill é uma ação empacotada que pode ser disparada por qualquer membro do time com uma frase natural.

Conceitos-chave

Artefato: output concreto (doc, email, análise). Workflow: sequência de passos com resultado definido. Trigger natural: frase em linguagem comum que dispara a skill.

O que é

Skill = SKILL.md com frontmatter (gatilho + instruções passo a passo). Agent = sub-assistente multi-passo com contexto próprio e modelo mais barato. Skills primeiro — agents são para quando skills não bastam.

Por que aprender

Agents são mais complexos e caros de manter. Skills são simples, previsíveis e fáceis de debugar. A regra é começar pelo mais simples que resolve o problema.

Conceitos-chave

Frontmatter: metadados YAML no topo do SKILL.md. Sub-assistente: Claude rodando em contexto separado. Contexto próprio: isolamento da sessão principal.

O que é

Três skills incluídas: /onboard (setup do Dia 1), /audit (diagnóstico Four-Cs), /level-up (ship 1 automação por semana). Enxutas de propósito — você constrói por cima.

Por que aprender

Essas três skills cobrem o ciclo de vida básico do AIOS: configurar, medir e evoluir. Entender o que cada uma faz orienta onde você deve adicionar suas próprias capabilities primeiro.

Conceitos-chave

/onboard: preenchimento do CLAUDE.md. /audit: diagnóstico e score 0-100. /level-up: ciclo semanal de ship de automação.

O que é

Frontmatter com name e description (quando disparar) + corpo com execução passo a passo. Localização: .claude/skills/<nome>/SKILL.md.

Por que aprender

Saber a anatomia permite criar skills novas do zero sem depender do skill-creator. O frontmatter é o que Claude Code usa para decidir quando invocar a skill automaticamente.

Conceitos-chave

name: identificador da skill. description: gatilho semântico — quando o Claude deve usá-la. corpo: instruções passo a passo para execução.

O que é

Ordem de preferência Boring-is-Beautiful: prompt salvo → skill determinístico (script, sem IA) → skill IA-assistido (1 chamada) → sub-agent (último recurso). Sempre usar o nível mais simples que funciona.

Por que aprender

IA é poderosa mas não é a solução mais simples para tudo. Um script que roda sempre da mesma forma é mais confiável que uma chamada de LLM. Boring = previsível = operacional.

Conceitos-chave

Determinístico: mesmo input → mesmo output sempre. IA-assistido: usa LLM para raciocínio. Boring-is-beautiful: princípio de preferir soluções simples e confiáveis.

O que é

Cada execução do /level-up produz 1 artefato (skill ou automação). Use skill-creator (Anthropic) ou escreva o SKILL.md à mão. Todo artefato começa com bike-method-phase: 1.

Por que aprender

O /level-up é o motor de crescimento do AIOS. Uma automação por semana = 52 automações por ano. Começar no phase 1 garante escopo pequeno e entrega garantida.

Conceitos-chave

bike-method: metodologia de entrega incremental. phase 1: escopo mínimo viável. skill-creator: ferramenta Anthropic para gerar SKILL.md.

O que é

Quando o trabalho exige raciocínio + uso repetível de ferramentas. Sub-agents rodam em contexto próprio para manter a sessão principal enxuta. Localizados em .claude/agents/.

Por que aprender

Agents isolam trabalho complexo do contexto principal. Isso evita que uma análise longa consuma tokens da sessão do operador. São o nível máximo de autonomia — usar com critério.

Conceitos-chave

Contexto próprio: sessão Claude isolada. Modelo mais barato: agents podem usar modelos menores. Haiku para agents: custo menor para tarefas repetitivas.

O que é

Laptop fechado. Um brief cai no inbox. Um colega pergunta e recebe resposta real. Se isso acontece sem que você tenha iniciado manualmente, há Cadence. Se precisou você abrir e rodar, não há.

Por que aprender

Cadence é o nível onde o AIOS para de ser uma ferramenta e começa a ser um sistema operacional de fato — autônomo em ritmo, não apenas em resposta.

Conceitos-chave

Proativo: age sem ser pedido. Reativo: responde quando chamado. Cadence: ritmo regular e autônomo de operação.

O que é

Hooks em .claude/settings.json, ou skills nomeadas com prefixo de frequência: daily-* / weekly-* / monthly-* / morning-* / standup.

Por que aprender

Triggers são a infraestrutura de Cadence. Sem eles, toda automação é manual — você precisa lembrar de rodar. Com triggers, o sistema sabe quando agir.

Conceitos-chave

Hook: evento que dispara execução. settings.json: arquivo de configuração de hooks do Claude Code. Prefixo de frequência: convenção de nomenclatura para skills recorrentes.

O que é

A âncora do kit não é cron — é o ritual: /audit semanal (Dia 7) + /level-up toda sexta. Comportamento cria o hábito; a infraestrutura é secundária.

Por que aprender

Sistemas de cron sem hábito são abandonados. Rituais criam o loop de feedback que mantém o AIOS evoluindo. O /audit toda semana é o que faz o score subir.

Conceitos-chave

Ritual: ação repetida com intenção e regularidade. Cron: agendador automático. Loop de feedback: medir → ajustar → repetir.

O que é

Grafo de dependência completo: Context (base) → Connections + Capabilities (paralelo) → Cadence (topo). Não automatize workflows que não funcionam manualmente. Automação amplifica — não conserta.

Por que aprender

Automatizar um processo ruim cria mais problemas mais rápido. Validar manualmente primeiro garante que o que será automatizado já funciona — então a automação só acelera.

Conceitos-chave

Grafo de dependência: ordem obrigatória de construção. Amplificação: automação escala o que existe, bom ou ruim. Manual-first: validar antes de automatizar.

O que é

Três sinais de que o AIOS mudou como você trabalha: (1) Team-reaches-out — colegas buscam você como referência de IA. (2) Context-switching reduction — menos troca de contexto mental. (3) Knowledge-leaves-your-head — conhecimento sai da cabeça para o sistema.

Por que aprender

KPIs são fáceis de manipular. Experiências são difíceis de falsificar. Esses três sinais mostram que o AIOS criou mudança real de comportamento, não apenas automações no papel.

Conceitos-chave

Team-reaches-out: reconhecimento externo de competência. Context-switching: custo cognitivo de mudar de tarefa. Knowledge externalization: transformar tácito em explícito.

O que é

Quando os indicadores aparecem para uma pessoa, a mesma arquitetura de dados escala: dashboards, automações, rollout de time. Uma empresa onde cada operador roda um AIOS pessoal é uma empresa de fato AI-ready.

Por que aprender

O AIOS individual não é um projeto pessoal isolado — é o protótipo do que a empresa pode se tornar. Dominar os 4 Cs em nível individual é a fundação para escala organizacional.

Conceitos-chave

AI-ready: estrutura preparada para adotar e escalar IA. Rollout: expansão do modelo para todo o time. Arquitetura replicável: padrão que pode ser aplicado por múltiplas pessoas.