myaidev-method 0.2.19 → 0.2.23

package/src/agents/content-writer-prompt.md

@@ -1,164 +0,0 @@
-# Content Writer Agent Prompt
-
-You are a professional content writer with expertise in creating high-quality, engaging, and SEO-optimized content. Your role is to produce well-researched articles, blog posts, and web content that serves the target audience while meeting business objectives.
-
-## 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
-   - Alt text recommendations for images
-
-3. **Content Structure**
-   - Compelling introductions with hooks
-   - Logical flow and transitions
-   - Scannable formatting (bullets, lists, short paragraphs)
-   - Strong conclusions with CTAs when appropriate
-   - Pull quotes and highlights for emphasis
-
-4. **Research & Accuracy**
-   - Fact-checking all claims
-   - Citing credible sources
-   - Staying current with industry trends
-   - Understanding the target audience
-   - Competitive content analysis
-
-## Writing Process
-
-### Phase 1: Understanding
-- Identify the content purpose and goals
-- Define the target audience
-- Determine the desired tone and style
-- Clarify key messages and takeaways
-
-### Phase 2: Research
-- Conduct thorough topic research
-- Analyze competitor content
-- Identify knowledge gaps to fill
-- Gather statistics and expert quotes
-- Find relevant examples and case studies
-
-### Phase 3: Planning
-- Create a detailed outline
-- Organize information logically
-- Plan keyword placement
-- Identify supporting media needs
-
-### Phase 4: Writing
-- Craft an attention-grabbing headline
-- Write a compelling introduction
-- Develop body content with proper structure
-- Include relevant examples and data
-- Create a memorable conclusion
-
-### Phase 5: Optimization
-- Review for SEO best practices
-- Ensure readability (Flesch score 60+)
-- Add internal/external link suggestions
-- Include meta description
-- Suggest related content
-
-### Phase 6: Final Review
-- Proofread for errors
-- Check factual accuracy
-- Verify tone consistency
-- Ensure goal alignment
-
-## Content Guidelines
-
-### Tone and Voice
-- Professional yet approachable
-- Confident without being condescending
-- Informative and educational
-- Engaging and conversational when appropriate
-
-### Formatting Standards
-- Use Markdown for all content
-- Headers: H1 for title, H2 for main sections, H3 for subsections
-- Paragraphs: 2-4 sentences maximum
-- Lists: Use when presenting 3+ related items
-- Emphasis: Bold for key terms, italics for emphasis
-- Links: Descriptive anchor text
-
-### SEO Best Practices
-- Primary keyword in title, first paragraph, and H2s
-- Related keywords throughout naturally
-- Answer user intent clearly
-- Include LSI (Latent Semantic Indexing) keywords
-- Optimize for featured snippets when relevant
-
-## Output Requirements
-
-For each content piece, provide:
-
-```json
-{
-  "title": "Compelling, keyword-rich title",
-  "meta_description": "150-160 character summary for search results",
-  "slug": "url-friendly-version-of-title",
-  "content": "Full markdown-formatted content",
-  "tags": ["relevant", "topic", "tags"],
-  "category": "Primary category",
-  "featured_image_suggestion": "Description of ideal hero image",
-  "word_count": 800,
-  "reading_time": "4 minutes",
-  "keywords": {
-    "primary": "main keyword",
-    "secondary": ["supporting", "keywords"]
-  },
-  "internal_links": [
-    {
-      "anchor_text": "relevant text",
-      "suggested_url": "/path/to/related/content"
-    }
-  ],
-  "external_links": [
-    {
-      "anchor_text": "source or reference",
-      "url": "https://authoritative-source.com"
-    }
-  ]
-}
-```
-
-## Quality Checklist
-
-Before finalizing any content, ensure:
-
-- [ ] Title is compelling and includes primary keyword
-- [ ] Introduction hooks the reader within first 2 sentences
-- [ ] Content thoroughly addresses user intent
-- [ ] All facts are accurate and verifiable
-- [ ] Proper heading hierarchy is maintained
-- [ ] Content is scannable with varied formatting
-- [ ] Keywords are naturally integrated
-- [ ] Meta description summarizes content effectively
-- [ ] Conclusion provides value and next steps
-- [ ] No spelling or grammar errors
-- [ ] Tone is consistent throughout
-- [ ] Content is original and adds unique value
-
-## Special Instructions
-
-When creating content:
-
-1. Always prioritize user value over keyword density
-2. Write for humans first, search engines second
-3. Include actionable takeaways when relevant
-4. Use data and examples to support claims
-5. Address common questions and objections
-6. Consider content repurposing opportunities
-7. Suggest complementary content pieces
-8. Include social media snippets when requested
-
-Remember: Quality content builds trust, authority, and engagement. Every piece should serve the reader while achieving business objectives.

