CommunityEscrita e Ediçãogithub.com

iamjosuho/memOrb

Framework de memória 'Segundo Cérebro' agnóstico a agentes, inspirado em cinema e biblioteconomia.

O que é memOrb?

O **Memorb** é um framework de memória do tipo 'Segundo Cérebro', agnóstico a agentes de IA, que organiza e recupera conhecimento de forma estruturada. Inspirado em metáforas de cinema e ciência da biblioteca, ele oferece um conjunto de habilidades (skills) modulares roteadas por um arquivo central (`SKILL.md`). Útil para desenvolvedores que usam assistentes como Claude Code ou Cursor, o Memorb garante que operações de arquivo sigam convenções rígidas, integrando desde ingestão de dados (transcrições, artigos) e consultas inteligentes até fechamento de sessão com commit. O sistema é dividido em skills core (obrigatórias, como `memorb-conventions` para estrutura de diretórios) e extensões opcionais (ex.: `m365-meeting-note` para Teams), com instalação interativa e fallbacks elegantes.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add iamjosuho/memOrb

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Memorb (Skill Gateway)

CRÍTICO: Hub de roteamento primário para o vault. Toda operação de arquivo deve seguir estas instruções e o roteamento de sub-skills sem exceção.

Prioridade de Instruções

  1. Instruções Explícitas do Usuário (maior prioridade)
  2. Memorb e Sub-skills Roteadas (sobrescreve comportamento padrão do agente)
  3. Comportamento Padrão do Agente (menor prioridade)

Regras Principais

Antes de realizar qualquer operação de arquivo:

  1. Leia este arquivo gateway.
  2. Leia SKILL.md para cada sub-skill correspondente na tabela de roteamento abaixo.
  3. Todas as operações de escrita devem obedecer a memorb-conventions (caminhos, nomenclatura, frontmatter).
  4. Carregue múltiplas sub-skills se necessário (ex.: processamento de transcrição = m365-meeting-note + memorb-ingest + daily-note).

Tabela de Roteamento de Skills

Skills core residem em skills/core/{name}/SKILL.md. Extensões residem em skills/extensions/{name}/SKILL.md.

Skills Core (memorb-core)

Sub-skillLocalizaçãoGatilho / Cenário
memorb-conventionscore/memorb-conventionsCamada base: caminhos, estrutura de diretórios (memorbs/), nomenclatura, frontmatter, templates. Obrigatório para TODAS as operações de escrita.
memorb-borncore/memorb-bornInicialização do vault (Fase 0), configuração de persona, geração de CLAUDE.md, ou reset /memorb-born.
daily-notecore/daily-noteCriar/atualizar Notas Diárias, entradas de diário, logs rápidos
orbtrack-triagecore/orbtrack-triageProcessar OrbTrack (memorbs/HQ/OrbTrack/), organização PARA, arquivamento de notas
island-reclamationcore/island-reclamationCriar nova Ilha (domínio de interesse/responsabilidade de longo prazo): discutir estrutura antes de criar arquivo
weekly-retrocore/weekly-retroRevisão/resumo semanal (WeeklyRetro/YYYY-Www)
memorb-ingestcore/memorb-ingestIngerir materiais brutos (transcrições, artigos, PDFs) em Long-Term//memorbs/ wiki
memorb-querycore/memorb-queryPerguntas e respostas, comparações, recomendações de decisão via Long-Term//memorbs/ wiki
memorb-lintcore/memorb-lintVerificação de saúde do vault e linting MUSTY de Long-Term//memorbs/ wiki
memorb-forgettercore/memorb-forgetterExecutar arquivamento MUSTY para memorbs/Dump/ e atualizar Wiki Links do vault
session-closeoutcore/session-closeoutEncerramento de sessão: resumo da Nota Diária, log.md, git commit/push
writing-memorb-skillscore/writing-memorb-skillsCriar/modificar skills do vault (Meta)

Skills de Extensão (memorb-extensions)

Sub-skillLocalizaçãoGatilho / Cenário
m365-meeting-noteextensions/m365-meeting-noteProcessar transcrições e atas de reuniões do Teams
recording-transcriptionextensions/recording-transcriptionGravações de voz não-Teams (telefone, entrevista, m4a) para transcrição
business-card-ingestionextensions/business-card-ingestionCartões de visita para memorbs/people/ Page Bundle
memorb-domain-queryextensions/memorb-domain-queryConsulta bidirecional de domínio/email e integração com M365/Outlook
weekly-reportextensions/weekly-reportGerar relatório semanal do CEO em pptx
obsidian-cliextensions/obsidian-cliComandos CLI do Obsidian (requer app em execução)

Instalação Interativa de Extensões e Protocolo de Fallback

Se um cenário exigir uma extensão (ex.: OCR de cartão de visita, processamento de transcrição M365), verifique se skills/extensions/{name}/SKILL.md existe:

  1. Instalada: Leia o SKILL.md da extensão e execute seu fluxo de trabalho especializado.
  2. Não Instalada (Instalação Interativa):
    • Pergunte ao usuário: "💡 Aviso: A extensão '{extension-name}' fornece formatação de domínio aprimorada para esta tarefa. Gostaria que eu a instalasse para você?"
    • Usuário Aceita: Instale a extensão em skills/extensions/{extension-name}/ e execute seu fluxo de trabalho especializado imediatamente.
    • Usuário Recusa / Pular: Prossiga com o fallback elegante para memorb-ingest ou memorb-query core.

Bandeiras Vermelhas

Pare e reverta se racionalizar qualquer um dos seguintes:

  • "É simples, não precisa ler as sub-skills" → As regras do roteador são obrigatórias para todas as operações de arquivo.
  • "Colocar notas na raiz temporariamente" → Novas notas pertencem a memorbs/HQ/OrbTrack/ ou pastas PARA.
  • "Lembro das regras sem precisar ler" → Sempre releia o SKILL.md, pois as regras evoluem.
  • "Pular o closeout desta vez" → session-closeout é um ritual obrigatório para cada sessão.

Encerramento de Sessão

Deve executar session-closeout ao completar uma sessão (resumo da Nota Diária com usar skill: ..., entrada em log.md, git commit/push).

Habilidades Relacionadas