myaidev-method 0.2.4 → 0.2.6

package/USER_GUIDE.md

@@ -8,6 +8,9 @@ This guide covers everything you need to know about using, customizing, and exte
 
 - [Quick Start](#quick-start)
 - [Understanding the Structure](#understanding-the-structure)
+- [SPARC Development Workflow](#sparc-development-workflow)
+- [Git & CI/CD Workflows](#git--cicd-workflows)
+- [Multi-Platform Support](#multi-platform-support)
 - [Customizing Agents](#customizing-agents)
 - [Managing Commands](#managing-commands)
 - [WordPress Integration](#wordpress-integration)
@@ -19,12 +22,35 @@ This guide covers everything you need to know about using, customizing, and exte
 
 ## 🚀 Quick Start
 
-After installing with `npx myaidev-method init --claude`, you'll have a `.claude` folder in your project:
+After installing with `npx myaidev-method@latest init --claude`, you'll see the MyAIDev Method banner and SPARC methodology breakdown:
+
+```
+███╗   ███╗██╗   ██╗ █████╗ ██╗██████╗ ███████╗██╗   ██╗
+████╗ ████║╚██╗ ██╔╝██╔══██╗██║██╔══██╗██╔════╝██║   ██║
+...
+           ███╗   ███╗███████╗████████╗██╗  ██╗Օ   ██████╗  ██████╗
+...
+
+╔══════════════════════════════════════════════════════════════════════════╗
+║  SPARC Methodology - Systematic Software Development Framework         ║
+╚══════════════════════════════════════════════════════════════════════════╝
+
+  S │ 📋 Specification
+      Define requirements and system boundaries
+      → Clear goals, constraints, and success criteria
+
+  P │ 🔄 Pseudocode
+      Plan implementation approach
+      → Algorithm design and logic flow
+...
+```
+
+You'll have a `.claude` folder in your project:
 
 ```
 .claude/
-├── commands/           # Slash commands
-├── agents/            # AI agent definitions
+├── commands/           # Slash commands (22 total)
+├── agents/            # AI agent definitions (7 total)
 ├── mcp/              # MCP integrations
 └── CLAUDE.md         # Project configuration
 ```
@@ -32,9 +58,16 @@ After installing with `npx myaidev-method init --claude`, you'll have a `.claude
 ### Immediate Usage
 
 ```bash
+# SPARC Development Workflow
+/myai-sparc-workflow "Build user authentication system"
+
 # Create professional content
 /myai-content-writer "10 Best Remote Work Tips"
 
+# Git & CI/CD
+/myai-git-pr "Add authentication feature"
+/myai-deploy-staging
+
 # WordPress administration
 /myai-wordpress-admin health-check
 
@@ -46,17 +79,50 @@ After installing with `npx myaidev-method init --claude`, you'll have a `.claude
 
 ### Commands Directory (`.claude/commands/`)
 
-Contains slash commands that appear in your Claude Code interface:
-
-- `myai-content-writer.md` - Content creation command
-- `myai-wordpress-admin.md` - WordPress administration
+Contains 22 slash commands that appear in your Claude Code interface:
+
+**SPARC Development:**
+- `myai-sparc-workflow.md` - Complete 5-phase SPARC workflow
+- `myai-dev-architect.md` - Architecture design phase
+- `myai-dev-code.md` - Implementation phase
+- `myai-dev-test.md` - Testing phase
+- `myai-dev-review.md` - Code review phase
+- `myai-dev-docs.md` - Documentation phase
+
+**Git & CI/CD:**
+- `myai-git-pr.md` - Create and manage Pull Requests
+- `myai-git-release.md` - Semantic versioning and releases
+- `myai-git-sync.md` - Branch synchronization
+- `myai-git-hotfix.md` - Emergency hotfix procedures
+- `myai-deploy-dev.md` - Development environment deployment
+- `myai-deploy-staging.md` - Staging environment deployment
+- `myai-deploy-prod.md` - Production deployment (blue-green, canary, rolling)
+
+**Content & Publishing:**
+- `myai-content-writer.md` - Content creation
 - `myai-wordpress-publish.md` - WordPress publishing
+- `myai-wordpress-admin.md` - WordPress administration
+- `myai-payloadcms-publish.md` - PayloadCMS publishing
+- `myai-docusaurus-publish.md` - Docusaurus documentation
+- `myai-mintlify-publish.md` - Mintlify documentation
+- `myai-astro-publish.md` - Astro site publishing
+
+**Infrastructure:**
+- `myai-coolify-deploy.md` - Coolify deployment automation
 - `myai-configure.md` - Configuration management
 
 ### Agents Directory (`.claude/agents/`)
 
-Contains AI agent definitions with specialized prompts:
+Contains 7 AI agent definitions with specialized prompts:
 
+**Development Agents:**
+- `architect.md` - System architecture and design specialist
+- `coder.md` - Implementation and coding expert
+- `tester.md` - Testing and quality assurance specialist
+- `reviewer.md` - Code review and quality analysis
+- `documenter.md` - Technical documentation specialist
+
+**Content Agents:**
 - `content-writer.md` - Professional content creator
 - `wordpress-admin.md` - WordPress administrator
 
@@ -74,6 +140,321 @@ tools: Read, Write, Edit, WebSearch, WebFetch, Task
 # Agent prompt content goes here...
 ```
 
+## 🏗️ SPARC Development Workflow
+
+The SPARC methodology provides a systematic approach to software development with 5 phases:
+
+**S**pecification → **P**seudocode → **A**rchitecture → **R**efinement → **C**ompletion
+
+### Complete SPARC Workflow
+
+Run the entire 5-phase workflow:
+
+```bash
+/myai-sparc-workflow "Build user authentication with JWT and OAuth"
+```
+
+This executes all phases sequentially:
+1. **Specification** - Requirements analysis and system boundaries
+2. **Pseudocode** - Algorithm design and logic planning
+3. **Architecture** - System structure, APIs, and data models
+4. **Refinement** - Implementation with SOLID principles and testing
+5. **Completion** - Documentation and deployment preparation
+
+### Individual Phase Commands
+
+For more control, run phases individually:
+
+```bash
+# Phase 1: Architecture Design
+/myai-dev-architect "Design microservices architecture for e-commerce platform"
+
+# Phase 2: Implementation
+/myai-dev-code "Implement user authentication service"
+
+# Phase 3: Testing
+/myai-dev-test "Create comprehensive test suite with 80%+ coverage"
+
+# Phase 4: Code Review
+/myai-dev-review "Review authentication implementation for security"
+
+# Phase 5: Documentation
+/myai-dev-docs "Generate API documentation and user guides"
+```
+
+### SPARC Quality Standards
+
+All phases adhere to these standards:
+
+- **SOLID Principles**: Single Responsibility, Open/Closed, Liskov Substitution, Interface Segregation, Dependency Inversion
+- **Clean Code**: DRY (Don't Repeat Yourself), KISS (Keep It Simple), YAGNI (You Aren't Gonna Need It)
+- **Security**: OWASP Top 10 compliance
+- **Testing**: 80%+ critical path coverage, 60%+ overall coverage
+- **Performance**: <200ms API responses, <50ms database queries
+
+### SPARC Output Structure
+
+All phases output to `.myaidev-method/sparc/` directory:
+
+```
+.myaidev-method/sparc/
+├── architecture.md          # Phase 1: System design
+├── pseudocode/             # Phase 2: Algorithm plans
+├── code-output/            # Phase 4: Implementation
+├── test-results/           # Phase 3: Test suites
+├── review-report.md        # Phase 4: Quality analysis
+└── documentation/          # Phase 5: API docs & guides
+```
+
+## 🔄 Git & CI/CD Workflows
+
+Complete Git operations and deployment automation commands:
+
+### Pull Request Workflow
+
+Create professional pull requests with GitHub CLI integration:
+
+```bash
+# Create PR from current branch
+/myai-git-pr "Add user authentication feature"
+
+# The command will:
+# - Analyze all commits since branch diverged
+# - Generate comprehensive PR description
+# - Create PR with gh CLI
+# - Include testing checklist and deployment notes
+```
+
+**PR Description Template includes:**
+- Summary of changes
+- Type of change (feature/fix/breaking)
+- Testing checklist
+- Code review checklist
+- Related issues
+- Screenshots (if applicable)
+- Deployment notes
+
+### Branch Synchronization
+
+Keep your branches in sync across the development workflow:
+
+```bash
+# Sync all branches
+/myai-git-sync
+
+# Features:
+# - Status overview of all branches
+# - Sync dev → staging → production
+# - Conflict resolution helper
+# - Branch cleanup (merged branches)
+```
+
+### Release Management
+
+Automated semantic versioning and changelog generation:
+
+```bash
+# Create new release
+/myai-git-release
+
+# Automatically:
+# - Determines version bump (major/minor/patch)
+# - Generates changelog from conventional commits
+# - Creates GitHub release
+# - Uploads assets with checksums
+# - Publishes to npm (if configured)
+```
+
+**Version Bump Detection:**
+- `BREAKING CHANGE` → major version (1.0.0 → 2.0.0)
+- `feat:` commits → minor version (1.0.0 → 1.1.0)
+- `fix:` commits → patch version (1.0.0 → 1.0.1)
+
+### Emergency Hotfix Procedures
+
+Fast-track critical bug fixes to production:
+
+```bash
+# Emergency hotfix workflow
+/myai-git-hotfix
+
+# Includes:
+# - Emergency assessment & incident tracking
+# - Multiple fix application methods
+# - Fast-track testing
+# - Emergency approval gate
+# - Post-mortem report generation
+```
+
+### Deployment Commands
+
+Deploy to different environments with appropriate safety levels:
+
+```bash
+# Development deployment (fast iteration)
+/myai-deploy-dev
+
+# Staging deployment (pre-production testing)
+/myai-deploy-staging
+
+# Production deployment (multiple strategies)
+/myai-deploy-prod
+```
+
+**Development Deployment:**
+- Fast deployment with hot-reload support
+- Docker, Docker Compose, or rsync methods
+- Auto-deploy via GitHub Actions
+
+**Staging Deployment:**
+- Pre-flight checks and tests
+- Coolify or Docker deployment
+- Health checks and smoke tests
+- Rollback procedures
+
+**Production Deployment:**
+- Strict approval gates and backup points
+- Multiple strategies:
+  - **Blue-Green**: Zero-downtime deployment
+  - **Canary**: Gradual rollout (10% → 50% → 100%)
+  - **Rolling**: Sequential instance updates
+- Comprehensive monitoring and rollback
+
+### Deployment Methods
+
+All deployment commands support:
+
+**Coolify API:**
+```bash
+# Configure Coolify credentials
+COOLIFY_URL=https://coolify.your-server.com
+COOLIFY_API_TOKEN=your_api_token
+COOLIFY_STAGING_APP_ID=your_app_id
+```
+
+**Docker:**
+```bash
+# Docker deployment
+DOCKER_REGISTRY=registry.your-domain.com
+STAGING_IMAGE_TAG=staging
+```
+
+**Docker Compose:**
+```bash
+# Deploy with compose
+ssh staging-server 'cd /opt/app && docker-compose up -d'
+```
+
+### CI/CD Notifications
+
+Deployment commands support notifications:
+
+```bash
+# Slack notifications
+SLACK_WEBHOOK_URL=https://hooks.slack.com/services/YOUR/WEBHOOK
+
+# Discord notifications
+DISCORD_WEBHOOK_URL=https://discord.com/api/webhooks/YOUR/WEBHOOK
+```
+
+## 🌐 Multi-Platform Support
+
+MyAIDev Method supports three AI CLI platforms with feature parity:
+
+### Claude Code (Default)
+
+Uses `.claude/` directory structure:
+
+```bash
+# Initialize for Claude Code
+npx myaidev-method@latest init --claude
+
+# Structure
+.claude/
+├── commands/           # Markdown with YAML frontmatter
+│   └── myai-*.md      # Uses $ARGUMENTS placeholder
+├── agents/
+├── mcp/
+└── CLAUDE.md
+```
+
+### Gemini CLI
+
+Uses `.gemini/` directory with TOML format:
+
+```bash
+# Initialize for Gemini CLI
+npx myaidev-method@latest init --gemini
+
+# Structure
+.gemini/
+├── commands/           # TOML format
+│   └── myai-*.toml    # Uses {{args}} placeholder
+└── README.md
+```
+
+**Gemini Command Format:**
+```toml
+prompt = """
+You are a specialist in...
+
+Task: {{args}}
+
+## Workflow
+...
+"""
+```
+
+### OpenCode (Codex)
+
+Uses `.opencode/` directory with simple Markdown:
+
+```bash
+# Initialize for OpenCode
+npx myaidev-method@latest init --opencode
+
+# Structure
+.opencode/
+├── commands/           # Simple Markdown (no frontmatter)
+│   └── myai-*.md      # Uses $ARGUMENTS placeholder
+└── README.md
+```
+
+**OpenCode Command Format:**
+```markdown
+# Command Description
+
+You are a specialist in...
+
+Task: $ARGUMENTS
+
+## Workflow
+...
+```
+
+### Platform Feature Parity
+
+All 22 commands are available on all platforms:
+- ✅ Claude Code: 22 commands + 7 agents
+- ✅ Gemini CLI: 22 commands (TOML format)
+- ✅ OpenCode: 22 commands (simple Markdown)
+
+### Switching Platforms
+
+You can initialize for multiple platforms in the same project:
+
+```bash
+# Initialize all platforms
+npx myaidev-method@latest init --claude
+npx myaidev-method@latest init --gemini
+npx myaidev-method@latest init --opencode
+
+# Result: All three directories exist
+.claude/
+.gemini/
+.opencode/
+```
+
 ## 🎨 Customizing Agents
 
 ### Method 1: Direct File Editing

package/bin/cli.js

@@ -7,13 +7,14 @@ import fs from 'fs-extra';
 import path from 'path';
 import { fileURLToPath } from 'url';
 import inquirer from 'inquirer';
+import { getASCIIBanner, getSPARCBreakdown, getInitSuccessMessage } from '../src/lib/ascii-banner.js';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 
 program
-  .version('0.2.2')
-  .description('AI CLI tools package with custom subagents and MCP integrations');
+  .version('0.2.5')
+  .description('MyAIDev Method - Comprehensive development framework with SPARC methodology');
 
 program
   .command('init')
@@ -64,8 +65,12 @@ program
       }
       
       spinner.succeed(chalk.green(`Successfully initialized ${cliType} configuration!`));
-      
-      console.log('\n' + chalk.cyan('🎉 You\'re all set! Here\'s how to get started:'));
+
+      // Display ASCII banner and SPARC methodology
+      console.log(getASCIIBanner());
+      console.log(getSPARCBreakdown());
+      console.log(getInitSuccessMessage(cliType));
+
       if (cliType === 'claude') {
         console.log(chalk.green('\n🏗️  SPARC Development Workflow (Systematic Software Development):'));
         console.log(chalk.gray('   • Complete:     /myai-sparc-workflow "Build authentication system"'));
@@ -85,8 +90,14 @@ program
         console.log(chalk.gray('   • Mintlify:     /myai-mintlify-publish "docs.mdx"'));
         console.log(chalk.gray('   • Astro:        /myai-astro-publish "post.md"'));
 
-        console.log(chalk.blue('\n🚀 Deploy applications:'));
-        console.log(chalk.gray('   • Coolify:      /myai-coolify-deploy'));
+        console.log(chalk.blue('\n🚀 Git & CI/CD Workflow:'));
+        console.log(chalk.gray('   • Pull Requests:  /myai-git-pr "Add user feature"'));
+        console.log(chalk.gray('   • Releases:       /myai-git-release'));
+        console.log(chalk.gray('   • Sync Branches:  /myai-git-sync'));
+        console.log(chalk.gray('   • Hotfixes:       /myai-git-hotfix'));
+        console.log(chalk.gray('   • Deploy Dev:     /myai-deploy-dev'));
+        console.log(chalk.gray('   • Deploy Staging: /myai-deploy-staging'));
+        console.log(chalk.gray('   • Deploy Prod:    /myai-deploy-prod'));
 
         console.log(chalk.cyan('\n⚙️  Configure platforms:'));
         console.log(chalk.gray('   • Run /myai-configure for guided setup'));
@@ -99,13 +110,11 @@ program
         console.log(chalk.gray('   • PUBLISHING_GUIDE.md - Multi-platform publishing'));
         console.log(chalk.gray('   • COOLIFY_DEPLOYMENT.md - Application deployment'));
         console.log(chalk.gray('   • WORDPRESS_ADMIN_SCRIPTS.md - WordPress utilities'));
-        console.log(chalk.gray('   • TECHNICAL_ARCHITECTURE.md - Developer guide'));
 
         console.log(chalk.magenta('\n🔧 MCP Server Integration (Optional Advanced Features):'));
         console.log(chalk.gray('   • SPARC Orchestrator: Workflow automation with MCP tools'));
         console.log(chalk.gray('   • Chrome DevTools: Browser testing and debugging'));
         console.log(chalk.gray('   • WordPress MCP: Enhanced WordPress API operations'));
-        console.log(chalk.gray('   • Add to Claude Code MCP settings to enable'));
 
         console.log(chalk.magenta('\n💡 Quick tips:'));
         console.log(chalk.gray('   • SPARC workflow: Architecture → Code → Test → Review → Docs'));
@@ -309,31 +318,157 @@ This configuration follows Claude Code's official standards for custom commands
 async function setupGemini(projectDir) {
   // Setup Gemini-specific configuration
   const geminiDir = path.join(projectDir, '.gemini');
-  await fs.ensureDir(geminiDir);
-  
-  // Add Gemini-specific files here when specifications are available
-  const geminiConfig = {
-    version: '1.0.0',
-    agents: ['content-writer'],
-    integrations: ['wordpress']
-  };
-  
-  await fs.writeJSON(path.join(geminiDir, 'config.json'), geminiConfig, { spaces: 2 });
+  const commandsDir = path.join(geminiDir, 'commands');
+  await fs.ensureDir(commandsDir);
+
+  // Copy all Gemini command files (.toml format)
+  const templateCommandsDir = path.join(__dirname, '..', 'src', 'templates', 'gemini', 'commands');
+  if (await fs.pathExists(templateCommandsDir)) {
+    const commandFiles = await fs.readdir(templateCommandsDir);
+    for (const file of commandFiles) {
+      if (file.endsWith('.toml')) {
+        await fs.copy(
+          path.join(templateCommandsDir, file),
+          path.join(commandsDir, file)
+        );
+      }
+    }
+  }
+
+  // Create Gemini README
+  const geminiReadme = `# Gemini CLI Configuration
+
+This project uses the MyAIDev Method package for AI-assisted development with Gemini.
+
+## Available Commands
+
+All commands are located in \`.gemini/commands/\` and use TOML format.
+
+### SPARC Development Workflow
+- \`/myai-sparc-workflow\` - Complete 5-phase SPARC workflow
+- \`/myai-dev-architect\` - Design system architecture
+- \`/myai-dev-code\` - Implement features with SOLID principles
+- \`/myai-dev-test\` - Create comprehensive tests
+- \`/myai-dev-review\` - Code quality and security review
+- \`/myai-dev-docs\` - Generate documentation
+
+### Git & CI/CD Workflow
+- \`/myai-git-pr\` - Create and manage GitHub Pull Requests
+- \`/myai-git-release\` - Create releases with semantic versioning
+- \`/myai-git-sync\` - Sync and manage branches
+- \`/myai-git-hotfix\` - Create and deploy emergency hotfixes
+- \`/myai-deploy-dev\` - Deploy to development environment
+- \`/myai-deploy-staging\` - Deploy to staging environment
+- \`/myai-deploy-prod\` - Deploy to production environment
+
+### Content & Publishing
+- \`/myai-content-writer\` - Create SEO-optimized content
+- \`/myai-wordpress-publish\` - Publish to WordPress
+- \`/myai-payloadcms-publish\` - Publish to PayloadCMS
+- \`/myai-docusaurus-publish\` - Publish to Docusaurus
+- \`/myai-mintlify-publish\` - Publish to Mintlify
+- \`/myai-astro-publish\` - Publish to Astro
+
+### Administration
+- \`/myai-coolify-deploy\` - Deploy to Coolify
+- \`/myai-wordpress-admin\` - WordPress administration
+- \`/myai-configure\` - Configure settings
+
+## Usage
+
+\`\`\`bash
+# Execute a command with arguments
+/myai-dev-architect "Design authentication system"
+/myai-git-pr "Add user profile feature"
+/myai-deploy-staging
+
+# Commands support the {{args}} placeholder
+\`\`\`
+
+## Documentation
+
+For full documentation, see the USER_GUIDE.md in your project root.
+`;
+
+  await fs.writeFile(path.join(geminiDir, 'README.md'), geminiReadme);
 }
 
 async function setupCodex(projectDir) {
-  // Setup Codex-specific configuration
-  const codexDir = path.join(projectDir, '.codex');
-  await fs.ensureDir(codexDir);
-  
-  // Add Codex-specific files here when specifications are available
-  const codexConfig = {
-    version: '1.0.0',
-    agents: ['content-writer'],
-    integrations: ['wordpress']
-  };
-  
-  await fs.writeJSON(path.join(codexDir, 'config.json'), codexConfig, { spaces: 2 });
+  // Setup Codex/OpenCode-specific configuration
+  const codexDir = path.join(projectDir, '.opencode');
+  const commandsDir = path.join(codexDir, 'commands');
+  await fs.ensureDir(commandsDir);
+
+  // Copy all Codex/OpenCode command files (.md format)
+  const templateCommandsDir = path.join(__dirname, '..', 'src', 'templates', 'codex', 'commands');
+  if (await fs.pathExists(templateCommandsDir)) {
+    const commandFiles = await fs.readdir(templateCommandsDir);
+    for (const file of commandFiles) {
+      if (file.endsWith('.md')) {
+        await fs.copy(
+          path.join(templateCommandsDir, file),
+          path.join(commandsDir, file)
+        );
+      }
+    }
+  }
+
+  // Create OpenCode README
+  const opencodeReadme = `# OpenCode Configuration
+
+This project uses the MyAIDev Method package for AI-assisted development with OpenCode.
+
+## Available Commands
+
+All commands are located in \`.opencode/commands/\` and use Markdown format.
+
+### SPARC Development Workflow
+- \`/myai-sparc-workflow\` - Complete 5-phase SPARC workflow
+- \`/myai-dev-architect\` - Design system architecture
+- \`/myai-dev-code\` - Implement features with SOLID principles
+- \`/myai-dev-test\` - Create comprehensive tests
+- \`/myai-dev-review\` - Code quality and security review
+- \`/myai-dev-docs\` - Generate documentation
+
+### Git & CI/CD Workflow
+- \`/myai-git-pr\` - Create and manage GitHub Pull Requests
+- \`/myai-git-release\` - Create releases with semantic versioning
+- \`/myai-git-sync\` - Sync and manage branches
+- \`/myai-git-hotfix\` - Create and deploy emergency hotfixes
+- \`/myai-deploy-dev\` - Deploy to development environment
+- \`/myai-deploy-staging\` - Deploy to staging environment
+- \`/myai-deploy-prod\` - Deploy to production environment
+
+### Content & Publishing
+- \`/myai-content-writer\` - Create SEO-optimized content
+- \`/myai-wordpress-publish\` - Publish to WordPress
+- \`/myai-payloadcms-publish\` - Publish to PayloadCMS
+- \`/myai-docusaurus-publish\` - Publish to Docusaurus
+- \`/myai-mintlify-publish\` - Publish to Mintlify
+- \`/myai-astro-publish\` - Publish to Astro
+
+### Administration
+- \`/myai-coolify-deploy\` - Deploy to Coolify
+- \`/myai-wordpress-admin\` - WordPress administration
+- \`/myai-configure\` - Configure settings
+
+## Usage
+
+\`\`\`bash
+# Execute a command with arguments
+/myai-dev-architect "Design authentication system"
+/myai-git-pr "Add user profile feature"
+/myai-deploy-staging
+
+# Commands support the $ARGUMENTS placeholder
+\`\`\`
+
+## Documentation
+
+For full documentation, see the USER_GUIDE.md in your project root.
+`;
+
+  await fs.writeFile(path.join(codexDir, 'README.md'), opencodeReadme);
 }
 
 program.parse(process.argv);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "myaidev-method",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "description": "Comprehensive development framework with SPARC methodology for AI-assisted software development, multi-platform publishing (WordPress, PayloadCMS, Astro, Docusaurus, Mintlify), and Coolify deployment",
   "mcpName": "io.github.myaione/myaidev-method",
   "main": "src/index.js",