myaidev-method 0.2.24-1 → 0.2.24-3

package/.claude-plugin/plugin.json

@@ -0,0 +1,251 @@
+{
+  "name": "myaidev-method",
+  "version": "1.0.0",
+  "description": "Comprehensive AI development framework with SPARC methodology, content creation, multi-platform publishing, visual generation, and security testing",
+  "author": {
+    "name": "Samuel Mukoti",
+    "email": "samuelm@openmy.ai",
+    "url": "https://github.com/myaione"
+  },
+  "homepage": "https://dev.myai1.ai/plugins/myaidev-method",
+  "repository": "https://github.com/myaione/myaidev-method",
+  "license": "MIT",
+  "keywords": [
+    "sparc",
+    "content-creation",
+    "wordpress",
+    "visual-generation",
+    "security-testing",
+    "devops",
+    "publishing",
+    "ai-agents",
+    "seo",
+    "payloadcms",
+    "coolify",
+    "openstack"
+  ],
+  "capabilities": [
+    "content-creation",
+    "visual-generation",
+    "sparc-development",
+    "multi-platform-publishing",
+    "security-testing",
+    "deployment",
+    "openstack-management"
+  ],
+  "skills": "../skills/",
+  "commands": {
+    "myai-content-writer": {
+      "source": "../src/templates/claude/commands/myai-content-writer.md",
+      "aliases": ["myaidev-method:content-writer", "content-writer"]
+    },
+    "myai-configure": {
+      "source": "../src/templates/claude/commands/myai-configure.md",
+      "aliases": ["myaidev-method:configure", "configure"]
+    },
+    "myai-wordpress-publish": {
+      "source": "../src/templates/claude/commands/myai-wordpress-publish.md",
+      "aliases": ["myaidev-method:wordpress-publish", "wordpress-publish"]
+    },
+    "myai-generate-visual": {
+      "source": "../src/templates/claude/commands/myai-generate-visual.md",
+      "aliases": ["myaidev-method:generate-visual", "generate-visual"]
+    },
+    "myai-coordinate-content": {
+      "source": "../src/templates/claude/commands/myai-coordinate-content.md",
+      "aliases": ["myaidev-method:coordinate-content", "coordinate-content"]
+    },
+    "myai-openstack": {
+      "source": "../src/templates/claude/commands/myai-openstack.md",
+      "aliases": ["myaidev-method:openstack", "openstack"]
+    },
+    "myai-coolify-deploy": {
+      "source": "../src/templates/claude/commands/myai-coolify-deploy.md",
+      "aliases": ["myaidev-method:coolify-deploy", "coolify-deploy"]
+    },
+    "myai-sparc-workflow": {
+      "source": "../src/templates/claude/commands/myai-sparc-workflow.md",
+      "aliases": ["myaidev-method:sparc", "sparc"]
+    },
+    "myai-dev-architect": {
+      "source": "../src/templates/claude/commands/myai-dev-architect.md",
+      "aliases": ["myaidev-method:architect", "architect"]
+    },
+    "myai-dev-code": {
+      "source": "../src/templates/claude/commands/myai-dev-code.md",
+      "aliases": ["myaidev-method:code", "code"]
+    },
+    "myai-dev-test": {
+      "source": "../src/templates/claude/commands/myai-dev-test.md",
+      "aliases": ["myaidev-method:test", "test"]
+    },
+    "myai-dev-review": {
+      "source": "../src/templates/claude/commands/myai-dev-review.md",
+      "aliases": ["myaidev-method:review", "review"]
+    },
+    "myai-dev-docs": {
+      "source": "../src/templates/claude/commands/myai-dev-docs.md",
+      "aliases": ["myaidev-method:docs", "docs"]
+    },
+    "sc:security-setup": {
+      "source": "../src/templates/claude/commands/sc:security-setup.md",
+      "aliases": ["myaidev-method:security-setup", "security-setup"]
+    },
+    "sc:security-recon": {
+      "source": "../src/templates/claude/commands/sc:security-recon.md",
+      "aliases": ["myaidev-method:security-recon", "security-recon"]
+    },
+    "sc:security-scan": {
+      "source": "../src/templates/claude/commands/sc:security-scan.md",
+      "aliases": ["myaidev-method:security-scan", "security-scan"]
+    },
+    "sc:security-exploit": {
+      "source": "../src/templates/claude/commands/sc:security-exploit.md",
+      "aliases": ["myaidev-method:security-exploit", "security-exploit"]
+    },
+    "sc:security-report": {
+      "source": "../src/templates/claude/commands/sc:security-report.md",
+      "aliases": ["myaidev-method:security-report", "security-report"]
+    }
+  },
+  "agents": "../src/templates/claude/agents/",
+  "hooks": "../hooks/hooks.json",
+  "mcpServers": {
+    "myaidev-wordpress": {
+      "name": "myaidev-wordpress-mcp-server",
+      "command": "node",
+      "args": [".claude/mcp/wordpress-server.js"],
+      "env": {
+        "WORDPRESS_URL": "${WORDPRESS_URL}",
+        "WORDPRESS_USERNAME": "${WORDPRESS_USERNAME}",
+        "WORDPRESS_APP_PASSWORD": "${WORDPRESS_APP_PASSWORD}"
+      },
+      "description": "WordPress publishing and management operations"
+    },
+    "myaidev-sparc": {
+      "name": "myaidev-sparc-orchestrator",
+      "command": "node",
+      "args": [".claude/mcp/sparc-orchestrator-server.js"],
+      "description": "SPARC methodology workflow orchestration"
+    },
+    "myaidev-openstack": {
+      "name": "myaidev-openstack-mcp-server",
+      "command": "node",
+      "args": [".claude/mcp/openstack-server.js"],
+      "env": {
+        "OS_AUTH_URL": "${OS_AUTH_URL}",
+        "OS_USERNAME": "${OS_USERNAME}",
+        "OS_PASSWORD": "${OS_PASSWORD}",
+        "OS_PROJECT_NAME": "${OS_PROJECT_NAME}"
+      },
+      "description": "OpenStack VM management operations"
+    }
+  },
+  "envVars": {
+    "required": [],
+    "optional": [
+      {
+        "name": "WORDPRESS_URL",
+        "description": "WordPress site URL",
+        "workflow": "content"
+      },
+      {
+        "name": "WORDPRESS_USERNAME",
+        "description": "WordPress username",
+        "workflow": "content"
+      },
+      {
+        "name": "WORDPRESS_APP_PASSWORD",
+        "description": "WordPress application password",
+        "workflow": "content"
+      },
+      {
+        "name": "GOOGLE_API_KEY",
+        "description": "Google AI API key for Gemini/Imagen/Veo",
+        "workflow": "visual"
+      },
+      {
+        "name": "OPENAI_API_KEY",
+        "description": "OpenAI API key for DALL-E/GPT",
+        "workflow": "visual"
+      },
+      {
+        "name": "FAL_KEY",
+        "description": "FAL.ai API key for FLUX",
+        "workflow": "visual"
+      },
+      {
+        "name": "COOLIFY_API_KEY",
+        "description": "Coolify API key",
+        "workflow": "deployment"
+      },
+      {
+        "name": "COOLIFY_URL",
+        "description": "Coolify server URL",
+        "workflow": "deployment"
+      },
+      {
+        "name": "OS_AUTH_URL",
+        "description": "OpenStack authentication URL",
+        "workflow": "openstack"
+      },
+      {
+        "name": "OS_USERNAME",
+        "description": "OpenStack username",
+        "workflow": "openstack"
+      },
+      {
+        "name": "OS_PASSWORD",
+        "description": "OpenStack password",
+        "workflow": "openstack"
+      },
+      {
+        "name": "OS_PROJECT_NAME",
+        "description": "OpenStack project name",
+        "workflow": "openstack"
+      }
+    ]
+  },
+  "skillPacks": {
+    "content": {
+      "description": "Content creation and publishing workflow",
+      "skills": ["content-writer", "content-verifier", "wordpress-publisher"],
+      "commands": ["myai-content-writer", "myai-wordpress-publish", "myai-coordinate-content"]
+    },
+    "visual": {
+      "description": "AI image and video generation",
+      "skills": ["visual-generator"],
+      "commands": ["myai-generate-visual"]
+    },
+    "development": {
+      "description": "SPARC methodology for software development",
+      "skills": ["sparc-architect", "sparc-coder", "sparc-tester", "sparc-reviewer", "sparc-documenter"],
+      "commands": ["myai-sparc-workflow", "myai-dev-architect", "myai-dev-code", "myai-dev-test", "myai-dev-review", "myai-dev-docs"]
+    },
+    "publishing": {
+      "description": "Multi-platform publishing support",
+      "skills": ["wordpress-publisher", "payloadcms-publisher", "static-site-publisher"],
+      "commands": ["myai-wordpress-publish", "myai-payloadcms-publish", "myai-docusaurus-publish", "myai-mintlify-publish", "myai-astro-publish"]
+    },
+    "deployment": {
+      "description": "Application deployment automation",
+      "skills": ["coolify-deployer"],
+      "commands": ["myai-coolify-deploy"]
+    },
+    "security": {
+      "description": "Security testing and auditing",
+      "skills": ["security-tester", "security-auditor", "webapp-tester"],
+      "commands": ["sc:security-setup", "sc:security-recon", "sc:security-scan", "sc:security-exploit", "sc:security-report"]
+    },
+    "openstack": {
+      "description": "OpenStack VM management",
+      "skills": ["openstack-manager"],
+      "commands": ["myai-openstack"]
+    }
+  },
+  "backwardCompatibility": {
+    "legacyCommands": true,
+    "npxInstallation": true,
+    "manifestTracking": true
+  }
+}

