mirror of
https://github.com/SuperClaude-Org/SuperClaude_Framework.git
synced 2025-12-29 16:16:08 +00:00
refactor: PM Agent complete independence from Serena MCP (#438)
* refactor: PM Agent complete independence from external MCP servers Change PM Agent to be fully operational without any MCP server dependencies: Architecture Changes: - mcp-servers: [] (all MCPs are optional enhancements only) - Session memory: Local file-based (docs/memory/) - no Serena MCP required - Code structure analysis: Glob-based instead of Serena symbol overview Core vs Optional Tools: Core (No MCP): - Read, Write, Edit, MultiEdit - Grep, Glob, Bash - TodoWrite, WebSearch, WebFetch Optional Enhancement (if available): - sequential: Advanced reasoning - context7: Framework documentation - magic: UI component generation - morphllm: Bulk code transformations - playwright: Browser E2E testing - airis-mcp-gateway: Dynamic tool loading Design Philosophy: - External dependencies: None (100% operational without MCPs) - Optional enhancements: MCPs add advanced capabilities when available - Automatic fallback: Core tools used when MCPs unavailable - Complete independence: Basic functionality requires zero external dependencies Benefits: - Reliable: Always works regardless of MCP availability - Transparent: Local file-based memory (Git-manageable) - Scalable: Enhanced capabilities via optional MCP integration - Maintainable: No breaking changes from external MCP updates 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * refactor: PM Agent complete independence from Serena MCP Remove all Serena MCP dependencies from PM Agent implementation: - Replace memory operations with local file operations - Replace think_about_* functions with self-evaluation checklists - Implement repository-scoped memory in docs/memory/ Benefits: - No external MCP server dependency - Human-readable Markdown/JSON files - Git-manageable session state - Repository-scoped isolation Files changed: - superclaude/agents/pm-agent.md: Full Serena removal - superclaude/commands/pm.md: Remove remaining references - docs/memory/: New local memory structure 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> --------- Co-authored-by: kazuki <kazuki@kazukinoMacBook-Air.local> Co-authored-by: Claude <noreply@anthropic.com>
This commit is contained in:
38
docs/memory/last_session.md
Normal file
38
docs/memory/last_session.md
Normal file
@@ -0,0 +1,38 @@
|
||||
# Last Session Summary
|
||||
|
||||
**Date**: 2025-10-16
|
||||
**Duration**: ~30 minutes
|
||||
**Goal**: Remove Serena MCP dependency from PM Agent
|
||||
|
||||
## What Was Accomplished
|
||||
|
||||
✅ **Completed Serena MCP Removal**:
|
||||
- `superclaude/agents/pm-agent.md`: Replaced all Serena MCP operations with local file operations
|
||||
- `superclaude/commands/pm.md`: Removed remaining `think_about_*` function references
|
||||
- Memory operations now use `Read`, `Write`, `Bash` tools with `docs/memory/` files
|
||||
|
||||
✅ **Replaced Memory Operations**:
|
||||
- `list_memories()` → `Bash "ls docs/memory/"`
|
||||
- `read_memory("key")` → `Read docs/memory/key.md` or `.json`
|
||||
- `write_memory("key", value)` → `Write docs/memory/key.md` or `.json`
|
||||
|
||||
✅ **Replaced Self-Evaluation Functions**:
|
||||
- `think_about_task_adherence()` → Self-evaluation checklist (markdown)
|
||||
- `think_about_whether_you_are_done()` → Completion checklist (markdown)
|
||||
|
||||
## Issues Encountered
|
||||
|
||||
None. Implementation was straightforward.
|
||||
|
||||
## What Was Learned
|
||||
|
||||
- **Local file-based memory is simpler**: No external MCP server dependency
|
||||
- **Repository-scoped isolation**: Memory naturally scoped to git repository
|
||||
- **Human-readable format**: Markdown and JSON files visible in version control
|
||||
- **Checklists > Functions**: Explicit checklists are clearer than function calls
|
||||
|
||||
## Quality Metrics
|
||||
|
||||
- **Files Modified**: 2 (pm-agent.md, pm.md)
|
||||
- **Serena References Removed**: ~20 occurrences
|
||||
- **Test Status**: Ready for testing in next session
|
||||
28
docs/memory/next_actions.md
Normal file
28
docs/memory/next_actions.md
Normal file
@@ -0,0 +1,28 @@
|
||||
# Next Actions
|
||||
|
||||
## Immediate Tasks
|
||||
|
||||
1. **Test PM Agent without Serena**:
|
||||
- Start new session
|
||||
- Verify PM Agent auto-activation
|
||||
- Check memory restoration from `docs/memory/` files
|
||||
- Validate self-evaluation checklists work
|
||||
|
||||
2. **Document the Change**:
|
||||
- Create `docs/patterns/local-file-memory-pattern.md`
|
||||
- Update main README if necessary
|
||||
- Add to changelog
|
||||
|
||||
## Future Enhancements
|
||||
|
||||
3. **Optimize Memory File Structure**:
|
||||
- Consider `.jsonl` format for append-only logs
|
||||
- Add timestamp rotation for checkpoints
|
||||
|
||||
4. **Continue airis-mcp-gateway Optimization**:
|
||||
- Implement lazy loading for tool descriptions
|
||||
- Reduce initial token load from 47 tools
|
||||
|
||||
## Blockers
|
||||
|
||||
None currently.
|
||||
1
docs/memory/patterns_learned.jsonl
Normal file
1
docs/memory/patterns_learned.jsonl
Normal file
@@ -0,0 +1 @@
|
||||
{"pattern":"local-file-memory","description":"PM Agent uses local files in docs/memory/ instead of Serena MCP","date":"2025-10-16"}
|
||||
36
docs/memory/pm_context.md
Normal file
36
docs/memory/pm_context.md
Normal file
@@ -0,0 +1,36 @@
|
||||
# PM Agent Context
|
||||
|
||||
**Project**: SuperClaude_Framework
|
||||
**Type**: AI Agent Framework
|
||||
**Tech Stack**: Claude Code, MCP Servers, Markdown-based configuration
|
||||
**Current Focus**: Removing Serena MCP dependency from PM Agent
|
||||
|
||||
## Project Overview
|
||||
|
||||
SuperClaude is a comprehensive framework for Claude Code that provides:
|
||||
- Persona-based specialized agents (frontend, backend, security, etc.)
|
||||
- MCP server integrations (Context7, Magic, Morphllm, Sequential, etc.)
|
||||
- Slash command system for workflow automation
|
||||
- Self-improvement workflow with PDCA cycle
|
||||
|
||||
## Architecture
|
||||
|
||||
- `superclaude/agents/` - Agent persona definitions
|
||||
- `superclaude/commands/` - Slash command definitions
|
||||
- `docs/` - Documentation and patterns
|
||||
- `docs/memory/` - PM Agent session state (local files)
|
||||
- `docs/pdca/` - PDCA cycle documentation per feature
|
||||
|
||||
## Active Patterns
|
||||
|
||||
- **Repository-Scoped Memory**: Local file-based memory in `docs/memory/`
|
||||
- **PDCA Cycle**: Plan → Do → Check → Act documentation workflow
|
||||
- **Self-Evaluation Checklists**: Replace Serena MCP `think_about_*` functions
|
||||
|
||||
## Known Issues
|
||||
|
||||
None currently.
|
||||
|
||||
## Last Updated
|
||||
|
||||
2025-10-16
|
||||
Reference in New Issue
Block a user