package/src/agents/content-writer.json

@@ -1,70 +0,0 @@
-{
-  "name": "content-writer",
-  "description": "Professional content writer agent for creating high-quality articles, blog posts, and web content",
-  "version": "1.0.0",
-  "tools": ["Read", "Write", "Edit", "WebSearch", "WebFetch"],
-  "prompt": {
-    "role": "You are a professional content writer specializing in creating engaging, SEO-optimized content.",
-    "instructions": [
-      "Write in a clear, engaging, and professional tone",
-      "Structure content with proper headings (H1, H2, H3)",
-      "Include relevant keywords naturally throughout the content",
-      "Ensure content is factually accurate and well-researched",
-      "Create compelling introductions and conclusions",
-      "Use bullet points and numbered lists where appropriate",
-      "Maintain a consistent voice and style throughout",
-      "Optimize for readability with short paragraphs and varied sentence structure",
-      "Include a meta description suggestion when appropriate",
-      "Format content in Markdown for easy conversion to HTML"
-    ],
-    "workflow": [
-      {
-        "step": 1,
-        "action": "Understand the topic and target audience",
-        "description": "Analyze the content request to identify key topics, audience, and goals"
-      },
-      {
-        "step": 2,
-        "action": "Research and gather information",
-        "description": "Use WebSearch and WebFetch to gather relevant, up-to-date information"
-      },
-      {
-        "step": 3,
-        "action": "Create content outline",
-        "description": "Structure the content with logical flow and proper headings"
-      },
-      {
-        "step": 4,
-        "action": "Write the content",
-        "description": "Create the full content following SEO best practices"
-      },
-      {
-        "step": 5,
-        "action": "Review and optimize",
-        "description": "Review for clarity, accuracy, and SEO optimization"
-      },
-      {
-        "step": 6,
-        "action": "Format and finalize",
-        "description": "Ensure proper Markdown formatting and prepare for publishing"
-      }
-    ],
-    "output_format": {
-      "title": "string",
-      "meta_description": "string (150-160 characters)",
-      "slug": "string (URL-friendly)",
-      "content": "markdown string",
-      "tags": ["array", "of", "relevant", "tags"],
-      "category": "string",
-      "featured_image_suggestion": "string (description for image selection)"
-    }
-  },
-  "configuration": {
-    "default_word_count": 800,
-    "min_word_count": 300,
-    "max_word_count": 2500,
-    "seo_optimization": true,
-    "include_meta": true,
-    "markdown_output": true
-  }
-}

package/src/templates/claude/mcp_config.json

@@ -1,30 +0,0 @@
-{
-  "mcpServers": {
-    "wordpress": {
-      "command": "node",
-      "args": ["../../mcp/wordpress-server.js"],
-      "env": {
-        "WORDPRESS_URL": "${WORDPRESS_URL}",
-        "WORDPRESS_USERNAME": "${WORDPRESS_USERNAME}",
-        "WORDPRESS_APP_PASSWORD": "${WORDPRESS_APP_PASSWORD}"
-      },
-      "autoStart": false,
-      "description": "WordPress MCP server for content management",
-      "tools": [
-        "wp_create_post",
-        "wp_update_post",
-        "wp_get_post",
-        "wp_list_posts",
-        "wp_upload_media",
-        "wp_create_category",
-        "wp_create_tag"
-      ]
-    }
-  },
-  "configuration": {
-    "auto_connect": false,
-    "retry_on_failure": true,
-    "max_retries": 3,
-    "timeout": 30000
-  }
-}

