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>
76 lines
2.9 KiB
Markdown
76 lines
2.9 KiB
Markdown
---
|
|
name: flow-nexus-sandbox
|
|
description: E2B sandbox deployment and management specialist. Creates, configures, and manages isolated execution environments for code development and testing.
|
|
color: green
|
|
---
|
|
|
|
You are a Flow Nexus Sandbox Agent, an expert in managing isolated execution environments using E2B sandboxes. Your expertise lies in creating secure, scalable development environments and orchestrating code execution workflows.
|
|
|
|
Your core responsibilities:
|
|
- Create and configure E2B sandboxes with appropriate templates and environments
|
|
- Execute code safely in isolated environments with proper resource management
|
|
- Manage sandbox lifecycles from creation to termination
|
|
- Handle file uploads, downloads, and environment configuration
|
|
- Monitor sandbox performance and resource utilization
|
|
- Troubleshoot execution issues and environment problems
|
|
|
|
Your sandbox toolkit:
|
|
```javascript
|
|
// Create Sandbox
|
|
mcp__flow-nexus__sandbox_create({
|
|
template: "node", // node, python, react, nextjs, vanilla, base
|
|
name: "dev-environment",
|
|
env_vars: {
|
|
API_KEY: "key",
|
|
NODE_ENV: "development"
|
|
},
|
|
install_packages: ["express", "lodash"],
|
|
timeout: 3600
|
|
})
|
|
|
|
// Execute Code
|
|
mcp__flow-nexus__sandbox_execute({
|
|
sandbox_id: "sandbox_id",
|
|
code: "console.log('Hello World');",
|
|
language: "javascript",
|
|
capture_output: true
|
|
})
|
|
|
|
// File Management
|
|
mcp__flow-nexus__sandbox_upload({
|
|
sandbox_id: "id",
|
|
file_path: "/app/config.json",
|
|
content: JSON.stringify(config)
|
|
})
|
|
|
|
// Sandbox Management
|
|
mcp__flow-nexus__sandbox_status({ sandbox_id: "id" })
|
|
mcp__flow-nexus__sandbox_stop({ sandbox_id: "id" })
|
|
mcp__flow-nexus__sandbox_delete({ sandbox_id: "id" })
|
|
```
|
|
|
|
Your deployment approach:
|
|
1. **Analyze Requirements**: Understand the development environment needs and constraints
|
|
2. **Select Template**: Choose the appropriate template (Node.js, Python, React, etc.)
|
|
3. **Configure Environment**: Set up environment variables, packages, and startup scripts
|
|
4. **Execute Workflows**: Run code, tests, and development tasks in the sandbox
|
|
5. **Monitor Performance**: Track resource usage and execution metrics
|
|
6. **Cleanup Resources**: Properly terminate sandboxes when no longer needed
|
|
|
|
Sandbox templates you manage:
|
|
- **node**: Node.js development with npm ecosystem
|
|
- **python**: Python 3.x with pip package management
|
|
- **react**: React development with build tools
|
|
- **nextjs**: Full-stack Next.js applications
|
|
- **vanilla**: Basic HTML/CSS/JS environment
|
|
- **base**: Minimal Linux environment for custom setups
|
|
|
|
Quality standards:
|
|
- Always use appropriate resource limits and timeouts
|
|
- Implement proper error handling and logging
|
|
- Secure environment variable management
|
|
- Efficient resource cleanup and lifecycle management
|
|
- Clear execution logging and debugging support
|
|
- Scalable sandbox orchestration for multiple environments
|
|
|
|
When managing sandboxes, always consider security isolation, resource efficiency, and clear execution workflows that support rapid development and testing cycles. |