personal-os

OS pessoal com Claude Code

Esta skill ajuda a construir um "brain": uma pasta de arquivos de texto (em formato Markdown, legível em qualquer editor) onde o Claude Code guarda o que você confia a ele, recupera o que foi decidido e prepara seus próximos passos. Ela orienta passo a passo, com perguntas simples no início e modelos para copiar depois.

Princípio de leitura: siga as etapas em ordem na primeira vez. Os arquivos em references/ contêm os detalhes e os modelos. Você pode consultá-los conforme necessário.

0. Para que serve e o que você obtém

Sem memória, cada conversa com Claude recomeça do zero. Com um brain, a conversa se torna descartável e a pasta se torna a memória: o que importa é escrito em um arquivo, e Claude relê os arquivos antes de responder.

O que você obtém ao final da configuração:

• Uma caixa de depósito (inbox/) onde você coloca qualquer material bruto: transcrição de reunião, anotações, e-mail copiado, captura.
• Um processamento em quatro categorias: decisões (com sua razão), ações (com seu responsável), novos fatos, perguntas em aberto.
• Um diário, um registro de decisões e uma cronologia que nunca são reescritos: apenas se adiciona, não se modifica.
• Fichas de tópicos (um arquivo por projeto) e tabelas de resumo regeneradas por um pequeno script.
• Agentes especializados (ingestão, revisão de board, verificação de consistência, redação, preparação de 1:1, aconselhamento sobre decisões) e comandos curtos (/inbox, /journal...).
• Um arquivo de acompanhamento de mudanças (CHANGELOG.md) que informa o que deve ser reportado em uma ferramenta externa (wiki, ferramenta de tickets, apresentação).

Nada é escrito sem seu consentimento: Claude propõe, você valida, e então ele escreve.

1. Pré-requisitos

• Claude Code instalado e funcional em sua máquina (comando claude disponível no terminal).
• Uma pasta vazia, por exemplo ~/brain. Ela será a única área onde Claude tem permissão para escrever para este projeto.
• Python 3 para o script de visualizações (opcional, nada mais a instalar).
• Um editor de texto que abra Markdown. Um repositório Git é recomendado, pois permite reverter alterações, mas não é obrigatório.

Abra um terminal na pasta vazia e execute claude.

2. A entrevista inicial

Claude faz estas sete perguntas, uma de cada vez, aguardando sua resposta para cada uma. Respostas curtas são suficientes. Veja o que Claude faz com cada resposta.

Pergunta	O que Claude faz com ela
1. Qual é seu cargo e sua equipe, em uma frase?	Preenche a seção "Quem sou eu" de CLAUDE.md para que Claude se dirija a você no nível adequado.
2. Quais são seus três a cinco projetos em andamento?	Cria uma ficha de tópico por projeto em 05_scope/sheets/.
3. Com quais pessoas você mais trabalha (nome, função)?	Preenche 03_team/directory.md e prepara a lista de nomes a serem reconfirmados.
4. Que tipos de materiais você recebe (transcrições, e-mails, anotações, capturas)?	Configura a triagem de inbox/ e a lista de formatos que Claude sabe ler.
5. Onde o que você produz deve ser reportado (wiki, ferramenta de tickets, apresentações)?	Adapta CHANGELOG.md: uma linha por página a ser atualizada, com "adicionar" ou "substituir".
6. Em qual idioma você escreve, e quais regras de escrita deseja?	Preenche a seção "Estilo" de CLAUDE.md.
7. Com que frequência você deseja revisões (dia, semana, antes de um 1:1)?	Escolhe os comandos e agentes a serem instalados primeiro (etapa 5).

Antes de continuar, Claude resume o que entendeu em dez linhas e aguarda sua concordância.

3. Criar a estrutura

Claude propõe a árvore de diretórios descrita em references/structure.md e, em seguida, a cria após sua concordância. As pastas básicas são:

• inbox/ e archive/: o depósito de materiais brutos e seu armazenamento após processamento.
• 00_journal/: diário e cronologia (apenas adição).
• 01_steering/: direcionamento, com o board de tarefas.
• 02_product/: fatos duradouros sobre os produtos.
• 03_team/: diretório de pessoas, notas de colaboração.
• 04_decisions/: registro de decisões (apenas adição).
• 05_scope/: fichas de tópicos e visualizações geradas.
• 06_resources/: glossário, documentos de referência.
• scripts/: o script de visualizações.
• .claude/: agentes e comandos.

Regra de ouro: um arquivo, um tópico, um nome neutro. Nenhum arquivo leva o nome de uma pessoa. O que diz respeito a uma pessoa vai para o diretório.

Em seguida, copie os modelos de references/templates/ substituindo os campos entre colchetes por suas respostas da etapa 2.

4. Escrever o arquivo de instruções CLAUDE.md

CLAUDE.md é lido automaticamente pelo Claude Code a cada sessão. Ele contém as regras do jogo. Parta do modelo references/templates/CLAUDE.md e verifique se ele diz, no mínimo:

1. Quem você é e como Claude deve se dirigir a você.
2. O que Claude faz quando uma informação nova chega (o protocolo de ingestão, veja references/ingestion-rules.md).
3. A regra de atualização, os arquivos apenas para adição, a regra "um fato, um único arquivo".
4. As regras de segurança da etapa 9.
5. O estilo de escrita que você escolheu na pergunta 6.
6. A lista de nomes próprios frequentemente distorcidos pelas ferramentas de transcrição, a ser completada ao longo do tempo.

Mantenha este arquivo curto: uma a duas páginas. Os detalhes vivem nos arquivos em references/, que Claude lê conforme necessário.

5. Adicionar os agentes e comandos

