myaidev-method 0.2.24-1 → 0.2.24-2

package/src/templates/claude/commands/myai-content-enrichment.md

@@ -0,0 +1,227 @@
+---
+name: myai-content-enrichment
+description: Enrich existing articles with real-time data and AI-generated visuals
+tools: Read, Write, Edit, Bash, SlashCommand
+---
+
+Enhance existing articles with real-time data from enrichment apps and optionally add context-aware visuals.
+
+## Task
+
+Enrich the article at: $ARGUMENTS
+
+## What This Does
+
+**Does NOT write new content.** Takes existing markdown and:
+- Runs data enrichment apps (network latency, brand extraction)
+- Updates content with real, current data
+- Optionally generates visuals using enrichment context (via `/myai-generate-visual`)
+
+## Usage
+
+```bash
+# Add network data to article
+/myai-content-enrichment "article.md" --app network ashburn-va
+
+# Extract branding + generate branded visuals
+/myai-content-enrichment "article.md" --app branding https://example.com --with-images
+
+# Full enrichment (auto-detect apps + visuals)
+/myai-content-enrichment "article.md" --app all --with-images --auto
+```
+
+## Flags
+
+**Data Apps:**
+- `--app branding <url>` - Extract brand colors/styling
+- `--app network <location>` - Run latency tests (ashburn-va, los-angeles, chicago, europe, asia)
+- `--app all` - Auto-detect and run relevant apps
+- `--auto` - Skip confirmation prompts
+
+**Visuals:**
+- `--with-images` - Generate visuals with enrichment data
+- `--regenerate-images` - Replace existing images
+- `--no-images` - Skip visuals (default if not specified)
+
+**Options:**
+- `--preserve-original` - Backup before modifying
+
+## Workflow
+
+### 1. Parse & Validate
+- Read target article
+- Parse flags
+- Confirm apps to run (unless `--auto`)
+
+### 2. Run Data Apps
+**Network App** (`--app network <location>`):
+- Execute: `node src/scripts/ping.js 'location'`
+- Save: `./data/latency-test-YYYYMMDD.md`
+- Extract metrics for content
+
+**Branding App** (`--app branding <url>`):
+- Check cache: `brand_design_guidelines.md`
+- If not cached: Navigate → Screenshot → Analyze → Cache
+- Store brand colors/style for visuals
+
+### 3. Update Content
+- Find relevant sections (e.g., performance data)
+- Inject real metrics
+- Add data citations
+- Preserve original voice/style
+
+### 4. Generate Visuals (Optional)
+**If `--with-images` or `--regenerate-images`:**
+- Analyze article sections needing visuals
+- Build enriched prompts:
+  - Base: Article context
+  - Add brand: `primary #2245C4, accent #19FFF4, modern professional style`
+  - Add data: `Ashburn 24.5ms, Chicago 31.4ms, LA 45.2ms`
+- Delegate to `/myai-generate-visual` with enriched prompt
+- Embed generated images with captions
+
+See `/myai-generate-visual --help` for visual generation details.
+
+### 5. Finalize
+- Save enriched article (backup if `--preserve-original`)
+- Report what was enriched
+
+## Data Apps Reference
+
+### Network Latency
+
+**Script:** `src/scripts/ping.js`  
+**Locations:** ashburn-va, los-angeles, chicago, europe, asia  
+**Output:** `./data/latency-test-YYYYMMDD.md`
+
+```bash
+node src/scripts/ping.js 'ashburn-va' 'europe'
+```
+
+### Brand Extraction
+
+**Cache:** `brand_design_guidelines.md`  
+**Process:** Playwright screenshot → Color/style analysis → Cache  
+**Reuse:** Once cached, reused for all future enrichments
+
+## Example
+
+**Before:**
+```markdown
+# Cloud Hosting Performance
+Performance varies by location.
+```
+
+**Command:**
+```bash
+/myai-content-enrichment "article.md" --app network ashburn-va --app branding https://mycompany.com --with-images --auto
+```
+
+**After:**
+```markdown
+# Cloud Hosting Performance
+
+Performance varies by location. Our real-time tests show:
+
+- **Ashburn, VA**: 24.5ms average latency
+- **Chicago, IL**: 31.4ms average latency
+
+![Network Performance](./content-assets/images/2026-01-16/infographic-network-latency-123456.png)
+*Real-time tests conducted 2026-01-16. Source: ./data/latency-test-20260116.md*
+```
+
+**Visual:** Infographic with your brand colors showing exact latency on US map.
+
+## Output Report
+
+```
+✅ Enrichment Complete: cloud-hosting-guide.md
+
+Apps Run:
+  • Network: ashburn-va, chicago
+  • Branding: https://mycompany.com (cached)
+
+Data Updated:
+  • Performance section: +2 real metrics
+  • Added data citation
+
+Visuals Generated:
+  • Network infographic (via /myai-generate-visual)
+    File: ./content-assets/images/2026-01-16/infographic-network-latency.png
+    Cost: $0.02
+
+File: ./cloud-hosting-guide.md
+Backup: ./cloud-hosting-guide.original.md
+```
+
+## Use Cases
+
+**Refresh old data:**
+```bash
+/myai-content-enrichment "old-article.md" --app network ashburn-va --update-data
+```
+
+**Add brand to generic content:**
+```bash
+/myai-content-enrichment "guide.md" --app branding https://mycompany.com --with-images
+```
+
+**Rebrand existing content:**
+```bash
+/myai-content-enrichment "article.md" --app branding https://newsite.com --regenerate-images
+```
+
+**Full pipeline:**
+```bash
+/myai-content-enrichment "article.md" --app all --with-images --auto
+```
+
+## Integration
+
+**Content Pipeline:**
+```bash
+# 1. Write
+/myai-content-writer "Cloud Hosting" word_count:2000
+
+# 2. Enrich
+/myai-content-enrichment "cloud-hosting.md" --app network ashburn-va --with-images
+
+# 3. Publish
+/myai-wordpress-publish "cloud-hosting.md"
+```
+
+**Visual Delegation:**
+```bash
+# Enrichment calls this internally:
+/myai-generate-visual "Network infographic showing Ashburn 24.5ms, use brand #2245C4" --type illustration
+```
+
+## Technical Notes
+
+**Visual Generation (Stage 4):**
+1. Build enriched prompt from context + app data
+2. Invoke: `SlashCommand('/myai-generate-visual "prompt" --type illustration')`
+3. Parse output for image path
+4. Embed: `![alt](path)\n*caption*`
+
+**Prompt Enhancement Pattern:**
+```javascript
+const prompt = `${baseDescription}, use brand colors: ${brand.primary} ${brand.accent}, show latency: ${network.metrics}`;
+```
+
+## Related Commands
+
+- `/myai-content-writer` - Write articles
+- `/myai-generate-visual` - Generate visuals standalone
+- `/myai-wordpress-publish` - Publish to WordPress
+
+## Error Handling
+
+**Article not found:** Check file path  
+**App fails:** Check network/URL accessibility  
+**Visual fails:** Ensure `/myai-configure visual` is set up  
+**Budget exceeded:** Visual generation has cost limits
+
+---
+
+**Philosophy:** Enrichment enhances, it doesn't replace. Preserve the original article's voice and intent.

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

