myaidev-method 0.2.11 → 0.2.15

package/README.md

@@ -29,9 +29,12 @@ The **MyAIDev Method** is a complete development framework for AI CLI tools (Cla
 - [Features](#features)
 - [Installation](#installation)
 - [Quick Start](#quick-start)
+- [Updating](#updating)
+- [Developer Use Cases](#developer-use-cases)
 - [SPARC Development Workflow](#sparc-development-workflow)
 - [Development Agents](#development-agents)
 - [Content & Publishing Agents](#content--publishing-agents)
+- [Visual Content Generation](#visual-content-generation)
 - [Slash Commands](#slash-commands)
 - [MCP Server Integration](#mcp-server-integration)
 - [Configuration](#configuration)
@@ -60,11 +63,21 @@ The **MyAIDev Method** is a complete development framework for AI CLI tools (Cla
 - **File-Based Workflow**: Sequential agent coordination with `.myaidev-method/sparc/` outputs
 
 ### 📝 Content & Publishing
-- **Content Writer Agent**: Professional SEO-optimized content creation
+- **Content Writer Agent**: Professional SEO-optimized content creation with optional AI-generated visuals
 - **Multi-Platform Publishing**: WordPress, PayloadCMS, Docusaurus, Mintlify, Astro
 - **Git-Based Workflows**: Automated publishing for static site generators
 - **WordPress Admin Agent**: Security, performance, health monitoring, and administration
 
+### 🎨 Visual Content Generation (New in v0.2.14!)
+- **AI-Powered Image Generation**: Google Gemini 2.5 Flash, Imagen 3, OpenAI DALL-E 3
+- **AI-Powered Video Generation**: Google Veo 2 (up to 8 seconds, 720p)
+- **Multi-Platform Support**: Works with Claude Code, Gemini CLI, and Codex CLI
+- **Budget Management**: Daily/monthly limits, cost tracking, and warnings
+- **Smart Service Selection**: Automatic service selection based on content type
+- **Content Integration**: Generate images during content creation with `--with-images` flag
+- **Cost-Effective**: Starting at $0.02/image (Gemini Flash)
+- **Organized Storage**: Automatic file organization by date in `content-assets/`
+
 ### 🚀 Deployment & Infrastructure
 - **Coolify Integration**: Self-hosted PaaS deployment and orchestration
 - **RamNode Optimized**: Deployment patterns optimized for RamNode.com infrastructure
@@ -134,6 +147,83 @@ npx myaidev-method@latest init
    /myai-wordpress-admin health-check
    ```
 
+## 🔄 Updating
+
+Keep your MyAIDev Method installation up to date with the latest features and bug fixes:
+
+```bash
+# Interactive update (recommended) - prompts for conflicts
+npx myaidev-method@latest update --claude
+
+# Force update - overwrites all files
+npx myaidev-method@latest update --claude --force
+
+# Preview changes without updating
+npx myaidev-method@latest update --claude --dry-run
+```
+
+The update command:
+- ✅ Detects your current version
+- ✅ Updates commands, agents, scripts, and documentation
+- ✅ Preserves your customizations (interactive conflict resolution)
+- ✅ Creates automatic backups before updating
+- ✅ Installs updated dependencies
+
+See [USER_GUIDE.md - Updating Section](USER_GUIDE.md#-updating-myaidev-method) for detailed update instructions and best practices.
+
+## 💡 Developer Use Cases
+
+**New!** See real-world scenarios demonstrating how MyAIDev Method supercharges development workflows:
+
+📖 **[DEVELOPER_USE_CASES.md](DEVELOPER_USE_CASES.md)** - Comprehensive guide featuring:
+
+- **Full-Stack SaaS Development**: Build production-ready apps in days instead of weeks
+- **Microservices Refactoring**: Zero-downtime migrations with systematic strategies
+- **Technical Content Pipeline**: 4x content output with multi-platform publishing
+- **Database Migrations**: Safe migrations with rollback capabilities
+- **Team Collaboration**: Automated code reviews and knowledge bases
+- **ROI Analysis**: Real productivity metrics and time savings
+
+**Examples with Time Savings**:
+- Full-stack feature: 120 hours → 24 hours (80% faster)
+- Technical blog post: 12 hours → 2-3 hours (75% faster)
+- Code review: 45 minutes → 10 minutes (78% faster)
+- Developer onboarding: 2 weeks → 2 days (90% faster)
+
+Each use case includes:
+- Traditional vs MyAIDev approach comparison
+- Complete code examples and commands
+- Quantified time savings and quality improvements
+- Integration patterns and best practices
+
+## 📝 Content Creation for Marketers
+
+**New!** Discover how marketers and content creators can leverage MyAIDev Method for efficient, high-quality content production:
+
+📖 **[CONTENT_CREATION_GUIDE.md](CONTENT_CREATION_GUIDE.md)** - Complete marketing workflow guide featuring:
+
+- **4-Phase Content Pipeline**: Ideation → Generation → Publishing → Optimization
+- **AI Content Generation**: Professional blog posts, tutorials, case studies, and technical content
+- **Multi-Platform Publishing**: WordPress, PayloadCMS, LinkedIn, email newsletters in one workflow
+- **Hub-and-Spoke Distribution**: Single content piece adapted for multiple channels
+- **SEO Optimization**: Keyword research, LSI integration, meta descriptions
+- **Where AI Excels vs Human Input**: Clear guidance on AI capabilities and limitations
+- **8 Common Pitfalls**: Detailed explanations and solutions to avoid content marketing mistakes
+
+**Examples with Time Savings**:
+- Blog post (2,500 words): 12 hours → 2-3 hours (75% faster)
+- Technical tutorial series: 40 hours → 8 hours (80% faster)
+- Multi-platform distribution: 6 hours → 30 minutes (92% faster)
+- SEO research and optimization: 4 hours → 45 minutes (81% faster)
+
+**Content Templates Included**:
+- Long-form educational blog posts
+- Technical tutorials with code examples
+- Product announcements and release notes
+- Case studies with metrics and results
+- LinkedIn thought leadership articles
+- Email newsletters
+
 ## 🏗️ SPARC Development Workflow
 
 The **MyAIDev Method** implements the **SPARC methodology** - a systematic 5-phase approach to software development inspired by [GitHub Spec-Kit](https://github.com/github/spec-kit) patterns for agentic software development.
@@ -480,18 +570,129 @@ Self-hosted PaaS deployment for applications.
 - Resource management
 - Multi-environment support
 
+## 🎨 Visual Content Generation
+
+**New in v0.2.14!** Generate AI-powered images and videos for your content using Google AI (Gemini, Imagen, Veo) and OpenAI (DALL-E) services.
+
+### Features
+
+- **Image Generation**: Google Gemini 2.5 Flash ($0.02), Imagen 3 ($0.03), DALL-E 3 ($0.04-0.12)
+- **Video Generation**: Google Veo 2 ($0.10 for up to 8 seconds, 720p)
+- **Multi-Platform**: Works with Claude Code, Gemini CLI, and Codex CLI
+- **Budget Management**: Daily/monthly limits, cost tracking, and warnings
+- **Smart Organization**: Automatic file storage by date in `content-assets/`
+- **Content Integration**: Generate images during content creation with `--with-images` flag
+
+### Setup
+
+1. **Configure Visual APIs** (one-time setup):
+   ```bash
+   # Claude Code
+   /myai-configure visual
+
+   # Gemini CLI / Codex CLI
+   npm run configure:visual
+   ```
+
+2. **Follow the interactive wizard** to set up:
+   - Google AI API key (for Gemini, Imagen, Veo)
+   - OpenAI API key (for DALL-E)
+   - Default service preference
+   - Daily and monthly budget limits
+
+### Usage
+
+#### Claude Code
+```bash
+# Generate a hero image
+/myai-generate-visual "Modern developer workspace with dual monitors"
+
+# Generate with specific service
+/myai-generate-visual "AI concept illustration" --service dalle --type illustration
+
+# Generate diagram
+/myai-generate-visual "Microservices architecture" --type diagram --service gemini
+
+# Create content with images
+/myai-content-writer "Best Practices for Remote Work" --with-images
+```
+
+#### Gemini CLI / Codex CLI
+```bash
+# Generate a hero image
+npm run generate-visual "Modern developer workspace"
+
+# Generate with options
+npm run generate-visual "System architecture" -- --type=diagram --service=gemini
+
+# Configure visual APIs
+npm run configure:visual
+```
+
+### Service Comparison
+
+| Service | Speed | Cost | Quality | Best For |
+|---------|-------|------|---------|----------|
+| **Gemini 2.5 Flash** | ⚡⚡⚡ | $0.02 | Good | Quick hero images, diagrams, high volume |
+| **Imagen 3** | ⚡⚡ | $0.03 | Excellent | Premium hero images, high-quality visuals |
+| **DALL-E 3** | ⚡⚡ | $0.04-0.12 | Excellent | Creative illustrations, detailed designs |
+| **Veo 2** | ⚡ | $0.10 | Good | Product demos, short videos |
+
+### Image Types
+
+- `hero` - Article header images (recommended: 1792x1024)
+- `illustration` - Abstract concepts and metaphors
+- `diagram` - Technical workflows and architecture
+- `screenshot` - UI mockups and interface designs
+- `video` - Product demos and tutorials (Veo 2 only)
+
+### Budget Management
+
+The system automatically tracks costs and enforces budget limits:
+- **Daily Budget**: Configurable limit (default: $5.00)
+- **Monthly Budget**: Configurable limit (default: $50.00)
+- **Warning Threshold**: Alert at 80% usage
+- **Usage Tracking**: Stored in `.visual-usage-stats.json`
+
+### File Organization
+
+Generated files are automatically organized by date:
+```
+content-assets/
+├── images/
+│   └── 2025-11-19/
+│       ├── hero-workspace-123456.png
+│       └── diagram-architecture-234567.png
+└── videos/
+    └── 2025-11-19/
+        └── video-demo-345678.mp4
+```
+
+### Documentation
+
+For comprehensive documentation, see:
+- **VISUAL_CONTENT_GENERATION_GUIDE.md** - Complete user guide
+- **VISUAL_GENERATION_FILE_ORGANIZATION.md** - File structure details
+- **CONTENT_CREATION_GUIDE.md** - Content workflow integration
+
 ## 🎯 Slash Commands
 
 ### `/myai-content-writer`
-Create professional, SEO-optimized content.
+Create professional, SEO-optimized content with optional AI-generated visuals.
 
 ```bash
 # Basic usage
 /myai-content-writer "Best Practices for Remote Work"
 
+# With AI-generated images (new!)
+/myai-content-writer "Best Practices for Remote Work" --with-images
+
 # With parameters
 /myai-content-writer "AI in Healthcare" --word_count 1500 --tone technical --audience "healthcare professionals"
 
+# With images and specific service
+/myai-content-writer "Microservices Guide" --with-images --service gemini
+
 # With WordPress publishing
 /myai-content-writer "Summer Garden Tips" --publish_to_wordpress true
 ```
@@ -503,6 +704,37 @@ Create professional, SEO-optimized content.
 - `audience`: Target reader demographic
 - `seo_keywords`: Array of keywords for optimization
 - `publish_to_wordpress`: Auto-publish as draft (true/false)
+- `--with-images`: Generate AI-powered images (new!)
+- `--service`: Preferred image service (gemini, imagen, dalle)
+
+### `/myai-generate-visual`
+Generate AI-powered images and videos for content.
+
+```bash
+# Generate a hero image (auto-selects best service)
+/myai-generate-visual "Modern developer workspace with dual monitors"
+
+# Generate with specific service
+/myai-generate-visual "AI concept illustration" --service dalle --type illustration
+
+# Generate diagram
+/myai-generate-visual "Microservices architecture" --type diagram --service gemini
+
+# Generate HD image
+/myai-generate-visual "Product mockup" --quality hd --size 1792x1024
+
+# Generate video (Veo 2)
+/myai-generate-visual "Product demo walkthrough" --type video --service veo
+```
+
+**Parameters:**
+- `prompt` (required): Description of the image/video to generate
+- `--type`: Image type (hero, illustration, diagram, screenshot, video)
+- `--service`: Preferred service (gemini, imagen, dalle, veo)
+- `--quality`: Quality level (standard, hd)
+- `--size`: Image dimensions (1024x1024, 1792x1024, 1024x1792)
+
+**Prerequisites:** Run `/myai-configure visual` first to set up API keys and budgets.
 
 ### `/myai-wordpress-admin`
 Comprehensive WordPress site administration.

package/USER_GUIDE.md

@@ -7,6 +7,7 @@ This guide covers everything you need to know about using, customizing, and exte
 ## 📋 Table of Contents
 
 - [Quick Start](#quick-start)
+- [Updating MyAIDev Method](#-updating-myaidev-method)
 - [Understanding the Structure](#understanding-the-structure)
 - [👤 User Pathways](#-user-pathways)
   - [Content Creator Pathway](#content-creator-pathway)
@@ -98,6 +99,161 @@ You'll have a `.claude` folder in your project:
 /myai-configure agents --list
 ```
 
+## 🔄 Updating MyAIDev Method
+
+The MyAIDev Method package receives regular updates with new features, bug fixes, and improved agents. Keep your installation up to date to access the latest capabilities.
+
+### Checking for Updates
+
+Your current installation version is stored in `.claude/.myaidev-version`. When new versions are published to npm, you can update using the dedicated update command.
+
+### Running Updates
+
+```bash
+# Interactive update (recommended) - prompts for conflicts
+npx myaidev-method@latest update --claude
+
+# Force update - overwrites all files without prompting
+npx myaidev-method@latest update --claude --force
+
+# Preview changes - see what would be updated without making changes
+npx myaidev-method@latest update --claude --dry-run
+
+# Verbose output - show detailed progress
+npx myaidev-method@latest update --claude --verbose
+```
+
+### What Gets Updated
+
+The update command updates all MyAIDev Method components:
+
+- ✅ **Slash commands** (`.claude/commands/`) - New commands and improvements
+- ✅ **Agent definitions** (`.claude/agents/`) - Enhanced prompts and capabilities
+- ✅ **Executable scripts** (`.myaidev-method/scripts/`) - Bug fixes and new features
+- ✅ **Utility libraries** (`.myaidev-method/lib/`) - Helper functions and utilities
+- ✅ **Documentation files** (`USER_GUIDE.md`, `PUBLISHING_GUIDE.md`, etc.) - Updated guides
+- ✅ **MCP configurations** (`.claude/mcp/`) - Server configurations and integrations
+- ✅ **Dependencies** (`.myaidev-method/package.json`) - npm package updates
+
+### Handling Customizations
+
+If you've customized agents or commands, the update process intelligently handles conflicts:
+
+1. **Detection**: The update command detects which files you've modified
+2. **Diff Display**: Shows you the differences between your version and the new version
+3. **User Choice**: You decide what to do for each modified file:
+   - **Keep current** - Skip this update, preserve your customizations
+   - **Use new version** - Overwrite with the latest version
+   - **View diff** - See detailed line-by-line differences
+   - **Keep + backup** - Update to new version and save your current version as `.bak`
+
+Example update session:
+
+```
+$ npx myaidev-method@latest update --claude
+
+🔍 Detecting MyAIDev Method installation...
+
+✓ Found claude installation
+  Current version: 0.2.11
+  Latest version: 0.2.12
+
+⚠️  This will update your MyAIDev Method installation
+   Modified files will require your confirmation
+
+? Continue with update? Yes
+
+💾 Creating backup...
+✓ Backup created at: .myaidev-method-backup-2025-11-10T20-59-00
+
+📦 Updating components...
+
+Commands:
+  ➕ myai-new-feature.md (new)
+  ✓ myai-git-pr.md (unchanged)
+
+Agents:
+📝 content-writer.md has been modified
+? What would you like to do?
+  ❯ Keep current version (skip update)
+    Use new version (overwrite)
+    View diff
+    Keep current + backup (.bak)
+
+  ✅ payloadcms-publish.md (updated)
+
+Scripts:
+  ✅ payloadcms-publish.js (updated)
+  ✅ coolify-deploy-app.js (updated)
+
+═══════════════════════════════════════
+  Update Summary
+═══════════════════════════════════════
+  ✅ Updated: 5 files
+  ➕ Added: 2 new files
+  ⏭️  Skipped: 1 files (kept current)
+═══════════════════════════════════════
+
+✅ Successfully updated to v0.2.12
+   Backup available at: .myaidev-method-backup-2025-11-10T20-59-00
+```
+
+### Safety Features
+
+**Automatic Backups**: Before making any changes, the update command creates a complete backup:
+```
+.myaidev-method-backup-{timestamp}/
+├── .claude/
+├── .myaidev-method/
+└── *.md (documentation files)
+```
+
+**Dry Run Mode**: Preview all changes without modifying any files:
+```bash
+npx myaidev-method@latest update --claude --dry-run
+```
+
+**Version Tracking**: The update command checks your current version and only proceeds if an update is available.
+
+### Best Practices
+
+1. **Review Release Notes**: Check the [CHANGELOG.md](CHANGELOG.md) before updating
+2. **Use Dry Run**: Preview changes with `--dry-run` before actual update
+3. **Backup Custom Work**: If you have heavily customized agents, create manual backups
+4. **Update Regularly**: Stay current with latest features and security fixes
+5. **Test After Update**: Verify your workflows still function as expected
+
+### Troubleshooting Updates
+
+**Update command not found**:
+```bash
+# Ensure you're using the latest package
+npx myaidev-method@latest --version
+```
+
+**No installation detected**:
+```bash
+# Verify installation exists
+ls -la .claude
+
+# Reinstall if needed
+npx myaidev-method@latest init --claude
+```
+
+**Dependency installation fails**:
+```bash
+# Manually install dependencies
+cd .myaidev-method
+npm install
+```
+
+**Want to rollback an update**:
+```bash
+# Restore from backup
+rm -rf .claude .myaidev-method *.md
+cp -r .myaidev-method-backup-{timestamp}/* .
+```
+
 ## 🏗️ Understanding the Structure
 
 ### Commands Directory (`.claude/commands/`)

package/VISUAL_GENERATION_FILE_ORGANIZATION.md

@@ -0,0 +1,105 @@
+# Visual Generation Feature - File Organization
+
+## Directory Structure Explanation
+
+### Source Templates (Distribution Files)
+These are the **source files** that get distributed via npm and installed when users run `npx myaidev-method init`:
+
+```
+src/templates/
+├── claude/
+│   ├── agents/          ← Agent templates for Claude Code
+│   │   ├── content-writer.md
+│   │   ├── visual-content-generator.md  ✅ ADDED
+│   │   └── ...
+│   └── commands/        ← Command templates for Claude Code
+│       ├── myai-content-writer.md
+│       ├── myai-generate-visual.md      📝 TO ADD
+│       └── ...
+├── gemini/
+│   └── commands/        ← Command templates for Gemini CLI
+│       └── myai-generate-visual.md      📝 TO ADD
+└── codex/
+    └── commands/        ← Command templates for Codex CLI
+        └── myai-generate-visual.md      📝 TO ADD
+```
+
+### Runtime/Development (.claude folder)
+This is the **runtime directory** for the current project only (not distributed):
+
+```
+.claude/
+├── agents/              ← Installed agents (copied from templates)
+│   ├── content-writer.md
+│   ├── visual-content-generator.md  ✅ EXISTS (local dev)
+│   └── ...
+└── commands/            ← Installed commands (copied from templates)
+    └── ...
+```
+
+## How Installation Works
+
+When users run `npx myaidev-method init --claude`:
+
+1. Script reads from: `src/templates/claude/agents/`
+2. Copies files to: `PROJECT_DIR/.claude/agents/`
+3. Result: User gets all agents in their project
+
+**Key Point:** Files in `.claude/` are local development only. To distribute to users, files must be in `src/templates/`
+
+## Files Created So Far
+
+### ✅ Completed (Correct Location)
+
+**JavaScript Utilities** (in `src/lib/` - distributed via package.json):
+- `src/lib/visual-generation-utils.js` ✅
+- `src/lib/asset-management.js` ✅
+- `src/lib/visual-config-utils.js` ✅
+
+**Agents** (in templates):
+- `src/templates/claude/agents/visual-content-generator.md` ✅
+
+### 📝 Still Need to Create
+
+**Commands** (need to create in templates for all 3 platforms):
+- `src/templates/claude/commands/myai-generate-visual.md`
+- `src/templates/gemini/commands/myai-generate-visual.md`
+- `src/templates/codex/commands/myai-generate-visual.md`
+
+**Configuration Script**:
+- `src/scripts/configure-visual-apis.js`
+
+**Updates Needed**:
+- `src/templates/claude/agents/content-writer.md` (add --with-images support)
+- `src/templates/claude/commands/myai-content-writer.md` (document new flag)
+- `src/templates/claude/commands/myai-configure.md` (add visual option)
+- Similar updates for gemini and codex templates
+
+**Package Files**:
+- `.env.example`
+- `.gitignore`
+- `package.json`
+
+**Documentation**:
+- `VISUAL_CONTENT_GENERATION_GUIDE.md`
+- Update `CONTENT_CREATION_GUIDE.md`
+- Update `README.md`
+
+## Action Plan
+
+1. ✅ Core utilities in `src/lib/` (DONE)
+2. ✅ Agent template in `src/templates/claude/agents/` (DONE)
+3. Create command templates for all 3 platforms
+4. Create configuration script
+5. Update existing templates
+6. Update documentation
+7. Update package.json
+
+## Platform Support
+
+We support 3 CLI platforms:
+- **Claude Code**: Full support with .claude/ structure
+- **Gemini CLI**: Commands only (no agents yet per their structure)
+- **Codex CLI**: Commands only (no agents yet per their structure)
+
+For Gemini and Codex, we focus on commands that can call the JavaScript utilities directly.