Um agente é um assistente especializado que tem suas próprias instruções e seus próprios direitos. Um comando é um atalho que você digita no Claude Code (por exemplo /inbox). Ambos são simples arquivos Markdown em .claude/.

Comece pequeno. Instale primeiro:

• o agente inbox-ingestion e o comando /inbox (para processar o que você deposita);
• o comando /journal (para registrar uma nota rápida).

Adicione depois, conforme a necessidade surgir: board-review, consistency-check, deliverables-writer, meeting-prep, decision-advisor e os comandos /review-board, /prep-1to1, /propagate. A função de cada um está em references/agents.md, os modelos a copiar em references/templates/.claude/.

Após cada adição, peça a Claude que verifique se o arquivo é lido: digite /agents para ver a lista.

6. Primeiro teste: depositar uma nota e processá-la

1. Escreva ou cole uma nota real (mesmo curta) em inbox/, por exemplo inbox/2026-01-15_reuniao-equipe.txt.
2. Digite /inbox.
3. Claude lê o arquivo, identifica trechos duvidosos, cruza com o existente e retorna uma lista numerada de modificações propostas, com cada uma: o arquivo, o antes, o depois e a fonte.
4. Responda "valido 1, 2, 4" ou "valido tudo". Sem resposta clara, nada é escrito.
5. Claude escreve, move o original para archive/, registra o que foi feito em CHANGELOG.md e executa novamente o script de visualizações.

O protocolo completo está em references/inbox-processing.md. Um exemplo completo, com a nota bruta e o resultado, está em references/example-acme/.

7. As rotinas

Quatro ritmos são suficientes para começar.

• Cada dia (5 minutos). Deposite o que chegou em inbox/, digite /inbox, valide. No final do dia, digite /journal para uma nota livre.
• Após uma reunião. Deposite a transcrição ou suas anotações, digite /inbox. Verifique prioritariamente as decisões e sua razão, depois as ações e seu responsável.
• Cada semana. Digite /review-board, depois peça ao agente consistency-check para verificar datas, status e nomes. Execute novamente o script de visualizações.
• Antes de um 1:1. Digite /prep-1to1 [nome]. O agente meeting-prep reúne o que foi dito, o que está pendente e as perguntas em aberto, com a fonte de cada linha.

8. Fazer evoluir

• Adicionar um tópico. Copie references/templates/scope-sheet.md para 05_scope/sheets/, preencha os campos e execute o script de visualizações.
• Adicionar um agente. Copie um modelo de references/templates/.claude/agents/, altere seu nome, descrição e instruções. Teste-o em um caso real antes de adotá-lo.
• Adicionar uma visualização. Escreva ou mande escrever um pequeno script que leia as fichas e produza uma tabela. Ele lê, nunca modifica as fichas. O script references/scripts/build_views.py serve como ponto de partida.
• Uma mudança afeta vários conteúdos. Use /propagate (veja o caso de uso em references/use-cases.md).

Antes de adicionar qualquer coisa, faça quatro perguntas. Isso me evita perder uma decisão e sua razão? Isso me informa a próxima ação e seu responsável em cada projeto? Isso reduz o esforço para mudar de um tópico para outro? Isso deixa um rastro útil para minha equipe? Se a resposta for não para todas, não adicione.

9. Regras de segurança

1. Proponha, valide, escreva. Claude apresenta primeiro o que pretende modificar. Ele só escreve após seu consentimento explícito.
2. Nunca inventar. Uma decisão ou ação que não está no texto não é criada. Se a razão de uma decisão faltar, escreve-se "razão não documentada".
3. Sinalizar a dúvida. Quando um trecho é ambíguo ou um nome se assemelha a uma distorção de transcrição, Claude diz e pergunta em vez de decidir.
4. Não excluir nada sem consentimento. Nenhum arquivo é excluído ou movido para fora do fluxo previsto (inbox para archive) sem que você tenha solicitado.
5. Distinguir fato, compromisso e ideia. O que está feito, o que você prometeu a alguém e o que você está considerando são três status diferentes. Uma sugestão de Claude nunca é apresentada como um compromisso.
6. Manter a proveniência. Cada linha importante remete à sua fonte (arquivo, data).

Lista de verificação

• claude inicia na pasta do brain e lê CLAUDE.md.
• As sete perguntas da etapa 2 receberam resposta e um resumo validado.
• As pastas da etapa 3 existem, sem arquivo com nome de pessoa.
• O diário, o registro de decisões e a cronologia estão declarados como "apenas adição" em CLAUDE.md.
• A regra de atualização e a regra "um fato, um único arquivo" constam em CLAUDE.md.
• O agente inbox-ingestion e o comando /inbox aparecem em /agents e na lista de comandos.
• Um primeiro teste foi realizado até o fim: proposta, validação, escrita, arquivamento, linha em CHANGELOG.md.
• python3 scripts/build_views.py executa sem erros e produz as visualizações.
• As quatro rotinas da etapa 7 estão anotadas em algum lugar que você consulta.
• As regras de segurança da etapa 9 estão copiadas em CLAUDE.md.

Arquivos da skill

Arquivo	Conteúdo
references/structure.md	Árvore de diretórios recomendada e função de cada pasta
references/ingestion-rules.md	Regras de ingestão, com exemplos antes e depois
references/inbox-processing.md	Protocolo de processamento de um arquivo de inbox, exemplo completo
references/agents.md	Catálogo dos seis agentes
references/use-cases.md	Sete cenários de uso
references/templates/	Modelos para copiar (instruções, board, registro, diário, fichas, agentes, comandos)
references/scripts/build_views.py	Script de geração de visualizações
references/example-acme/	Brain de exemplo completo e fictício