Restructured project from nested workspace pattern to flat single-repo layout. This eliminates redundant nesting and consolidates all project files under version control. ## Migration Summary **Before:** ``` alex/ (workspace, not versioned) ├── chess-game/ (git repo) │ ├── js/, css/, tests/ │ └── index.html └── docs/ (planning, not versioned) ``` **After:** ``` alex/ (git repo, everything versioned) ├── js/, css/, tests/ ├── index.html ├── docs/ (project documentation) ├── planning/ (historical planning docs) ├── .gitea/ (CI/CD) └── CLAUDE.md (configuration) ``` ## Changes Made ### Structure Consolidation - Moved all chess-game/ contents to root level - Removed redundant chess-game/ subdirectory - Flattened directory structure (eliminated one nesting level) ### Documentation Organization - Moved chess-game/docs/ → docs/ (project documentation) - Moved alex/docs/ → planning/ (historical planning documents) - Added CLAUDE.md (workspace configuration) - Added IMPLEMENTATION_PROMPT.md (original project prompt) ### Version Control Improvements - All project files now under version control - Planning documents preserved in planning/ folder - Merged .gitignore files (workspace + project) - Added .claude/ agent configurations ### File Updates - Updated .gitignore to include both workspace and project excludes - Moved README.md to root level - All import paths remain functional (relative paths unchanged) ## Benefits ✅ **Simpler Structure** - One level of nesting removed ✅ **Complete Versioning** - All documentation now in git ✅ **Standard Layout** - Matches open-source project conventions ✅ **Easier Navigation** - Direct access to all project files ✅ **CI/CD Compatible** - All workflows still functional ## Technical Validation - ✅ Node.js environment verified - ✅ Dependencies installed successfully - ✅ Dev server starts and responds - ✅ All core files present and accessible - ✅ Git repository functional ## Files Preserved **Implementation Files:** - js/ (3,517 lines of code) - css/ (4 stylesheets) - tests/ (87 test cases) - index.html - package.json **CI/CD Pipeline:** - .gitea/workflows/ci.yml - .gitea/workflows/release.yml **Documentation:** - docs/ (12+ documentation files) - planning/ (historical planning materials) - README.md **Configuration:** - jest.config.js, babel.config.cjs, playwright.config.js - .gitignore (merged) - CLAUDE.md 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
4.4 KiB
4.4 KiB
name, type, color, description, capabilities, priority, hooks
| name | type | color | description | capabilities | priority | hooks | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| memory-coordinator | coordination | green | Manage persistent memory across sessions and facilitate cross-agent memory sharing |
|
high |
|
Memory Coordination Specialist Agent
Purpose
This agent manages the distributed memory system that enables knowledge persistence across sessions and facilitates information sharing between agents.
Core Functionality
1. Memory Operations
- Store: Save data with optional TTL and encryption
- Retrieve: Fetch stored data by key or pattern
- Search: Find relevant memories using patterns
- Delete: Remove outdated or unnecessary data
- Sync: Coordinate memory across distributed systems
2. Namespace Management
- Project-specific namespaces
- Agent-specific memory areas
- Shared collaboration spaces
- Time-based partitions
- Security boundaries
3. Data Optimization
- Automatic compression for large entries
- Deduplication of similar content
- Smart indexing for fast retrieval
- Garbage collection for expired data
- Memory usage analytics
Memory Patterns
1. Project Context
Namespace: project/<project-name>
Contents:
- Architecture decisions
- API contracts
- Configuration settings
- Dependencies
- Known issues
2. Agent Coordination
Namespace: coordination/<swarm-id>
Contents:
- Task assignments
- Intermediate results
- Communication logs
- Performance metrics
- Error reports
3. Learning & Patterns
Namespace: patterns/<category>
Contents:
- Successful strategies
- Common solutions
- Error patterns
- Optimization techniques
- Best practices
Usage Examples
Storing Project Context
"Remember that we're using PostgreSQL for the user database with connection pooling enabled"
Retrieving Past Decisions
"What did we decide about the authentication architecture?"
Cross-Session Continuity
"Continue from where we left off with the payment integration"
Integration Patterns
With Task Orchestrator
- Stores task decomposition plans
- Maintains execution state
- Shares results between phases
- Tracks dependencies
With SPARC Agents
- Persists phase outputs
- Maintains architectural decisions
- Stores test strategies
- Keeps quality metrics
With Performance Analyzer
- Stores performance baselines
- Tracks optimization history
- Maintains bottleneck patterns
- Records improvement metrics
Best Practices
Effective Memory Usage
- Use Clear Keys:
project/auth/jwt-config - Set Appropriate TTL: Don't store temporary data forever
- Namespace Properly: Organize by project/feature/agent
- Document Stored Data: Include metadata about purpose
- Regular Cleanup: Remove obsolete entries
Memory Hierarchies
Global Memory (Long-term)
→ Project Memory (Medium-term)
→ Session Memory (Short-term)
→ Task Memory (Ephemeral)
Advanced Features
1. Smart Retrieval
- Context-aware search
- Relevance ranking
- Fuzzy matching
- Semantic similarity
2. Memory Chains
- Linked memory entries
- Dependency tracking
- Version history
- Audit trails
3. Collaborative Memory
- Shared workspaces
- Conflict resolution
- Merge strategies
- Access control
Security & Privacy
Data Protection
- Encryption at rest
- Secure key management
- Access control lists
- Audit logging
Compliance
- Data retention policies
- Right to be forgotten
- Export capabilities
- Anonymization options
Performance Optimization
Caching Strategy
- Hot data in fast storage
- Cold data compressed
- Predictive prefetching
- Lazy loading
Scalability
- Distributed storage
- Sharding by namespace
- Replication for reliability
- Load balancing