@@ -1,35 +1,14 @@
 ---
 name: myai-content-writer
-description: Professional content writer for SEO-optimized articles with optional AI-generated visuals
-tools: Read, Write, Edit, WebSearch, WebFetch, Task, Bash
+description: Professional content writer for SEO-optimized articles and blog posts
+tools: Read, Write, Edit, WebSearch, WebFetch, Task
 ---
 
-You are a professional content writer specializing in creating high-quality, engaging, and SEO-optimized content with optional AI-generated visual content.
+You are a professional content writer specializing in creating high-quality, engaging, and SEO-optimized content.
 
 ## Task
-Create comprehensive, well-researched content based on the provided topic: $ARGUMENTS
-
-## Visual Content Generation (New!)
-
-The MyAIDev Method now supports AI-powered visual content generation. Use the `--with-images` flag to automatically generate:
-- Hero images for article headers
-- Illustrations for concepts
-- Diagrams for technical workflows
-- Supporting visual content
-
-**Example Usage:**
-```bash
-/myai-content-writer "Microservices Architecture" --with-images
-/myai-content-writer "AI Best Practices" --with-images --service=dalle
-/myai-content-writer "Developer Guide" --with-images --word-count=1500
-```
 
-**Prerequisites**: User must configure visual generation APIs first:
-```bash
-/myai-configure visual
-```
-
-**Available Services**: Gemini 2.5 Flash ($0.02), Imagen 3 ($0.03), DALL-E 3 ($0.04-0.12), Veo 2 ($0.10 for video)
+Create comprehensive, well-researched content based on the provided topic: $ARGUMENTS
 
 ## Core Competencies
 
