convez.ai
MCP Server
wujiajun4

brain-sync

wujiajun4/brain-sync

Ver no GitHub
InicialPluginScore · de 0 a 100

Fast reflexes, deep memory, no drift.

Instalação

$npx convez-ai wujiajun4/brain-sync

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.

🧠 Brain Sync

Fast reflexes. Deep memory. No drift.

小脑快反应。大脑深记忆。零漂移。

version platform license lang

Features · Install · Architecture · Contributing

npx skills add wujiajun4/brain-sync -g


Screenshot


About

You have three memory systems. They don't talk to each other. Brain Sync fixes that — extracts triggers and relations for your fast-twitch Memory MCP, keeps deep docs in your Obsidian brain. TRUST 5 quality gate on every sync.

Brain Sync keeps your three-layer AI memory stack in sync without duplication. It reads your Obsidian knowledge base, extracts the "how to use" information (triggers, relations, orchestras), and stores it in Memory MCP for 0.1-second reflexes. Full documentation stays in Obsidian for deep reasoning.

你有三个记忆系统。它们互相不说话。 Brain Sync 修复这个问题——提取触发词和关系到 快反应小脑,把深度文档留在大脑。每次同步都过 TRUST 5 质量门。

Key Features

FeatureWhat it does
🔍 Drift DetectionCompares Obsidian skill count vs Memory MCP entity count
➕ Auto-sync MissingCreates entities for skills not yet in Memory MCP
🔗 Auto-relationsLinks every new tool to its orchestra
👻 Ghost PruningRemoves entities that no longer exist in Obsidian
✂️ obs CompressAuto-split observations ≤ 200 chars (TRUST 5 R dimension)
📑 Drift CheckCLI tool: scan Memory MCP ↔ MEMORY.md, find missing entities
🎯 Hot-Trigger AuditCLI tool: static analysis of CLAUDE.md hot-trigger list health
✅ TRUST 5 Quality GateTested · Readable · Unified · Secure · Trackable
📊 Sync ReportBefore/after table with pass/fail for each dimension
🎚️ Progressive DisclosureL1 150-token summary → L2 4000-token full spec

Tech Stack

CategoryTechnology
PlatformClaude Code · Agent Skills (67+ platforms)
LanguageMarkdown (SKILL.md)
RuntimeMemory MCP · Obsidian knowledge base
Design ReferenceMoAI-ADK TRUST 5 · Progressive Disclosure
DependenciesZero — pure instruction skill

Architecture

┌─────────────────────────────────────────────┐
│                 Brain Sync                  │
│                                             │
│  ┌──────────┐    extract     ┌───────────┐  │
│  │ Obsidian │ ──triggers──→ │ Memory    │  │
│  │ (Brain)  │  +relations   │ MCP       │  │
│  │          │               │ (Cereb.)  │  │
│  │ Deep     │  don't sync   │ Fast      │  │
│  │ docs     │ ←──────────── │ reflexes  │  │
│  │ logs     │  code blocks  │ triggers  │  │
│  │ specs    │  trade data   │ relations │  │
│  └──────────┘               └───────────┘  │
│                                             │
│  ┌──────────────────────────────────────┐   │
│  │         TRUST 5 Gate                 │   │
│  │  Tested · Readable · Unified ·       │   │
│  │  Secure · Trackable                  │   │
│  └──────────────────────────────────────┘   │
│                                             │
│  ┌──────────────────────────────────────┐   │
│  │         Sync Report                  │   │
│  │  Tools: 10+  Prefs: 12  Ghosts: 0   │   │
│  │  + bin/compress-obs + check-drift    │   │
│  │  + bin/hot-trigger-audit (v1.2)     │   │
│  └──────────────────────────────────────┘   │
└─────────────────────────────────────────────┘

Project Structure

brain-sync/
├── .gitignore
├── LICENSE               # MIT
├── README.md             # ← You are here
├── SKILL.md              # Runtime spec — L1/L2 progressive disclosure
                          #   5-step pipeline + TRUST 5 gate + sync report template
└── bin/                  # CLI helpers (v1.2.0+)
    ├── compress-obs.mjs      # Auto-split long observations to ≤200 chars
    ├── check-drift.mjs       # Memory MCP ↔ MEMORY.md drift detection
    └── hot-trigger-audit.mjs # Static analysis of CLAUDE.md hot-trigger list

Getting Started

Prerequisites

  • Claude Code or any Agent Skills-compatible platform
  • Memory MCP configured and running
  • Obsidian knowledge base at ~/obsidian/knowledge-base/

Install

# Claude Code (one command / 一行命令)
mkdir -p ~/.claude/skills && git clone https://github.com/wujiajun4/brain-sync.git ~/.claude/skills/brain-sync

# Agent Skills (any platform / 全平台)
npx skills add wujiajun4/brain-sync -g

Usage

You sayWhat happens
/brain-syncManual sync
sync memory · 更新小脑 · 同步记忆Chinese/English triggers
(auto)After orchestra-intake · skill created · preference written

TRUST 5 Quality Gate

Every sync passes through five automated checks. If any fail, the report tells you exactly what to fix.

DimensionCheckFailure means
T TestedCan search_nodes find the new entity?Write failed — entity not persisted
R ReadableObservations ≤ 3 each, ≤ 200 chars eachSmall brain overloaded — trim it
U UnifiedObsidian count ≈ Memory MCP count?Brains drifted — gap > 2 warns, > 5 fails
S SecureNo ghp_ / sk- / token leaks in observations?Immediate fix — expose credential
T TrackableSync report output?No audit trail

Pair with Your Other Skills

tool-eval      → Evaluate someone else's tool (should I install this?)
preflight      → Check your own project (is this ready to ship?)
brain-sync     → Sync small brain and big brain (memory consistent?)

All three belong to Orchestra ⑮ AI/ML — your skill development toolchain.


Contributing

Issues and PRs welcome. Before submitting — eat your own dog food:

/preflight --strict

Changelog

v1.2.0 (2026-06-08) — Bin Helpers

+ 3 CLI tools to automate the most common TRUST 5 dimensions:

  • bin/compress-obs.mjs — Smart-split observations to ≤200 chars (preserves .md/URL paths, handles CJK punctuation)
  • bin/check-drift.mjs — Drift detection between Memory MCP entities and MEMORY.md index (filter-prefix support)
  • bin/hot-trigger-audit.mjs — Static analysis of CLAUDE.md hot-trigger list (total / active / dead / duplicate / bloat)

Zero new dependencies. Pure Node.js, runs in CI.

v1.1.1 (2026-06-07)

  • SKILL.md frontmatter standardization (MoAI progressive disclosure + triggers)

v1.1.0 (2026-05-XX)

  • TRUST 5 quality gate

v1.0.0 (2026-05-XX)

  • Initial release

Acknowledgements

  • TRUST 5 quality gate adapted from MoAI-ADK (Apache 2.0)
  • Progressive Disclosure pattern from MoAI-ADK's three-tier knowledge delivery design
  • Built with Agent Skills specification

License

MIT — © 2026 wujiajun4

Ver o original no GitHub

Bom para

Relacionados