myaidev-method 0.2.4 → 0.2.6

package/src/templates/codex/commands/myai-astro-publish.md

@@ -0,0 +1,51 @@
+# Astro Content Publisher
+
+Publish markdown content to Astro static site with content collections support and git workflow: $ARGUMENTS
+
+Invoke the Astro publishing agent to transform frontmatter, validate schemas, and deploy via git.
+
+## Usage Examples
+
+```bash
+/myai-astro-publish "article.md"
+/myai-astro-publish "post.md" --collection blog
+/myai-astro-publish "page.md" --pages
+```
+
+## Options
+
+- `--collection <name>` - Target content collection (default: blog)
+- `--pages` - Publish to pages directory instead
+- `--project <path>` - Astro project path
+- `--branch <name>` - Git branch (default: main)
+- `--no-push` - Commit but don't push
+- `--dry-run` - Validate without publishing
+
+## Prerequisites
+
+Astro project with astro.config.mjs and git repository.
+
+## Examples
+
+### Publish to content collection
+```
+/myai-astro-publish "my-article.md" --collection blog
+```
+
+### Publish to pages
+```
+/myai-astro-publish "about.md" --pages
+```
+
+### Custom project
+```
+/myai-astro-publish "post.md" --project ~/my-site --branch staging
+```
+
+## Frontmatter Transformation
+
+Automatically converts:
+- `date` → `pubDate` (ISO 8601 format)
+- `status: published` → `draft: false`
+- `excerpt` → `description`
+- `image` → `heroImage`

package/src/templates/codex/commands/myai-configure.md

@@ -0,0 +1,185 @@
+# MyAI Method Configuration
+
+Configure MyAI Method settings: $ARGUMENTS
+
+Configure MyAI Method settings including WordPress credentials, content defaults, and agent management.
+
+## Available Configurations
+
+### wordpress
+Interactive WordPress setup - no manual .env file creation needed!
+
+**Process:**
+1. **Collect WordPress site URL**
+   - Prompt: "Enter your WordPress site URL (e.g., https://yoursite.com):"
+   - Validate URL format and accessibility
+   - Test basic connectivity
+
+2. **Get WordPress username**
+   - Prompt: "Enter your WordPress admin username:"
+   - Validate username format
+
+3. **Guide through Application Password creation**
+   - Show step-by-step instructions:
+     * "Go to your WordPress Admin → Users → Your Profile"
+     * "Scroll down to 'Application Passwords' section"
+     * "Enter a name like 'MyAI Dev Method' and click 'Add New'"
+     * "Copy the generated password (it looks like: xxxx xxxx xxxx xxxx)"
+   - Prompt: "Paste your Application Password here:"
+   - Validate password format
+
+4. **Test connection**
+   - Verify credentials by making test API call
+   - Show success/failure message with troubleshooting tips
+
+5. **Save configuration**
+   - Create/update `.env` file automatically
+   - Set proper file permissions (600)
+   - Show confirmation of saved settings
+
+6. **Optional SSH setup**
+   - Ask: "Do you want to set up SSH for advanced WordPress administration? (y/n)"
+   - If yes, prompt for SSH details:
+     * SSH host/IP
+     * SSH username
+     * SSH key path (optional)
+   - Test SSH connection if credentials provided
+
+**Success message:**
+```
+✅ WordPress integration configured successfully!
+- Site: [URL]
+- User: [username]
+- Connection: ✅ Verified
+- Available commands: /myai-wordpress-admin, /myai-wordpress-publish
+```
+
+### defaults
+Configure default content settings:
+- Default word count
+- Default post status
+- Default tone
+- Default audience
+
+### agents
+List and manage available agents:
+- **List**: Show all installed agents with descriptions and capabilities
+- **Status**: Check agent configuration validity and tool availability
+- **Edit**: Open agent files for customization
+- **Backup**: Create backups before modifying agents
+- **Restore**: Restore agents from backups
+- **Validate**: Test agent YAML frontmatter and prompt structure
+- **Tools**: Show what tools each agent has access to
+
+## WordPress REST API Integration
+
+WordPress integration uses the native WordPress REST API with Application Passwords:
+
+1. **Authentication**: HTTP Basic Auth with Application Passwords
+2. **Content Creation**: Direct API calls using WebFetch and curl tools
+3. **Gutenberg Support**: Manual conversion to Gutenberg block format when needed
+4. **No MCP Required**: Uses native Claude Code tools for all operations
+
+## WordPress Setup Example
+
+```bash
+# User runs the command
+/myai-configure wordpress
+
+# System prompts and responses:
+? Enter your WordPress site URL: https://myblog.com
+✓ URL format valid, testing connection...
+✓ WordPress site accessible
+
+? Enter your WordPress admin username: john_admin
+✓ Username format valid
+
+# System shows instructions
+📝 Create Application Password:
+1. Go to https://myblog.com/wp-admin/profile.php
+2. Scroll to "Application Passwords"
+3. Enter name: "MyAI Dev Method"
+4. Click "Add New"
+5. Copy the generated password
+
+? Paste your Application Password: abcd efgh ijkl mnop
+✓ Password format valid, testing connection...
+✓ WordPress API connection successful!
+
+? Set up SSH for advanced features? (y/n): y
+? SSH host/IP: myblog.com
+? SSH username: john
+? SSH key path (press enter for default): /home/user/.ssh/id_rsa
+✓ SSH connection tested successfully
+
+✅ Configuration saved to .env
+✅ File permissions set to 600 (secure)
+
+WordPress integration ready! Available commands:
+• /myai-wordpress-admin health-check
+• /myai-wordpress-publish filename.md
+• /myai-content-writer "topic" --publish_to_wordpress true
+```
+
+## Agent Management Examples
+
+```bash
+# List all available agents
+/myai-configure agents --list
+
+# Show detailed agent status
+/myai-configure agents --status
+
+# Check specific agent configuration
+/myai-configure agents --validate content-writer
+
+# Create backup before editing
+/myai-configure agents --backup wordpress-admin
+
+# Edit agent (opens file in editor)
+/myai-configure agents --edit content-writer
+
+# Restore agent from backup
+/myai-configure agents --restore content-writer
+
+# Show agent tool permissions
+/myai-configure agents --tools wordpress-admin
+```
+
+## Agent Operations
+
+### List Operation
+Shows:
+- Agent name and description
+- File location
+- Available tools
+- Last modified date
+- Configuration status (valid/invalid)
+
+### Status Operation
+Checks:
+- YAML frontmatter validity
+- Required fields presence
+- Tool availability in Claude Code
+- File permissions
+- Syntax errors
+
+### Validate Operation
+Performs:
+- YAML syntax validation
+- Required field verification
+- Tool permission verification
+- Prompt structure analysis
+- Best practice recommendations
+
+### Backup/Restore Operations
+- Creates timestamped backups in `.claude/backups/`
+- Maintains backup history
+- Safe restoration with confirmation prompts
+- Backup before any modifications
+
+## Security
+
+- Never display passwords in plain text
+- Use environment variables for sensitive data
+- Validate URLs and credentials before saving

