kazuki
|
e799c35efd
|
refactor: migrate to clean architecture with src/ layout
## Migration Summary
- Moved from flat `superclaude/` to `src/superclaude/` (PEP 517/518)
- Deleted old structure (119 files removed)
- Added new structure with clean architecture layers
## Project Structure Changes
- OLD: `superclaude/{agents,commands,modes,framework}/`
- NEW: `src/superclaude/{cli,execution,pm_agent}/`
## Build System Updates
- Switched: setuptools → hatchling (modern, PEP 517)
- Updated: pyproject.toml with proper entry points
- Added: pytest plugin auto-discovery
- Version: 4.1.6 → 0.4.0 (clean slate)
## Makefile Enhancements
- Removed: `superclaude install` calls (deprecated)
- Added: `make verify` - Phase 1 installation verification
- Added: `make test-plugin` - pytest plugin loading test
- Added: `make doctor` - health check command
## Documentation Added
- docs/architecture/ - 7 architecture docs
- docs/research/python_src_layout_research_20251021.md
- docs/PR_STRATEGY.md
## Migration Phases
- Phase 1: Core installation ✅ (this commit)
- Phase 2: Lazy loading + Skills system (next)
- Phase 3: PM Agent meta-layer (future)
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
|
2025-10-21 09:13:42 +09:00 |
|
kazuki
|
76ac7f231b
|
docs: add PM Agent architecture and MCP integration documentation
## PM Agent Architecture Redesign
### Auto-Activation System
- **pm-agent-auto-activation.md**: Behavior-based auto-activation architecture
- 5 activation layers (Session Start, Documentation Guardian, Commander, Post-Implementation, Mistake Handler)
- Remove manual `/sc:pm` command requirement
- Auto-trigger based on context detection
### Responsibility Cleanup
- **pm-agent-responsibility-cleanup.md**: Memory management strategy and MCP role clarification
- Delete `docs/memory/` directory (redundant with Mindbase)
- Remove `write_memory()` / `read_memory()` usage (Serena is code-only)
- Clear lifecycle rules for each memory layer
## MCP Integration Policy
### Core Definitions
- **mcp-integration-policy.md**: Complete MCP server definitions and usage guidelines
- Mindbase: Automatic conversation history (don't touch)
- Serena: Code understanding only (not task management)
- Sequential: Complex reasoning engine
- Context7: Official documentation reference
- Tavily: Web search and research
- Clear auto-trigger conditions for each MCP
- Anti-patterns and best practices
### Optional Design
- **mcp-optional-design.md**: MCP-optional architecture with graceful fallbacks
- SuperClaude works fully without any MCPs
- MCPs are performance enhancements (2-3x faster, 30-50% fewer tokens)
- Automatic fallback to native tools
- User choice: Minimal → Standard → Enhanced setup
## Key Benefits
**Simplicity**:
- Remove `docs/memory/` complexity
- Clear MCP role separation
- Auto-activation (no manual commands)
**Reliability**:
- Works without MCPs (graceful degradation)
- Clear fallback strategies
- No single point of failure
**Performance** (with MCPs):
- 2-3x faster execution
- 30-50% token reduction
- Better code understanding (Serena)
- Efficient reasoning (Sequential)
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
|
2025-10-19 22:37:51 +09:00 |
|