Layer 2: Claude Code Memory (Quick Access)

• Path: ~/.claude/projects/*/memory/
• Format: Markdown files with frontmatter
• Types: user preferences, feedback, project context, reference
• Use for: quick-access context that persists across conversations
• Automatically loaded at session start

Layer 3: MCP Memory Server (Structured Knowledge Graph)

• Access: MCP memory tools (create_entities, create_relations, add_observations, search_nodes)
• Use for: Semantic search across all stored memories, relationship mapping
• Cross-session persistence with queryable graph structure

Layer 4: Knowledge base repo / durable document store

• Use for: curated durable notes, session exports, synthesized research, operator memory, long-form docs
• Rule: this is the preferred durable store for cross-machine context when the content is not repo-owned code

Layer 5: External Data Store (Supabase, PostgreSQL, etc.)

• Use for: Structured data, large document storage, full-text search
• Good for: Documents too large for memory files, data needing SQL queries

Layer 6: Local context/archive folder

• Use for: human-facing notes, archived gameplans, local media organization, temporary non-code docs
• Rule: writable for information storage, but not a shadow code workspace
• Do not use for: active code changes or repo truth that should live upstream

Ingestion Workflow

When new knowledge needs to be captured:

1. Classify

What type of knowledge is it?

• Business decision -> memory file (project type) + MCP memory
• Active roadmap / release / implementation state -> GitHub + Linear first
• Personal preference -> memory file (user/feedback type)
• Reference info -> memory file (reference type) + MCP memory
• Large document -> external data store + summary in memory
• Conversation/session -> knowledge base repo + short summary in memory

2. Deduplicate

Check if this knowledge already exists:

• Search memory files for existing entries
• Query MCP memory with relevant terms
• Check whether the information already exists in GitHub or Linear before creating another local note
• Do not create duplicates. Update existing entries instead.

3. Store

Write to appropriate layer(s):

• Always update Claude Code memory for quick access
• Use MCP memory for semantic searchability and relationship mapping
• Update GitHub / Linear first when the information changes live project truth
• Commit to the knowledge base repo for durable long-form additions

4. Index

Update any relevant indexes or summary files.

Sync Operations

Conversation Sync

Periodically sync conversation history into the knowledge base:

…

quarkus-verification

为 Quarkus 项目执行发布前验证闭环，涵盖构建、测试、扫描与差异审查。

knowledge-mcp

为 MCP 代理提供本地知识库的检索、浏览与文档获取能力。