package/.env.example

@@ -1,29 +1,54 @@
+# ═══════════════════════════════════════════════════════
+# Content Rules Configuration
+# ═══════════════════════════════════════════════════════
+# Path to your content-rules.md file (auto-detected if not set)
+# Run '/myai-configure content-rules' to create one
+CONTENT_RULES_PATH=./content-rules.md
+
+# ═══════════════════════════════════════════════════════
 # WordPress Configuration
+# ═══════════════════════════════════════════════════════
 WORDPRESS_URL=https://your-wordpress-site.com
 WORDPRESS_USERNAME=your-username
 WORDPRESS_APP_PASSWORD=your-application-password
 
+# Optional: WordPress SSH for advanced administration
+WORDPRESS_SSH_HOST=
+WORDPRESS_SSH_USER=
+WORDPRESS_SSH_KEY_PATH=
+
+# ═══════════════════════════════════════════════════════
 # PayloadCMS Configuration
+# ═══════════════════════════════════════════════════════
 PAYLOADCMS_URL=https://your-payloadcms-site.com
 PAYLOADCMS_EMAIL=your-email@example.com
 PAYLOADCMS_PASSWORD=your-password
 
-# Coolify Configuration
+# ═══════════════════════════════════════════════════════
+# Coolify Deployment Configuration
+# ═══════════════════════════════════════════════════════
 COOLIFY_URL=https://your-coolify-instance.com
 COOLIFY_API_KEY=your-coolify-api-key
 
