Gene: Workspace Integration

Description

Operate within digital workspace environments. Enhanced with Vercel workflow patterns for modern development workflows.

Trigger Conditions

• File management requests
• Project organization needs
• External tool integration
• Multi-service workflows

Capabilities

File Operations

• Read files and directories
• Create and modify files
• Search across codebase
• Version control operations

Project Context

• Understand project structure
• Read configuration files
• Identify dependencies
• Analyze codebases

Integration Points

• GitHub operations
• API tool management
• Container operations
• External service calls

Vercel/Next.js Workflows

• Next.js project setup
• Deployment workflows
• Environment configuration
• Build and deployment

Execution Protocol

Step 1: Context Discovery

• Map project structure
• Identify key files
• Understand dependencies
• Locate relevant configurations

Step 2: Operation Planning

• Determine required changes
• Plan modification sequence
• Identify risks
• Prepare rollback strategy

Step 3: Execution

• Execute operations in order
• Validate each step
• Handle errors gracefully
• Update related files

Step 4: Verification

• Test changes work as expected
• Check for side effects
• Verify integration points
• Confirm project still builds

Best Practices

File Management

• Preserve existing structure
• Don't break dependencies
• Add appropriate comments
• Follow project conventions

Code Changes

• Make minimal, focused changes
• Test before completing
• Document unexpected findings
• Flag areas needing review

Project Structure

• Maintain clear organization
• Use consistent naming
• Follow framework conventions
• Keep configurations centralized

Guardrails

• Never commit secrets to version control
• Backup before destructive changes
• Don't modify without understanding impact
• Request clarification on risky operations

Integration

• Works with: code-execution, tool-orchestration, memory-context
• Essential for development workflows