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>
106 lines
2.1 KiB
Markdown
106 lines
2.1 KiB
Markdown
# Self-Healing Workflows
|
|
|
|
## Purpose
|
|
Automatically detect and recover from errors without interrupting your flow.
|
|
|
|
## Self-Healing Features
|
|
|
|
### 1. Error Detection
|
|
Monitors for:
|
|
- Failed commands
|
|
- Syntax errors
|
|
- Missing dependencies
|
|
- Broken tests
|
|
|
|
### 2. Automatic Recovery
|
|
|
|
**Missing Dependencies:**
|
|
```
|
|
Error: Cannot find module 'express'
|
|
→ Automatically runs: npm install express
|
|
→ Retries original command
|
|
```
|
|
|
|
**Syntax Errors:**
|
|
```
|
|
Error: Unexpected token
|
|
→ Analyzes error location
|
|
→ Suggests fix through analyzer agent
|
|
→ Applies fix with confirmation
|
|
```
|
|
|
|
**Test Failures:**
|
|
```
|
|
Test failed: "user authentication"
|
|
→ Spawns debugger agent
|
|
→ Analyzes failure cause
|
|
→ Implements fix
|
|
→ Re-runs tests
|
|
```
|
|
|
|
### 3. Learning from Failures
|
|
Each recovery improves future prevention:
|
|
- Patterns saved to knowledge base
|
|
- Similar errors prevented proactively
|
|
- Recovery strategies optimized
|
|
|
|
**Pattern Storage:**
|
|
```javascript
|
|
// Store error patterns
|
|
mcp__claude-flow__memory_usage({
|
|
"action": "store",
|
|
"key": "error-pattern-" + Date.now(),
|
|
"value": JSON.stringify(errorData),
|
|
"namespace": "error-patterns",
|
|
"ttl": 2592000 // 30 days
|
|
})
|
|
|
|
// Analyze patterns
|
|
mcp__claude-flow__neural_patterns({
|
|
"action": "analyze",
|
|
"operation": "error-recovery",
|
|
"outcome": "success"
|
|
})
|
|
```
|
|
|
|
## Self-Healing Integration
|
|
|
|
### MCP Tool Coordination
|
|
```javascript
|
|
// Initialize self-healing swarm
|
|
mcp__claude-flow__swarm_init({
|
|
"topology": "star",
|
|
"maxAgents": 4,
|
|
"strategy": "adaptive"
|
|
})
|
|
|
|
// Spawn recovery agents
|
|
mcp__claude-flow__agent_spawn({
|
|
"type": "monitor",
|
|
"name": "Error Monitor",
|
|
"capabilities": ["error-detection", "recovery"]
|
|
})
|
|
|
|
// Orchestrate recovery
|
|
mcp__claude-flow__task_orchestrate({
|
|
"task": "recover from error",
|
|
"strategy": "sequential",
|
|
"priority": "critical"
|
|
})
|
|
```
|
|
|
|
### Fallback Hook Configuration
|
|
```json
|
|
{
|
|
"PostToolUse": [{
|
|
"matcher": "^Bash$",
|
|
"command": "npx claude-flow hook post-bash --exit-code '${tool.result.exitCode}' --auto-recover"
|
|
}]
|
|
}
|
|
```
|
|
|
|
## Benefits
|
|
- 🛡️ Resilient workflows
|
|
- 🔄 Automatic recovery
|
|
- 📚 Learns from errors
|
|
- ⏱️ Saves debugging time |