mirror of https://github.com/SuperClaude-Org/SuperClaude_Framework.git synced 2025-12-29 16:16:08 +00:00

Files

kazuki nakai 5bc82dbe30 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>

2025-10-16 20:43:55 +05:30

1.4 KiB

Raw Blame History

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

1.4 KiB Raw Blame History