package/src/templates/codex/commands/myai-content-writer.md

@@ -0,0 +1,73 @@
+# Professional Content Writer
+
+Create comprehensive, well-researched content based on the provided topic: $ARGUMENTS
+
+You are a professional content writer specializing in creating high-quality, engaging, and SEO-optimized content.
+
+## Core Competencies
+
+1. **Writing Excellence**
+   - Clear, concise, and engaging prose
+   - Proper grammar, spelling, and punctuation
+   - Varied sentence structure and rhythm
+   - Active voice preference
+   - Storytelling when appropriate
+
+2. **SEO Optimization**
+   - Natural keyword integration
+   - Proper heading hierarchy (H1, H2, H3)
+   - Meta descriptions (150-160 characters)
+   - Internal and external linking suggestions
+   - URL-friendly slugs
+
+3. **Content Structure**
+   - Compelling introductions with hooks
+   - Logical flow and transitions
+   - Scannable formatting (bullets, lists, short paragraphs)
+   - Strong conclusions with CTAs when appropriate
+
+## Writing Process
+
+1. **Understanding**: Analyze the topic, audience, and goals from $ARGUMENTS
+2. **Research**: Use WebSearch to gather current, relevant information
+3. **Planning**: Create a detailed outline with logical structure
+4. **Writing**: Craft the content following SEO best practices
+5. **Optimization**: Review for clarity, accuracy, and SEO
+6. **Formatting**: Ensure proper Markdown formatting
+
+## Output Requirements
+
+Save the content as a markdown file with the following structure:
+
+```markdown
+---
+title: [Compelling, keyword-rich title]
+meta_description: [150-160 character summary]
+slug: [url-friendly-version]
+tags: [relevant, topic, tags]
+category: [Primary category]
+---
+
+# [Title]
+
+[Content with proper heading hierarchy]
+```
+
+## Parameters Supported
+
+- Topic (required): Main subject matter
+- Word count: Target length (default: 800)
+- Tone: professional, casual, technical, conversational, academic
+- Audience: Target reader demographic
+- SEO keywords: Primary and secondary keywords
+- Publish to WordPress: Auto-publish as draft (true/false)
+
+## WordPress Integration
+
+If publish_to_wordpress is requested:
+1. Save the content locally first
+2. Check for WordPress configuration in environment variables
+3. Use the WordPress MCP to create a draft post
+4. Report the draft URL to the user
+
+Always prioritize user value over keyword density. Write for humans first, search engines second.

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

@@ -0,0 +1,159 @@
+# Coolify Deployment Manager
+
+Execute Coolify deployment operations: $ARGUMENTS
+
+Launch the Coolify deployment specialist agent for application deployment and infrastructure management.
+
+## 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
+
+## 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.