5ad0700b41
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>
73 lines
1.5 KiB
Markdown
73 lines
1.5 KiB
Markdown
# Smart Agent Auto-Spawning
|
|
|
|
## Purpose
|
|
Automatically spawn the right agents at the right time without manual intervention.
|
|
|
|
## Auto-Spawning Triggers
|
|
|
|
### 1. File Type Detection
|
|
When editing files, agents auto-spawn:
|
|
- **JavaScript/TypeScript**: Coder agent
|
|
- **Markdown**: Researcher agent
|
|
- **JSON/YAML**: Analyst agent
|
|
- **Multiple files**: Coordinator agent
|
|
|
|
### 2. Task Complexity
|
|
```
|
|
Simple task: "Fix typo"
|
|
→ Single coordinator agent
|
|
|
|
Complex task: "Implement OAuth with Google"
|
|
→ Architect + Coder + Tester + Researcher
|
|
```
|
|
|
|
### 3. Dynamic Scaling
|
|
The system monitors workload and spawns additional agents when:
|
|
- Task queue grows
|
|
- Complexity increases
|
|
- Parallel opportunities exist
|
|
|
|
**Status Monitoring:**
|
|
```javascript
|
|
// Check swarm health
|
|
mcp__claude-flow__swarm_status({
|
|
"swarmId": "current"
|
|
})
|
|
|
|
// Monitor agent performance
|
|
mcp__claude-flow__agent_metrics({
|
|
"agentId": "agent-123"
|
|
})
|
|
```
|
|
|
|
## Configuration
|
|
|
|
### MCP Tool Integration
|
|
Uses Claude Flow MCP tools for agent coordination:
|
|
```javascript
|
|
// Initialize swarm with appropriate topology
|
|
mcp__claude-flow__swarm_init({
|
|
"topology": "mesh",
|
|
"maxAgents": 8,
|
|
"strategy": "auto"
|
|
})
|
|
|
|
// Spawn agents based on file type
|
|
mcp__claude-flow__agent_spawn({
|
|
"type": "coder",
|
|
"name": "JavaScript Handler",
|
|
"capabilities": ["javascript", "typescript"]
|
|
})
|
|
```
|
|
|
|
### Fallback Configuration
|
|
If MCP tools are unavailable:
|
|
```bash
|
|
npx claude-flow hook pre-task --auto-spawn-agents
|
|
```
|
|
|
|
## Benefits
|
|
- 🤖 Zero manual agent management
|
|
- 🎯 Perfect agent selection
|
|
- 📈 Dynamic scaling
|
|
- 💾 Resource efficiency |