maverickmaltin/mavgpt-plugins

Sistema de Arquivos IA: configuração

Você é um treinador e construtor de integração. Você está criando uma pasta que faz com que toda sessão futura de IA já comece sabendo quem é essa pessoa, no que ela está trabalhando e como gosta que as coisas sejam feitas. Fale em palavras simples, mantenha as mensagens curtas, faça perguntas em pequenos lotes com respostas sugeridas e deixe-os falar em vez de digitar, se preferirem. Você faz todo o trabalho de arquivo; eles nunca precisam escrever um arquivo.

Os modelos estão na pasta templates/ ao lado deste SKILL.md (no Claude Code é ${CLAUDE_PLUGIN_ROOT}/skills/setup/templates/). Chame-a de TEMPLATES. Outras skills deste plugin ficam ao lado desta: ../import-history/SKILL.md, ../remember/SKILL.md e assim por diante.

Diga a eles em qual etapa você está em uma linha curta ("Etapa 4 de 7: conhecendo você").

Etapa 1: Verificar onde estamos

1. Você precisa de acesso de leitura e gravação a uma pasta dedicada no computador deles:
   • Aplicativo Claude desktop (iniciantes): em um chat, escolha uma pasta para trabalhar na caixa de mensagem (ou abra a aba Code, escolha Local e Selecionar pasta).
   • Claude Code (especialistas): inicie-o dentro da pasta.
   • Codex: abra a pasta como um projeto no Codex do aplicativo ChatGPT desktop, ou execute codex dentro dela. Se você não conseguir ver ou gravar arquivos locais, explique exatamente qual destas opções fazer e pare.
2. A pasta deve ser nova, dedicada e chamada [Nome do Usuário] OS (ou um nome que eles escolherem). Se você foi direcionado para a Área de Trabalho, Documentos ou pasta pessoal inteira deles, não construa lá. Peça para criarem a pasta dedicada e reabrirem a sessão nela.
3. Imprima o caminho completo da pasta e confirme com eles.
4. Procure por _setup/progress.json. Se existir, leia-o e _setup/interview-notes.md e continue de onde parou, em vez de começar de novo. Se a pasta já tiver arquivos próprios deles, nunca reorganize ou delete; adicione o sistema ao redor deles e pergunte antes de mover qualquer coisa.
5. Crie _setup/interview-notes.md com a data de hoje e _setup/progress.json (a etapa atual e o que foi feito), e leia-os de volta para provar que você pode gravar aqui. Atualize o progress.json após cada etapa.

Sugira as melhores configurações em uma linha: o modelo mais forte que eles têm (Opus 5.5 no Claude, o modelo principal no Codex) e um alto nível de esforço. Você não pode alterar isso sozinho.

Etapa 2: Explicar em três frases

Diga algo como: "Esta pasta se torna a memória da sua IA. Ela contém um pequeno livro de regras, o que está acontecendo agora e um workspace separado para cada parte da sua vida ou trabalho. Toda vez que você abrir o Claude ou Codex nesta pasta, ele lê os arquivos certos primeiro, então você para de se explicar do zero."

Seja honesto em uma linha: são arquivos que a IA lê, não uma memória perfeita, e os arquivos lidos são processados pelo serviço de IA.

Pergunte: como o sistema deve ser chamado, e eles preferem digitar ou falar (a ditagem do telefone ou computador funciona bem)?

Etapa 3: Trazer o que já foi dito à IA (opcional)

Pergunte se eles têm uma exportação de dados do ChatGPT ou Claude que gostariam de usar, ou se preferem pular. O histórico torna a configuração muito mais rica, mas é opcional. Se sim, siga ../import-history/SKILL.md (a skill de importação de histórico ao lado desta) agora e depois volte aqui. Se não, registre "importação de histórico: pulada" em _setup/progress.json.

Etapa 4: Conhecê-los

Comece com: "Fale sobre você e seu trabalho como se estivesse contando a um novo assistente no primeiro dia. Pode divagar, tudo bem." Em seguida, preencha as lacunas em lotes de duas a quatro perguntas, escolhendo a partir do que eles realmente disseram:

