mirror of
https://github.com/SuperClaude-Org/SuperClaude_Framework.git
synced 2025-12-29 16:16:08 +00:00
docs: Replace Mindbase References with ReflexionMemory (#464)
* docs: fix mindbase syntax and document as optional MCP enhancement Fix incorrect method call syntax and clarify mindbase as optional enhancement that coexists with built-in ReflexionMemory. Changes: - Fix syntax: mindbase.search_conversations() → natural language instructions that allow Claude to autonomously select tools - Clarify mindbase requires airis-mcp-gateway "recommended" profile - Document ReflexionMemory as built-in fallback (always available) - Show coexistence model: both systems work together Architecture: - ReflexionMemory (built-in): Keyword-based search, local JSONL - Mindbase (optional MCP): Semantic search, PostgreSQL + pgvector - Claude autonomously selects best available tool when needed This approach allows users to enhance error learning with mindbase when installed, while maintaining full functionality with ReflexionMemory alone. Related: #452 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * docs: add comprehensive ReflexionMemory user documentation Add user-facing documentation for the ReflexionMemory error learning system to address documentation gap identified during mindbase cleanup. New Documentation: - docs/user-guide/memory-system.md (283 lines) * Complete user guide for ReflexionMemory * How it works, storage format, usage examples * Performance benefits and troubleshooting * Manual inspection and management commands - docs/memory/reflexion.jsonl.example (15 entries) * 15 realistic example reflexion entries * Covers common scenarios: auth, DB, CORS, uploads, etc. * Reference for understanding the data format - docs/memory/README.md (277 lines) * Overview of memory directory structure * Explanation of all files (reflexion, metrics, patterns) * File management, backup, and git guidelines * Quick command reference Context: Previous mindbase cleanup removed references to non-existent external MCP server, but didn't add sufficient user-facing documentation for the actual ReflexionMemory implementation. Related: #452 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * docs: translate Japanese text to English in documentation Address PR feedback to remove Japanese text from English documentation files. Changes: - docs/mcp/mcp-integration-policy.md: Translate headers and descriptions - docs/reference/pm-agent-autonomous-reflection.md: Translate error messages - docs/research/reflexion-integration-2025.md: Translate error messages - docs/memory/pm_context.md: Translate example keywords All Japanese text in English documentation files has been translated to English. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> --------- Co-authored-by: Claude <noreply@anthropic.com>
This commit is contained in:
@@ -1,42 +1,68 @@
|
||||
# MCP Integration Policy
|
||||
|
||||
SuperClaude FrameworkにおけるMCP (Model Context Protocol) サーバーの統合ポリシーと使用ガイドライン。
|
||||
Integration policy and usage guidelines for MCP (Model Context Protocol) servers in SuperClaude Framework.
|
||||
|
||||
## MCP Server Definitions
|
||||
|
||||
### Core MCP Servers
|
||||
|
||||
#### Mindbase MCP
|
||||
#### Memory & Error Learning
|
||||
|
||||
**ReflexionMemory (Built-in, Always Available)**
|
||||
```yaml
|
||||
Name: mindbase
|
||||
Purpose: 会話履歴の長期保存と検索
|
||||
Category: Memory Management
|
||||
Auto-Managed: true (Claude Code標準機能)
|
||||
PM Agent Role: None (自動管理、触らない)
|
||||
Name: ReflexionMemory
|
||||
Purpose: Error history storage and learning
|
||||
Category: Memory Management (Built-in)
|
||||
Auto-Managed: true (internal implementation)
|
||||
PM Agent Role: Automatically used on errors
|
||||
|
||||
Capabilities:
|
||||
- 会話履歴の永続化
|
||||
- セマンティック検索
|
||||
- プロジェクト横断の知識共有
|
||||
- 過去の会話からの学習
|
||||
- Memory of past errors and solutions
|
||||
- Keyword-based similar error search
|
||||
- Learning to prevent recurrence
|
||||
- Project-scoped memory
|
||||
|
||||
Lifecycle:
|
||||
Start: 自動ロード
|
||||
During: 自動保存
|
||||
End: 自動保存
|
||||
Cleanup: 自動(ユーザー設定による)
|
||||
Implementation:
|
||||
Location: superclaude/core/pm_init/reflexion_memory.py
|
||||
Storage: docs/memory/reflexion.jsonl (local file)
|
||||
Search: Keyword-based (50% overlap threshold)
|
||||
|
||||
Note: This is an internal implementation, not an external MCP server
|
||||
```
|
||||
|
||||
**Mindbase MCP (Optional Enhancement via airis-mcp-gateway)**
|
||||
```yaml
|
||||
Name: mindbase
|
||||
Purpose: Semantic search across all conversation history
|
||||
Category: Memory Management (Optional MCP)
|
||||
Auto-Managed: false (external MCP server - requires installation)
|
||||
PM Agent Role: Automatically selected by Claude when available
|
||||
|
||||
Capabilities:
|
||||
- Persistence of all conversation history (PostgreSQL + pgvector)
|
||||
- Semantic search (qwen3-embedding:8b)
|
||||
- Cross-project knowledge sharing
|
||||
- Learning from all past conversations
|
||||
|
||||
Tools:
|
||||
- mindbase_search: Semantic search
|
||||
- mindbase_store: Conversation storage
|
||||
- mindbase_health: Health check
|
||||
|
||||
Installation:
|
||||
Requires: airis-mcp-gateway with "recommended" profile
|
||||
See: https://github.com/agiletec-inc/airis-mcp-gateway
|
||||
|
||||
Profile Dependency:
|
||||
- "recommended" profile: mindbase included (long-term projects)
|
||||
- "minimal" profile: mindbase NOT included (lightweight, quick tasks)
|
||||
|
||||
Usage Pattern:
|
||||
- PM Agent: 使用しない(Claude Codeが自動管理)
|
||||
- User: 透明(意識不要)
|
||||
- Integration: 完全自動
|
||||
- With installation + recommended profile: Claude automatically uses it
|
||||
- Otherwise: Falls back to ReflexionMemory
|
||||
- PM Agent instructs: "Search past errors" (Claude selects tool)
|
||||
|
||||
Do NOT:
|
||||
- 明示的にmindbase操作しない
|
||||
- PM Agentでmindbase制御しない
|
||||
- 手動でメモリ管理しない
|
||||
|
||||
Reason: Claude Code標準機能として完全に自動管理される
|
||||
Note: Optional enhancement. SuperClaude works fully with ReflexionMemory alone.
|
||||
```
|
||||
|
||||
#### Serena MCP
|
||||
|
||||
Reference in New Issue
Block a user