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:
@@ -280,7 +280,7 @@ Improved (Good):
|
||||
- Light tasks: 3,500 → 1,200 tokens (66% reduction)
|
||||
- Medium tasks: 7,000 → 4,500 tokens (36% reduction)
|
||||
|
||||
### 6.2 Phase 2: mindbase Integration
|
||||
### 6.2 Phase 2: Enhanced Error Learning (ReflexionMemory + Optional mindbase)
|
||||
|
||||
**Features**:
|
||||
- Semantic search for past solutions
|
||||
|
||||
@@ -72,9 +72,9 @@ PM Agent Application:
|
||||
📝 Learning: Add env validation to startup checklist"
|
||||
|
||||
Storage:
|
||||
→ docs/memory/solutions_learned.jsonl
|
||||
→ docs/memory/reflexion.jsonl (ReflexionMemory - always available)
|
||||
→ docs/mistakes/[feature]-YYYY-MM-DD.md
|
||||
→ mindbase (if available)
|
||||
→ mindbase (if airis-mcp-gateway installed, automatic)
|
||||
```
|
||||
|
||||
### 3. Memory Integration (記憶統合)
|
||||
@@ -83,23 +83,19 @@ Storage:
|
||||
|
||||
```yaml
|
||||
Error Occurred:
|
||||
1. Check Past Errors (Smart Lookup):
|
||||
IF mindbase available:
|
||||
→ mindbase.search_conversations(
|
||||
query=error_message,
|
||||
category="error",
|
||||
limit=5
|
||||
)
|
||||
→ Semantic search for similar past errors
|
||||
|
||||
ELSE (mindbase unavailable):
|
||||
→ Grep docs/memory/solutions_learned.jsonl
|
||||
→ Grep docs/mistakes/ -r "error_message"
|
||||
→ Text-based pattern matching
|
||||
1. Check Past Errors (Automatic Tool Selection):
|
||||
→ Search conversation history for similar errors
|
||||
→ Claude selects best available tool:
|
||||
* mindbase_search (if airis-mcp-gateway installed)
|
||||
- Semantic search across all conversations
|
||||
- Cross-project pattern recognition
|
||||
* ReflexionMemory (built-in, always available)
|
||||
- Keyword search in reflexion.jsonl
|
||||
- Fast project-scoped matching
|
||||
|
||||
2. IF similar error found:
|
||||
✅ "⚠️ 過去に同じエラー発生済み"
|
||||
✅ "解決策: [past_solution]"
|
||||
✅ "⚠️ Same error occurred before"
|
||||
✅ "Solution: [past_solution]"
|
||||
✅ Apply known solution immediately
|
||||
→ Skip lengthy investigation
|
||||
|
||||
|
||||
Reference in New Issue
Block a user