@@ -62,6 +41,20 @@ The MyAIDev Method now supports AI-powered visual content generation. Use the `-
 5. **Optimization**: Review for clarity, accuracy, and SEO
 6. **Formatting**: Ensure proper Markdown formatting
 
+## Parameters Supported
+
+- Topic (required): Main subject matter
+- `--word-count`: Target length (default: 800)
+- `--tone`: professional, casual, technical, conversational, academic
+- `--audience`: Target reader demographic
+- `--keywords`: Primary and secondary keywords
+- `--publish-wordpress`: Auto-publish as draft (true/false)
+
+**Example:**
+```bash
+/myai-content-writer "Machine Learning Best Practices" word_count:1500 tone:technical
+```
+
 ## Output Requirements
 
 Save the content as a markdown file with the following structure:
@@ -80,24 +73,42 @@ category: [Primary category]
 [Content with proper heading hierarchy]
 ```
 
-## Parameters Supported
+## Content Enrichment (Post-Writing)
 
-- Topic (required): Main subject matter
-- `--word-count`: Target length (default: 800)
-- `--tone`: professional, casual, technical, conversational, academic
-- `--audience`: Target reader demographic
-- `--keywords`: Primary and secondary keywords
-- `--publish-wordpress`: Auto-publish as draft (true/false)
-- `--with-images`: Generate AI-powered visual content (new!)
-- `--service`: Preferred image generation service (gemini, imagen, dalle)
-- `--image-count`: Number of images to generate (default: auto-determined)
+After creating your article, you can enhance it with real-time data and AI-generated visuals using the enrichment command:
+
+```bash
+/myai-content-enrichment "your-article.md" --app network ashburn-va --with-images
+```
+
+**Enrichment Features:**
+- Add real network latency data to infrastructure/hosting articles
+- Extract brand colors/styling for consistent illustrations
+- Generate context-aware visuals with enrichment data
+- Update existing articles with fresh data
+
+See `/myai-content-enrichment --help` for full documentation.
 
 ## WordPress Integration
 
-If publish_to_wordpress is requested:
+If `--publish-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.
+## Workflow
+
+**Typical usage:**
+```bash
+# Step 1: Write the article
+/myai-content-writer "Cloud Hosting Guide" word_count:2000 tone:professional
+
+# Step 2: (Optional) Enrich with data and visuals
+/myai-content-enrichment "cloud-hosting-guide.md" --app network ashburn-va --with-images --auto
+
+# Step 3: (Optional) Publish to WordPress
+/myai-wordpress-publish "cloud-hosting-guide.md" --status draft
+```
+
+Always prioritize user value over keyword density. Write for humans first, search engines second.