-# Git Configuration (for static site publishing)
+# ═══════════════════════════════════════════════════════
+# Git Configuration (for commits and static site publishing)
+# ═══════════════════════════════════════════════════════
 GIT_USER_NAME=Your Name
 GIT_USER_EMAIL=your-email@example.com
 GIT_REMOTE_URL=origin
 
-# Static Site Project Paths (optional, defaults to current directory)
+# ═══════════════════════════════════════════════════════
+# Static Site Project Paths
+# ═══════════════════════════════════════════════════════
+# Paths to your static site generator projects
 DOCUSAURUS_PROJECT_PATH=./path-to-docusaurus-project
 MINTLIFY_PROJECT_PATH=./path-to-mintlify-project
 ASTRO_PROJECT_PATH=./path-to-astro-project
 
-# Optional: Default content settings
-DEFAULT_WORD_COUNT=800
+# ═══════════════════════════════════════════════════════
+# Default Content Settings
+# ═══════════════════════════════════════════════════════
+DEFAULT_WORD_COUNT=1500
 DEFAULT_POST_STATUS=draft
 DEFAULT_TONE=professional
 
@@ -66,3 +91,44 @@ VISUAL_ASSETS_PATH=./content-assets # Where to save generated files
 VISUAL_DAILY_BUDGET=5.00            # Max USD per day
 VISUAL_MONTHLY_BUDGET=50.00         # Max USD per month
 VISUAL_WARN_THRESHOLD=0.80          # Warn at 80% budget usage
+
+# ═══════════════════════════════════════════════════════
+# Security Tools Configuration (Kali Linux Docker)
+# ═══════════════════════════════════════════════════════
+# ⚠️  ONLY RELEVANT if you've installed a security workflow:
+#     npx myaidev-method install security-pentest
+#     npx myaidev-method install security-audit
+#     npx myaidev-method install security-webapp
+#
+# If you only installed 'content' workflow, ignore this section.
+#
+# Run '/myai-configure security' for interactive setup
+# Requires Docker to be installed on your system
+
+# Container Settings
+KALI_CONTAINER_NAME=kali-security
+KALI_IMAGE=kalilinux/kali-rolling
+
+# Network Mode: host|bridge|none
+# host = Full network access (recommended for pentesting)
+# bridge = Isolated with port mapping
+# none = No network (offline analysis)
+KALI_NETWORK_MODE=host
+
+# Ports to expose (only used with bridge mode)
+# Comma-separated list, e.g., 8080,4444,443
+KALI_PORTS=
+
+# Volume Mounts (host paths)
+KALI_TOOLS_PATH=./security-tools      # Custom scripts and tools
+KALI_RESULTS_PATH=./security-results  # Scan outputs and reports
+KALI_WORDLISTS_PATH=                  # Optional: Custom wordlists
+
+# Tool Packages (space-separated list)
+# Options: kali-linux-headless, kali-tools-web, kali-tools-exploitation,
+#          kali-tools-forensics, kali-tools-passwords, kali-tools-wireless,
+#          kali-tools-sniffing, or specific tools like nmap,burpsuite
+KALI_PACKAGES=kali-linux-headless
+
+# Auto-start container on system boot
+KALI_AUTOSTART=false

