myaidev-method 0.0.8 → 0.1.0

package/src/templates/claude/commands/myai-coolify-deploy.md

@@ -0,0 +1,172 @@
+---
+name: myai-coolify-deploy
+description: Deploy applications to Coolify - infrastructure management and deployment automation
+tools: Read, Write, Edit, Bash, Task, Grep, Glob
+---
+
+Launch the Coolify deployment specialist agent for application deployment and infrastructure management.
+
+## Task
+Execute Coolify deployment operations based on the specified action: $ARGUMENTS
+
+## Available Operations
+
+### Quick Deploy Commands
+- `deploy <app-name>` - Deploy application by name or from current directory
+- `status` - Check Coolify system status and connectivity
+- `list <resource-type>` - List servers, projects, applications, databases
+- `logs <app-name>` - View application deployment logs
+- `restart <app-name>` - Restart an application
+- `env <app-name>` - Manage environment variables
+
+### Detailed Deploy Commands
+- `deploy --repo <url> --name <name> --server <uuid>` - Deploy with specific configuration
+- `deploy --dockerfile --port 8080 --domain app.example.com` - Deploy Docker app
+- `deploy-database --type postgresql --name mydb` - Deploy database
+- `deploy-stack --config stack.json` - Deploy multi-component stack
+
+## Usage Examples
+
+### Quick Deployments
+```
+/myai-coolify-deploy status
+/myai-coolify-deploy list servers
+/myai-coolify-deploy deploy my-nextjs-app
+/myai-coolify-deploy logs my-app
+```
+
+### Advanced Deployments
+```
+/myai-coolify-deploy deploy --repo https://github.com/user/app --name api-server
+/myai-coolify-deploy deploy --dockerfile --port 3000 --domain api.example.com
+/myai-coolify-deploy deploy-database --type postgresql --version 16
+```
+
+### Environment Management
+```
+/myai-coolify-deploy env my-app --set API_KEY=secret123
+/myai-coolify-deploy env my-app --file .env.production
+```
+
+### Monitoring & Management
+```
+/myai-coolify-deploy list applications --detailed
+/myai-coolify-deploy restart my-app
+/myai-coolify-deploy logs my-app --follow
+```
+
+## Process Flow
+
+1. **Parse Arguments**
+   - Extract operation type from $ARGUMENTS
+   - Identify deployment target and configuration
+   - Validate required parameters
+
+2. **Verify Connectivity**
+   - Check Coolify API accessibility
+   - Validate credentials from `.env`
+   - Confirm target server availability
+
+3. **Execute Operation**
+   - Load coolify-deploy agent
+   - Run appropriate deployment script
+   - Monitor progress and handle errors
+
+4. **Report Results**
+   - Provide deployment URL and status
+   - Show relevant logs if deployment fails
+   - Suggest next steps or troubleshooting
+
+## Agent Integration
+
+This command loads the `coolify-deploy` agent which is optimized for:
+- **Lightweight operations** - Direct script execution for speed
+- **Extended thinking** - Complex deployment planning with "think" triggers
+- **Subagent delegation** - Parallel deployments for multi-component apps
+- **Security** - Permission-scoped operations with credential safety
+
+## Required Environment Variables
+
+```bash
+COOLIFY_URL=https://coolify.myai1.ai
+COOLIFY_API_KEY=your_api_key_here
+```
+
+Create API token in Coolify: Settings → Keys & Tokens → Create API Token
+
+## Examples with Context
+
+### Example 1: Deploy Current Directory
+```bash
+# User has Next.js app in current directory
+/myai-coolify-deploy deploy .
+
+# Agent workflow:
+# 1. Detects Next.js app (reads package.json)
+# 2. Lists available servers
+# 3. Prompts for server selection
+# 4. Deploys with Nixpacks
+# 5. Provides deployment URL
+```
+
+### Example 2: Deploy with GitHub Repo
+```bash
+/myai-coolify-deploy deploy --repo https://github.com/user/api --name api-prod
+
+# Agent workflow:
+# 1. Validates repository accessibility
+# 2. Selects optimal server
+# 3. Creates Coolify application
+# 4. Triggers deployment
+# 5. Monitors until complete
+```
+
+### Example 3: Deploy Full Stack
+```bash
+/myai-coolify-deploy deploy-stack
+
+# Agent workflow:
+# 1. Reads stack configuration (stack.json or prompts)
+# 2. Uses Task tool to parallelize:
+#    - Deploy PostgreSQL database
+#    - Deploy Redis cache
+#    - Deploy API backend
+#    - Deploy frontend
+# 3. Configures connections between components
+# 4. Runs health checks
+# 5. Reports complete stack status
+```
+
+## Safety Features
+
+- **Confirmation gates** - Prompts for production deployments
+- **Rollback support** - Can revert failed deployments
+- **Credential safety** - API keys never logged or exposed
+- **Resource validation** - Verifies server capacity before deployment
+- **Error recovery** - Auto-retry with exponential backoff
+
+## Output Format
+
+The agent provides structured output:
+- **Status updates**: Real-time deployment progress
+- **Success confirmation**: Deployment URL and access info
+- **Error details**: Clear error messages with troubleshooting steps
+- **Next actions**: Suggested follow-up commands
+
+## Integration with Other Agents
+
+Works seamlessly with:
+- **content-writer** - Deploy WordPress for published content
+- **wordpress-admin** - Manage deployed WordPress instances
+- Custom agents for CI/CD pipeline integration
+
+## Performance Notes
+
+- Typical deployment: 2-5 minutes (depends on build complexity)
+- Script execution: <1 second for status/list operations
+- Agent initialization: <3k tokens (lightweight pattern)
+- Extended thinking available for complex decisions
+
+---
+
+Always run `/myai-coolify-deploy status` first to verify connectivity before deployment operations.