package/src/templates/claude/slash_commands.json

@@ -1,166 +0,0 @@
-{
-  "commands": [
-    {
-      "name": "myai-content-writer",
-      "description": "Launch the professional content writer agent for creating articles and blog posts",
-      "handler": "content-writer",
-      "configuration": {
-        "agent_file": "../../agents/content-writer.json",
-        "prompt_file": "../../agents/content-writer-prompt.md",
-        "tools": ["Read", "Write", "Edit", "WebSearch", "WebFetch", "Task"],
-        "parameters": {
-          "topic": {
-            "type": "string",
-            "required": true,
-            "description": "The topic or title for the content"
-          },
-          "word_count": {
-            "type": "number",
-            "required": false,
-            "default": 800,
-            "description": "Target word count for the content"
-          },
-          "audience": {
-            "type": "string",
-            "required": false,
-            "description": "Target audience for the content"
-          },
-          "tone": {
-            "type": "string",
-            "required": false,
-            "default": "professional",
-            "options": ["professional", "casual", "technical", "conversational", "academic"],
-            "description": "Tone of voice for the content"
-          },
-          "seo_keywords": {
-            "type": "array",
-            "required": false,
-            "description": "Primary and secondary keywords for SEO"
-          },
-          "publish_to_wordpress": {
-            "type": "boolean",
-            "required": false,
-            "default": false,
-            "description": "Automatically publish as draft to WordPress"
-          }
-        }
-      },
-      "examples": [
-        {
-          "command": "/myai-content-writer \"10 Best Practices for Remote Work\"",
-          "description": "Create an article about remote work best practices"
-        },
-        {
-          "command": "/myai-content-writer \"AI in Healthcare\" --word_count 1500 --tone technical --audience \"healthcare professionals\"",
-          "description": "Create a technical article about AI in healthcare for professionals"
-        },
-        {
-          "command": "/myai-content-writer \"Summer Garden Tips\" --seo_keywords \"garden tips,summer gardening,outdoor plants\" --publish_to_wordpress true",
-          "description": "Create SEO-optimized garden content and publish to WordPress"
-        }
-      ],
-      "workflow": {
-        "steps": [
-          {
-            "step": 1,
-            "action": "Parse command parameters",
-            "description": "Extract topic, word count, and other parameters from the command"
-          },
-          {
-            "step": 2,
-            "action": "Load agent configuration",
-            "description": "Load the content-writer agent configuration and prompt"
-          },
-          {
-            "step": 3,
-            "action": "Initialize agent with prompt",
-            "description": "Initialize the agent with the specialized content writer prompt"
-          },
-          {
-            "step": 4,
-            "action": "Execute content creation",
-            "description": "Agent researches and creates the content following the workflow"
-          },
-          {
-            "step": 5,
-            "action": "Save content locally",
-            "description": "Save the generated content to a markdown file"
-          },
-          {
-            "step": 6,
-            "action": "Publish to WordPress (optional)",
-            "description": "If requested, publish the content as a draft to WordPress"
-          }
-        ]
-      }
-    },
-    {
-      "name": "myai-wordpress-publish",
-      "description": "Publish existing content to WordPress as a draft",
-      "handler": "wordpress-publisher",
-      "configuration": {
-        "mcp_config": "../../mcp/wordpress-mcp.json",
-        "tools": ["Read", "Task"],
-        "parameters": {
-          "file": {
-            "type": "string",
-            "required": true,
-            "description": "Path to the markdown file to publish"
-          },
-          "status": {
-            "type": "string",
-            "required": false,
-            "default": "draft",
-            "options": ["draft", "publish", "pending", "private"],
-            "description": "WordPress post status"
-          }
-        }
-      },
-      "examples": [
-        {
-          "command": "/myai-wordpress-publish \"content/my-article.md\"",
-          "description": "Publish a markdown file to WordPress as draft"
-        },
-        {
-          "command": "/myai-wordpress-publish \"blog-post.md\" --status publish",
-          "description": "Publish directly to WordPress (live)"
-        }
-      ]
-    },
-    {
-      "name": "myai-configure",
-      "description": "Configure MyAI settings including WordPress credentials",
-      "handler": "configuration",
-      "configuration": {
-        "tools": ["Read", "Write", "Edit"],
-        "parameters": {
-          "setting": {
-            "type": "string",
-            "required": true,
-            "options": ["wordpress", "defaults", "agents"],
-            "description": "Which setting to configure"
-          }
-        }
-      },
-      "examples": [
-        {
-          "command": "/myai-configure wordpress",
-          "description": "Configure WordPress connection settings"
-        },
-        {
-          "command": "/myai-configure defaults",
-          "description": "Configure default settings for content creation"
-        }
-      ]
-    }
-  ],
-  "global_configuration": {
-    "prefix": "myai",
-    "version": "1.0.0",
-    "auto_load": true,
-    "requirements": {
-      "claude_code_version": ">=1.0.0",
-      "node_version": ">=18.0.0"
-    }
-  }
-}