package/PLUGIN_ARCHITECTURE.md

@@ -0,0 +1,276 @@
+# MyAIDev Method: Plugin Architecture
+
+This document describes the plugin-based architecture of MyAIDev Method, which enables:
+- Claude Code plugin marketplace distribution
+- SKILLS.md format for discoverable capabilities
+- Cross-platform compatibility (Gemini CLI, Codex/OpenCode)
+- Self-hosted plugin distribution
+- 100% backward compatibility with existing npx installation
+
+## Installation Methods
+
+### Method 1: Legacy NPX Installation (Still Works)
+
+The traditional installation method via npm/npx continues to work exactly as before:
+
+```bash
+# Full installation
+npx myaidev-method init --claude
+
+# Workflow-specific installation
+npx myaidev-method content --claude
+npx myaidev-method visual --claude
+npx myaidev-method develop --claude
+npx myaidev-method security --claude
+```
+
+### Method 2: Plugin Installation (New)
+
+When Claude Code plugin marketplace becomes available:
+
+```bash
+# Add marketplace (one-time)
+/plugin marketplace add myaione/myaidev-method
+
+# Install full framework
+/plugin install myaidev-method@myaidev-marketplace
+
+# Or install specific packs
+/plugin install myaidev-content@myaidev-marketplace
+/plugin install myaidev-security@myaidev-marketplace
+```
+
+### Method 3: Local Plugin Installation
+
+For development or custom installations:
+
+```bash
+# Clone repository
+git clone https://github.com/myaione/myaidev-method.git
+
+# Install as local plugin
+/plugin install ./myaidev-method
+```
+
+## Command Naming
+
+Both legacy and namespaced commands work:
+
+| Legacy Command | Namespaced Command | Description |
+|---------------|-------------------|-------------|
+| `/myai-content-writer` | `/myaidev-method:content-writer` | Content creation |
+| `/myai-configure` | `/myaidev-method:configure` | Configuration |
+| `/myai-wordpress-publish` | `/myaidev-method:wordpress-publish` | WordPress publishing |
+| `/myai-generate-visual` | `/myaidev-method:generate-visual` | Visual generation |
+
+## Directory Structure
+
+```
+myaidev-method/
+├── .claude-plugin/
+│   └── plugin.json              # Plugin manifest
+│
+├── skills/                      # SKILL.md files (at root)
+│   ├── content-writer/
+│   │   └── SKILL.md
+│   ├── visual-generator/
+│   │   └── SKILL.md
+│   ├── wordpress-publisher/
+│   │   └── SKILL.md
+│   ├── sparc-architect/
+│   │   └── SKILL.md
+│   ├── sparc-coder/
+│   │   └── SKILL.md
+│   ├── sparc-tester/
+│   │   └── SKILL.md
+│   ├── sparc-reviewer/
+│   │   └── SKILL.md
+│   ├── sparc-documenter/
+│   │   └── SKILL.md
+│   ├── security-tester/
+│   │   └── SKILL.md
+│   ├── security-auditor/
+│   │   └── SKILL.md
+│   ├── content-verifier/
+│   │   └── SKILL.md
+│   ├── coolify-deployer/
+│   │   └── SKILL.md
+│   └── openstack-manager/
+│       └── SKILL.md
+│
+├── commands -> src/templates/claude/commands  # Symlink
+├── agents -> src/templates/claude/agents      # Symlink
+│
+├── hooks/
+│   └── hooks.json               # Lifecycle hooks
+│
+├── platforms/                   # Cross-platform builds
+│   ├── gemini/
+│   └── codex/
+│
+├── src/                         # Source code (kept for npx)
+│   ├── templates/claude/
+│   │   ├── commands/*.md
+│   │   └── agents/*.md
+│   ├── config/workflows.js
+│   └── lib/*.js
+│
+├── extension.json               # Cross-platform metadata
+├── marketplace.json             # Plugin marketplace registry
+└── package.json
+```
+
+## SKILL.md Format
+
+Skills are defined using a markdown format with YAML frontmatter:
+
+```markdown
+---
+name: content-writer
+description: Professional SEO-optimized content creation
+argument-hint: [topic] [--word-count=1500] [--tone=professional]
+allowed-tools: [Read, Write, Edit, WebSearch, WebFetch, Task]
+user-invocable: true
+category: content
+version: 1.0.0
+platforms: [claude-code, gemini-cli, codex-cli]
+---
+
+# Content Writer Skill
+
+[Skill description and instructions...]
+```
+
+## Skill Packs
+
+Skills are organized into packs for modular installation:
+
+| Pack | Skills | Description |
+|------|--------|-------------|
+| **content** | content-writer, content-verifier, visual-generator, wordpress-publisher | Content creation and publishing |
+| **development** | sparc-architect, sparc-coder, sparc-tester, sparc-reviewer, sparc-documenter | SPARC methodology |
+| **security** | security-tester, security-auditor | Security testing and auditing |
+| **infrastructure** | coolify-deployer, openstack-manager | Deployment and cloud management |
+
+## Cross-Platform Support
+
+MyAIDev Method supports multiple AI CLI platforms:
+
+### Claude Code (Primary)
+- Full feature support
+- MCP server integration
+- Skills and agents
+- Hooks and lifecycle events
+
+### Gemini CLI
+- Commands converted to TOML format
+- Skills supported
+- MCP servers require additional configuration
+
+### Codex CLI / OpenCode
+- Markdown command format
+- Skills supported
+- Some features may have limited support
+
+### Building for Platforms
+
+```bash
+# Build all platforms
+npm run build:platforms
+
+# Build specific platform
+npm run build:claude
+npm run build:gemini
+npm run build:codex
+```
+
+## Plugin Manifest (plugin.json)
+
+The plugin manifest at `.claude-plugin/plugin.json` defines:
+
+```json
+{
+  "name": "myaidev-method",
+  "version": "1.0.0",
+  "description": "...",
+  "skills": "../skills/",
+  "commands": { ... },
+  "agents": "../src/templates/claude/agents/",
+  "hooks": "../hooks/hooks.json",
+  "mcpServers": { ... },
+  "skillPacks": { ... }
+}
+```
+
+## Hooks
+
+Lifecycle hooks in `hooks/hooks.json` enable automated actions:
+
+- `pre-command` / `post-command`: Before/after command execution
+- `pre-content-publish` / `post-content-publish`: Content publishing lifecycle
+- `pre-visual-generate` / `post-visual-generate`: Visual generation lifecycle
+- `pre-deploy` / `post-deploy`: Deployment lifecycle
+- `session-start` / `session-end`: Session lifecycle
+
+## Installation Detection
+
+The CLI can detect installation state:
+
+```bash
+# Detect installation type
+npx myaidev-method detect
+
+# Show plugin information
+npx myaidev-method plugin-info
+
+# Upgrade from legacy to plugin
+npx myaidev-method upgrade
+```
+
+## Backward Compatibility Guarantees
+
+- ✅ `npx myaidev-method init --claude` - Works exactly as before
+- ✅ `npx myaidev-method content --claude` - Works exactly as before
+- ✅ All `/myai-*` commands - Same names, same behavior
+- ✅ All agents in `.claude/agents/` - Same names, same behavior
+- ✅ Existing user installations - Not affected
+
+## Migration Path
+
+### For Existing Users
+
+Your existing installation continues to work. To enable plugin features:
+
+```bash
+# Check current installation
+npx myaidev-method detect
+
+# Upgrade to plugin architecture
+npx myaidev-method upgrade
+
+# Both legacy and namespaced commands now work
+/myai-content-writer "Test"           # Legacy
+/myaidev-method:content-writer "Test" # Namespaced
+```
+
+### For New Users
+
+Choose your preferred installation method:
+
+1. **Quick Start (NPX)**: `npx myaidev-method content --claude`
+2. **Plugin (When Available)**: `/plugin install myaidev-method`
+
+## Distribution Channels
+
+MyAIDev Method is available through:
+
+1. **NPM**: `npm install myaidev-method` or `npx myaidev-method`
+2. **GitHub**: https://github.com/myaione/myaidev-method
+3. **Plugin Marketplace**: myaidev-marketplace (when available)
+4. **Website**: https://dev.myai1.ai/plugins/myaidev-method
+
+## Support
+
+- **Documentation**: https://github.com/myaione/myaidev-method#readme
+- **Issues**: https://github.com/myaione/myaidev-method/issues
+- **Email**: support@openmy.ai