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:
kazuki nakai
2025-10-17 00:13:55 +09:00
committed by GitHub
parent 7ee739646e
commit 5bc82dbe30
6 changed files with 243 additions and 88 deletions

View 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

View 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.

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