package/src/templates/scripts/configure-wordpress-mcp.js

@@ -1,181 +0,0 @@
-#!/usr/bin/env node
-
-import fs from 'fs-extra';
-import path from 'path';
-import dotenv from 'dotenv';
-import { fileURLToPath } from 'url';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-/**
- * Configure WordPress MCP integration for Claude Code
- * This script creates the .mcp.json file required for Claude Code to recognize
- * and use the WordPress MCP server
- */
-export async function configureWordPressMCP(projectDir = process.cwd()) {
-  try {
-    console.log('🔧 Configuring WordPress MCP integration...');
-
-    // Load environment variables from .env file
-    const envPath = path.join(projectDir, '.env');
-    if (!fs.existsSync(envPath)) {
-      throw new Error('.env file not found. Please run WordPress configuration first.');
-    }
-
-    dotenv.config({ path: envPath });
-
-    // Validate required environment variables
-    const requiredVars = ['WORDPRESS_URL', 'WORDPRESS_USERNAME', 'WORDPRESS_APP_PASSWORD'];
-    const missing = requiredVars.filter(varName => !process.env[varName]);
-    
-    if (missing.length > 0) {
-      throw new Error(`Missing required environment variables: ${missing.join(', ')}`);
-    }
-
-    // Check if MCP server files exist
-    const mcpServerPath = path.join(projectDir, '.claude/mcp/wordpress-server.js');
-    const gutenbergConverterPath = path.join(projectDir, '.claude/mcp/gutenberg-converter.js');
-
-    if (!fs.existsSync(mcpServerPath)) {
-      throw new Error(`WordPress MCP server not found at: ${mcpServerPath}`);
-    }
-
-    if (!fs.existsSync(gutenbergConverterPath)) {
-      throw new Error(`Gutenberg converter not found at: ${gutenbergConverterPath}`);
-    }
-
-    // Create MCP configuration
-    const mcpConfigPath = path.join(projectDir, '.mcp.json');
-    
-    // Use relative path for portability across different environments
-    const relativeMcpServerPath = ".claude/mcp/wordpress-server.js";
-    
-    const mcpConfig = {
-      mcpServers: {
-        wordpress: {
-          command: "node",
-          args: [relativeMcpServerPath],
-          env: {
-            WORDPRESS_URL: process.env.WORDPRESS_URL,
-            WORDPRESS_USERNAME: process.env.WORDPRESS_USERNAME,
-            WORDPRESS_APP_PASSWORD: process.env.WORDPRESS_APP_PASSWORD,
-            WORDPRESS_USE_GUTENBERG: process.env.WORDPRESS_USE_GUTENBERG || "false"
-          }
-        }
-      }
-    };
-
-    // If .mcp.json already exists, merge with existing configuration
-    let existingConfig = {};
-    if (fs.existsSync(mcpConfigPath)) {
-      try {
-        existingConfig = JSON.parse(fs.readFileSync(mcpConfigPath, 'utf8'));
-        console.log('📝 Found existing .mcp.json file, merging configuration...');
-      } catch (error) {
-        console.warn('⚠️ Existing .mcp.json file is invalid, creating new one...');
-      }
-    }
-
-    // Merge configurations
-    const finalConfig = {
-      ...existingConfig,
-      mcpServers: {
-        ...existingConfig.mcpServers,
-        ...mcpConfig.mcpServers
-      }
-    };
-
-    // Write MCP configuration file
-    fs.writeFileSync(mcpConfigPath, JSON.stringify(finalConfig, null, 2));
-    console.log('✅ Created .mcp.json configuration file');
-
-    // Set executable permissions on MCP server
-    try {
-      fs.chmodSync(mcpServerPath, 0o755);
-      console.log('✅ Set executable permissions on WordPress MCP server');
-    } catch (error) {
-      console.warn('⚠️ Could not set executable permissions:', error.message);
-    }
-
-    // Test MCP server startup
-    console.log('🧪 Testing MCP server startup...');
-    
-    try {
-      const { spawn } = await import('child_process');
-      
-      return new Promise((resolve, reject) => {
-        const testProcess = spawn('node', [relativeMcpServerPath], {
-          cwd: projectDir, // Set working directory to project root
-          env: { ...process.env, ...mcpConfig.mcpServers.wordpress.env },
-          stdio: ['pipe', 'pipe', 'pipe']
-        });
-
-        let stderr = '';
-        testProcess.stderr.on('data', (data) => {
-          stderr += data.toString();
-        });
-
-        // Give the server 3 seconds to start up
-        setTimeout(() => {
-          testProcess.kill('SIGTERM');
-          
-          if (stderr.includes('WordPress MCP Server running') || stderr.includes('Server running')) {
-            console.log('✅ MCP server startup test successful');
-            resolve(true);
-          } else if (stderr.includes('Error') || stderr.includes('Missing required environment')) {
-            console.error('❌ MCP server startup failed:', stderr);
-            reject(new Error('MCP server failed to start'));
-          } else {
-            console.log('✅ MCP server appears to be working');
-            resolve(true);
-          }
-        }, 3000);
-
-        testProcess.on('error', (error) => {
-          reject(new Error(`Failed to start MCP server: ${error.message}`));
-        });
-      });
-    } catch (testError) {
-      console.warn('⚠️ Could not test MCP server startup:', testError.message);
-      console.log('   MCP configuration created, but please test manually if needed');
-    }
-
-    console.log('\n🎉 WordPress MCP integration configured successfully!');
-    console.log('\n📋 Configuration Summary:');
-    console.log(`   • WordPress URL: ${process.env.WORDPRESS_URL}`);
-    console.log(`   • Username: ${process.env.WORDPRESS_USERNAME}`);
-    console.log(`   • Gutenberg mode: ${process.env.WORDPRESS_USE_GUTENBERG || 'false'}`);
-    console.log(`   • MCP config: ${mcpConfigPath}`);
-    console.log(`   • MCP server: ${relativeMcpServerPath}`);
-    
-    console.log('\n🔄 Next steps:');
-    console.log('   1. Restart Claude Code to load the new MCP configuration');
-    console.log('   2. Use WordPress MCP tools in your agents and commands');
-    console.log('   3. Test with: /myai-wordpress-admin or /myai-wordpress-publish');
-
-    return true;
-
-  } catch (error) {
-    console.error('❌ WordPress MCP configuration failed:', error.message);
-    console.log('\n🛠️ Troubleshooting:');
-    console.log('   • Ensure WordPress credentials are configured in .env');
-    console.log('   • Check that .claude/mcp/wordpress-server.js exists');
-    console.log('   • Verify Node.js version is 18+ (required for MCP SDK)');
-    console.log('   • Run: npm install to ensure dependencies are installed');
-    
-    return false;
-  }
-}
-
-// Allow running as standalone script
-if (import.meta.url === `file://${process.argv[1]}`) {
-  configureWordPressMCP()
-    .then((success) => {
-      process.exit(success ? 0 : 1);
-    })
-    .catch((error) => {
-      console.error('Configuration script error:', error);
-      process.exit(1);
-    });
-}