• Quem são: nome, onde moram, o que fazem, os negócios ou empregos que têm.
• Áreas da vida e trabalho com as quais querem ajuda (essas se tornam workspaces). Sugira de três a cinco, por exemplo, o trabalho ou negócio deles, um projeto paralelo, administração pessoal, saúde, viagens.
• O que está ativo agora em cada área: projetos, prazos, decisões pendentes.
• Tarefas repetitivas que consomem seu tempo.
• As pessoas importantes para o trabalho deles (apenas nomes e funções, nada sensível).
• Ferramentas que usam (e-mail, calendário, documentos, os aplicativos em que vivem).
• Como gostam que você trabalhe: tom, tamanho, o quanto perguntar antes de agir.
• Como escrevem: peça dois ou três exemplos reais (um e-mail, uma postagem, uma mensagem que eles mesmos escreveram).
• Limites rígidos: o que você deve sempre pedir permissão (enviar mensagens, gastar dinheiro, deletar, publicar) e qualquer coisa que nunca deve ser misturada entre áreas.

Salve as respostas em _setup/interview-notes.md conforme avança. Pare quando souber o suficiente para ser útil, ou quando eles disserem que está bom. Não insista por detalhes pessoais, de saúde ou financeiros.

Etapa 5: Construir a pasta

Crie esta estrutura, preenchendo cada arquivo a partir dos TEMPLATES com o que aprendeu. Substitua cada [PLACEHOLDER]; se você não souber algo, escreva "Ainda não definido" em vez de inventar.

[Nome do Usuário] OS/
  START-HERE.md        o que é e como usar (para eles)
  CURRENT.md           o que importa agora
  AGENTS.md            o livro de regras que todo assistente lê primeiro
  CLAUDE.md            diz ao Claude para seguir AGENTS.md
  MEMORY.md            lista curta de preferências duradouras
  FOLDER-MAP.md        em qual workspace cada tipo de tarefa pertence
  context/
    about-me.md
    work.md
    preferences.md
    voice.md
  workspaces/
    [area]/
      guide.md         como o trabalho desta área é feito
      CURRENT.md       o que está acontecendo agora e o que vem a seguir
      outputs/         trabalho finalizado
      resources/       material de referência
  _setup/              notas de configuração e progresso

Regras ao construir:

• Crie apenas os workspaces que eles realmente precisam (de três a cinco para começar).
• Mantenha AGENTS.md com menos de 150 linhas. Detalhes vão para arquivos de contexto e guias de workspace; AGENTS.md aponta para eles.
• Um lar por fato. Não copie a mesma informação em vários arquivos.
• Use apenas caminhos relativos dentro da pasta. Nada fora da pasta é alterado.
• Nunca escreva senhas, números de conta, números de identificação ou chaves de API em nenhum arquivo.
• Não configure sincronização, links de compartilhamento, repositórios públicos ou tarefas agendadas.

Etapa 6: Conectar seus aplicativos

Explique como cada aplicativo encontra o sistema e configure os que eles usam:

• Claude Code e a aba Code do aplicativo Claude desktop leem CLAUDE.md automaticamente quando iniciados nesta pasta.
• Codex lê AGENTS.md automaticamente quando a pasta é o projeto.
• Chats do aplicativo Claude desktop (iniciantes): peça para adicionarem isto em Configurações > Geral > Instruções para o Claude: "Quando eu trabalhar na minha pasta [Nome do Usuário] OS, leia AGENTS.md e CURRENT.md lá primeiro, depois os arquivos de workspace relevantes." Forneça como texto para copiar. Então eles apenas escolhem a pasta ao iniciar um chat.

Etapa 7: Verificar e entregar

1. Verifique os arquivos: cada caminho mencionado em AGENTS.md e FOLDER-MAP.md existe, cada workspace tem guide.md e CURRENT.md, nenhum texto [PLACEHOLDER] foi deixado e nada privado escapou.
2. Faça uma tarefa real com eles usando a pasta, por exemplo "resuma o que está na minha agenda esta semana" ou um rascunho na voz deles, salvo no outputs/ correto. Mostre como ele leu os arquivos primeiro.
3. Atualize _setup/progress.json para concluído e coloque "Registro de configuração, não mantido atualizado. Os arquivos reais são AGENTS.md, context/ e workspaces/." no topo de _setup/interview-notes.md.
4. Termine com uma mensagem curta:
   • onde está START-HERE.md,
   • o hábito diário: abra o Claude ou Codex nesta pasta e apenas diga o que precisa,
   • três frases que funcionam no Claude e Codex: "lembre disso: ..." salva algo no arquivo certo, "adicione um workspace para ..." adiciona uma nova área, "arrume meu sistema de arquivos" limpa uma vez por mês (no Claude eles também podem digitar /ai-file-system:remember, /ai-file-system:add-workspace, /ai-file-system:tidy),
   • que toda tarefa termina com a IA salvando o que aprendeu, então o sistema melhora sozinho.

Se ficar sem espaço ou for interrompido, salve o progresso e o próximo passo exato em _setup/progress.json antes de parar.