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:
Cedric Hurst
2025-10-30 22:14:35 -05:00
committed by GitHub
parent c733413d3c
commit bea4bfe289
11 changed files with 680 additions and 82 deletions

View File

@@ -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