myaidev-method 0.2.12 → 0.2.15

package/README.md

@@ -30,9 +30,11 @@ The **MyAIDev Method** is a complete development framework for AI CLI tools (Cla
 - [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)
@@ -61,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
@@ -159,6 +171,59 @@ The update command:
 
 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.
@@ -505,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
 ```
@@ -528,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/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.

package/bin/cli.js

@@ -208,6 +208,7 @@ This project uses the MyAIDev Method package for enhanced AI-assisted developmen
 
 ### Content Creation
 - \`/myai-content-writer\` - Create SEO-optimized content
+- \`/myai-coordinate-content\` - Coordinate content production workflow (verify and publish)
 
 ### Publishing Platforms
 - \`/myai-wordpress-publish\` - Publish to WordPress
@@ -234,6 +235,8 @@ This project uses the MyAIDev Method package for enhanced AI-assisted developmen
 
 ### Content & Publishing Agents
 - \`content-writer\` - Professional content creation agent
+- \`content-production-coordinator\` - Orchestrate content verification and publishing workflow
+- \`proprietary-content-verifier\` - Verify content uniqueness and quality
 - \`wordpress-admin\` - WordPress administration and security agent
 - \`payloadcms-publish\` - PayloadCMS publishing agent
 - \`docusaurus-publish\` - Docusaurus publishing agent
@@ -243,6 +246,49 @@ This project uses the MyAIDev Method package for enhanced AI-assisted developmen
 ### Deployment Agents
 - \`coolify-deploy\` - Coolify deployment agent
 
+## Content Production Workflow
+
+The MyAIDev Method includes a comprehensive content production workflow:
+
+### Coordinated Publishing
+
+Use the content production coordinator to verify and publish multiple pieces of content:
+
+\`\`\`bash
+/myai-coordinate-content ./content-queue/
+\`\`\`
+
+**Workflow:**
+1. **Verification**: Automatically checks content for uniqueness and quality
+2. **Categorization**: Separates content into "Ready for Publishing" and "Needs Review"
+3. **Reports**: Generates timestamped reports with detailed analysis
+4. **Publishing**: Publishes approved content in parallel for efficiency
+5. **Tracking**: Reports all published URLs back to you
+
+**Options:**
+- \`--dry-run\` - Only verify content, don't publish
+- \`--force\` - Skip confirmation prompts
+- \`--verbose\` - Show detailed progress
+- \`--output-dir\` - Specify report directory
+
+### Content Verification
+
+The proprietary-content-verifier agent evaluates:
+- **Knowledge Redundancy**: Whether content is unique or duplicates existing knowledge
+- **AI Detection**: Identifies characteristics of AI-generated content
+- **Quality Assessment**: Provides recommendations for improvement
+
+Content is scored as: **High | Medium | Low | Minimal** redundancy
+
+### Agent Architecture
+
+The content production system uses a coordinator pattern:
+- \`content-production-coordinator\` orchestrates the workflow
+- \`proprietary-content-verifier\` validates content quality
+- \`content-writer\` creates and publishes approved content
+
+All agents work in parallel for maximum efficiency.
+
 ## Platform Configuration
 
 To use publishing features, configure your platforms in \`.env\`:

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "myaidev-method",
-  "version": "0.2.12",
-  "description": "Comprehensive development framework with SPARC methodology for AI-assisted software development, multi-platform publishing (WordPress, PayloadCMS, Astro, Docusaurus, Mintlify), and Coolify deployment",
+  "version": "0.2.15",
+  "description": "Comprehensive development framework with SPARC methodology for AI-assisted software development, AI visual content generation (Gemini, Imagen, DALL-E, Veo), multi-platform publishing (WordPress, PayloadCMS, Astro, Docusaurus, Mintlify), and Coolify deployment",
   "mcpName": "io.github.myaione/myaidev-method",
   "main": "src/index.js",
   "bin": {
@@ -48,6 +48,8 @@
     "mintlify:publish": "node src/scripts/mintlify-publish.js",
     "astro:publish": "node src/scripts/astro-publish.js",
     "configure": "node src/scripts/configure-cms.js",
+    "configure:visual": "node src/scripts/configure-visual-apis.js",
+    "generate:visual": "node src/scripts/generate-visual-cli.js",
     "init": "node src/scripts/init-project.js"
   },
   "keywords": [
@@ -78,6 +80,14 @@
     "documentation",
     "ai-agents",
     "automation",
+    "image-generation",
+    "ai-images",
+    "video-generation",
+    "gemini",
+    "imagen",
+    "dall-e",
+    "veo",
+    "visual-content",
     "deployment",
     "devops",
     "cli-tool",
@@ -100,6 +110,7 @@
     "dotenv": "^16.4.1",
     "effect": "^3.18.4",
     "fs-extra": "^11.2.0",
+    "google-auth-library": "^10.5.0",
     "gray-matter": "^4.0.3",
     "hono": "^4.10.3",
     "inquirer": "^9.2.15",
@@ -133,6 +144,10 @@
     "dist/",
     "README.md",
     "USER_GUIDE.md",
+    "DEVELOPER_USE_CASES.md",
+    "CONTENT_CREATION_GUIDE.md",
+    "VISUAL_CONTENT_GENERATION_GUIDE.md",
+    "VISUAL_GENERATION_FILE_ORGANIZATION.md",
     "LICENSE",
     ".env.example",
     "DEV_WORKFLOW_GUIDE.md",