myaidev-method 0.2.3 → 0.2.5

package/DEV_WORKFLOW_GUIDE.md

@@ -574,17 +574,17 @@ npm run dev:docs "Generate OpenAPI spec for API" --format openapi
 Execute the complete SPARC workflow with a single command:
 
 ```bash
-# CLI command
-npm run sparc "Build user authentication system with JWT and refresh tokens"
+# Slash command (in Claude Code)
+/myai-sparc-workflow "Build user authentication system with JWT and refresh tokens"
 
-# Slash command
-/myai-sparc-workflow "Create payment processing module"
+# CLI command
+npx myaidev-method sparc "Build user authentication system with JWT and refresh tokens"
 
 # With technology preferences
-npm run sparc "Build e-commerce checkout" --tech-stack "react,node,stripe,postgres"
+npx myaidev-method sparc "Build e-commerce checkout" --tech-stack "react,node,stripe,postgres"
 
 # Run specific phases only
-npm run sparc "Refactor auth module" --phases "architecture,review,documentation"
+npx myaidev-method sparc "Refactor auth module" --phases "architecture,review,documentation"
 ```
 
 ### Workflow Execution
@@ -673,13 +673,13 @@ npm run dev:docs "Create deployment guide" --type architecture
 
 ```bash
 # Run all 5 phases
-npm run sparc "Build feature X"
+npx myaidev-method sparc "Build feature X"
 
 # Run specific phases
-npm run sparc "Improve feature Y" --phases "architecture,review,documentation"
+npx myaidev-method sparc "Improve feature Y" --phases "architecture,review,documentation"
 
 # Skip specific phase (use with caution)
-npm run sparc "Build feature Z" --skip-phase testing
+npx myaidev-method sparc "Build feature Z" --skip-phase testing
 ```
 
 ## Quality Standards
@@ -797,7 +797,7 @@ This comprehensive example demonstrates building a complete blog system using Ne
 
 ```bash
 # Execute complete SPARC workflow for the entire blog system
-npm run sparc "Build Next.js blog with PayloadCMS backend, including posts collection, user authentication, and content API" --tech-stack "nextjs,payloadcms,mongodb,typescript"
+npx myaidev-method sparc "Build Next.js blog with PayloadCMS backend, including posts collection, user authentication, and content API" --tech-stack "nextjs,payloadcms,mongodb,typescript"
 ```
 
 #### Phase-by-Phase Implementation
@@ -1206,7 +1206,7 @@ npm run dev:code "Implement Next.js frontend with WordPress REST API"
 
 ```bash
 # Complete workflow
-npm run sparc "Build JWT authentication with refresh tokens and role-based access control"
+npx myaidev-method sparc "Build JWT authentication with refresh tokens and role-based access control"
 ```
 
 **Expected Outputs**:
@@ -1346,7 +1346,7 @@ The MyAIDev Method's SPARC workflow provides a comprehensive, systematic approac
 
 **Next Steps**:
 1. Initialize MyAIDev Method: `npx myaidev-method init --claude`
-2. Run your first SPARC workflow: `npm run sparc "Build your feature"`
+2. Run your first SPARC workflow: `npx myaidev-method sparc "Build your feature"`
 3. Review outputs in `.myaidev-method/sparc/`
 4. Iterate and improve based on review findings
 

package/MCP_INTEGRATION.md

@@ -234,16 +234,16 @@ The package includes convenient npm scripts for MCP servers:
 
 ```bash
 # Start SPARC Orchestrator MCP server
-npm run mcp:sparc
+npx myaidev-sparc-orchestrator
 
 # Start WordPress MCP server
-npm run mcp:start
+npx myaidev-mcp-server
 
-# Check MCP server health
-npm run mcp:health
-
-# Check MCP server status
-npm run mcp:status
+# Or use npm scripts (from package root)
+npm run mcp:sparc       # SPARC Orchestrator
+npm run mcp:start       # WordPress MCP
+npm run mcp:health      # Health check
+npm run mcp:status      # Status check
 ```
 
 ## Advanced Features

package/README.md

@@ -214,14 +214,14 @@ Phase 5: 📚 DOCUMENTATION
 Run the entire SPARC workflow with a single command:
 
 ```bash
-# Execute all 5 phases sequentially
-npm run sparc "Build user authentication system with JWT"
+# Slash command (in Claude Code)
+/myai-sparc-workflow "Build user authentication system with JWT"
 
-# Or use the slash command
-/myai-sparc-workflow "Create payment processing module"
+# CLI command
+npx myaidev-method sparc "Build user authentication system with JWT"
 
 # With technology preferences
-npm run sparc "Build e-commerce checkout" --tech-stack "react,node,stripe,postgres"
+npx myaidev-method sparc "Build e-commerce checkout" --tech-stack "react,node,stripe,postgres"
 ```
 
 ### Workflow Output Structure
@@ -272,19 +272,19 @@ This framework is inspired by [GitHub's Spec-Kit](https://github.com/github/spec
 You can also run individual phases:
 
 ```bash
-# CLI commands
-npm run dev:architect "Design real-time chat app"
-npm run dev:code "Implement WebSocket server"
-npm run dev:test "Test chat functionality" --integration
-npm run dev:review "Review chat implementation" --security
-npm run dev:docs "Document chat API"
-
 # Slash commands (in Claude Code)
-/myai-dev-architect "Design microservices architecture"
-/myai-dev-code "Implement user service" --test-driven
-/myai-dev-test "Test user service" --coverage
-/myai-dev-review "Security audit for user service"
-/myai-dev-docs "Document user service API"
+/myai-dev-architect "Design real-time chat app"
+/myai-dev-code "Implement WebSocket server"
+/myai-dev-test "Test chat functionality" --integration
+/myai-dev-review "Review chat implementation" --security
+/myai-dev-docs "Document chat API"
+
+# CLI commands
+npx myaidev-method dev:architect "Design microservices architecture"
+npx myaidev-method dev:code "Implement user service" --test-driven
+npx myaidev-method dev:test "Test user service" --coverage
+npx myaidev-method dev:review "Security audit for user service"
+npx myaidev-method dev:docs "Document user service API"
 ```
 
 ## 🤖 Development Agents

package/bin/cli.js

@@ -11,8 +11,48 @@ import inquirer from 'inquirer';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 
+// ASCII Banner with gradient
+function displayBanner() {
+  const grey = chalk.hex('#5A5A5A');
+  const lightGrey = chalk.hex('#9E9E9E');
+  const white = chalk.white;
+  const lightOrange = chalk.hex('#FF8C42');
+  const orange = chalk.hex('#FF6B35');
+  const brightOrange = chalk.hex('#FFA500');
+
+  console.log('');
+  console.log(grey('  ███╗   ███╗') + lightGrey('██╗   ██╗') + white(' █████╗ ') + lightOrange('██╗██████╗ ') + orange('███████╗') + brightOrange('██╗   ██╗'));
+  console.log(grey('  ████╗ ████║') + lightGrey('╚██╗ ██╔╝') + white('██╔══██╗') + lightOrange('██║██╔══██╗') + orange('██╔════╝') + brightOrange('██║   ██║'));
+  console.log(grey('  ██╔████╔██║') + lightGrey(' ╚████╔╝ ') + white('███████║') + lightOrange('██║██║  ██║') + orange('█████╗  ') + brightOrange('██║   ██║'));
+  console.log(grey('  ██║╚██╔╝██║') + lightGrey('  ╚██╔╝  ') + white('██╔══██║') + lightOrange('██║██║  ██║') + orange('██╔══╝  ') + brightOrange('╚██╗ ██╔╝'));
+  console.log(grey('  ██║ ╚═╝ ██║') + lightGrey('   ██║   ') + white('██║  ██║') + lightOrange('██║██████╔╝') + orange('███████╗') + brightOrange(' ╚████╔╝ '));
+  console.log(grey('  ╚═╝     ╚═╝') + lightGrey('   ╚═╝   ') + white('╚═╝  ╚═╝') + lightOrange('╚═╝╚═════╝ ') + orange('╚══════╝') + brightOrange('  ╚═══╝  '));
+  console.log('');
+  console.log(lightGrey('            ███╗   ███╗') + white('███████╗') + lightOrange('████████╗') + orange('██╗  ██╗') + brightOrange(' ██████╗ ██████╗ '));
+  console.log(lightGrey('            ████╗ ████║') + white('██╔════╝') + lightOrange('╚══██╔══╝') + orange('██║  ██║') + brightOrange('██╔═══██╗██╔══██╗'));
+  console.log(lightGrey('            ██╔████╔██║') + white('█████╗  ') + lightOrange('   ██║   ') + orange('███████║') + brightOrange('██║   ██║██║  ██║'));
+  console.log(lightGrey('            ██║╚██╔╝██║') + white('██╔══╝  ') + lightOrange('   ██║   ') + orange('██╔══██║') + brightOrange('██║   ██║██║  ██║'));
+  console.log(lightGrey('            ██║ ╚═╝ ██║') + white('███████╗') + lightOrange('   ██║   ') + orange('██║  ██║') + brightOrange('╚██████╔╝██████╔╝'));
+  console.log(lightGrey('            ╚═╝     ╚═╝') + white('╚══════╝') + lightOrange('   ╚═╝   ') + orange('╚═╝  ╚═╝') + brightOrange(' ╚═════╝ ╚═════╝ '));
+  console.log('');
+}
+
+// SPARC Methodology breakdown
+function displaySPARC() {
+  console.log(chalk.cyan.bold('  📋 SPARC Development Methodology'));
+  console.log('');
+  console.log(chalk.grey('     ┌─────────────────────────────────────────────────────────────────┐'));
+  console.log(chalk.grey('     │') + chalk.hex('#FF6B35').bold(' S ') + chalk.white('• Specification') + chalk.grey('  │ ') + chalk.gray('Define requirements & system boundaries'));
+  console.log(chalk.grey('     │') + chalk.hex('#FF8C42').bold(' P ') + chalk.white('• Pseudocode   ') + chalk.grey('  │ ') + chalk.gray('Plan implementation approach'));
+  console.log(chalk.grey('     │') + chalk.hex('#FFA500').bold(' A ') + chalk.white('• Architecture ') + chalk.grey('  │ ') + chalk.gray('Design structure, APIs, data models'));
+  console.log(chalk.grey('     │') + chalk.hex('#FFB84D').bold(' R ') + chalk.white('• Refinement   ') + chalk.grey('  │ ') + chalk.gray('Implement, test, review quality'));
+  console.log(chalk.grey('     │') + chalk.hex('#FFCC80').bold(' C ') + chalk.white('• Completion   ') + chalk.grey('  │ ') + chalk.gray('Document & deliver production code'));
+  console.log(chalk.grey('     └─────────────────────────────────────────────────────────────────┘'));
+  console.log('');
+}
+
 program
-  .version('0.2.2')
+  .version('0.2.5')
   .description('AI CLI tools package with custom subagents and MCP integrations');
 
 program
@@ -64,8 +104,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
+      displayBanner();
+      displaySPARC();
+
+      console.log(chalk.cyan('🎉 You\'re all set! Here\'s how to get started:'));
       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"'));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "myaidev-method",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "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",

package/src/scripts/dev-architect.js

@@ -7,8 +7,8 @@
  * create API specifications, and plan technology stack.
  *
  * Usage:
- *   npm run dev:architect "Design authentication system"
- *   npm run dev:architect "Create e-commerce platform" --tech-stack "node,postgres,redis"
+ *   npx myaidev-method dev:architect "Design authentication system"
+ *   npx myaidev-method dev:architect "Create e-commerce platform" --tech-stack "node,postgres,redis"
  */
 
 import { SparcWorkflow } from '../lib/dev-workflow/sparc-workflow.js';
@@ -22,8 +22,8 @@ async function main() {
 🏗️  MyAIDev Method - Architecture Design
 
 Usage:
-  npm run dev:architect "Design authentication system"
-  npm run dev:architect "Create API endpoints" --tech-stack "node,express"
+  npx myaidev-method dev:architect "Design authentication system"
+  npx myaidev-method dev:architect "Create API endpoints" --tech-stack "node,express"
 
 Options:
   --tech-stack <stack>    Preferred technology stack (comma-separated)
@@ -32,16 +32,16 @@ Options:
   --help, -h              Show this help message
 
 Examples:
-  npm run dev:architect "Design real-time chat app"
-  npm run dev:architect "Review current architecture" --existing-code
-  npm run dev:architect "Design microservices" --tech-stack "node,kubernetes,mongodb"
+  npx myaidev-method dev:architect "Design real-time chat app"
+  npx myaidev-method dev:architect "Review current architecture" --existing-code
+  npx myaidev-method dev:architect "Design microservices" --tech-stack "node,kubernetes,mongodb"
 
 Output:
   .myaidev-method/sparc/architecture.md
 
 Next Phase:
   After architecture is complete, run:
-  npm run dev:code "Implement [feature]"
+  npx myaidev-method dev:code "Implement [feature]"
     `);
     process.exit(0);
   }
@@ -87,7 +87,7 @@ Next Phase:
     console.log('');
     console.log('📌 Next Steps:');
     console.log('  1. Review architecture.md in .myaidev-method/sparc/');
-    console.log('  2. Run: npm run dev:code "Implement [feature]"');
+    console.log('  2. Run: npx myaidev-method dev:code "Implement [feature]"');
     console.log('');
 
   } catch (error) {

package/src/scripts/dev-code.js

@@ -7,8 +7,8 @@
  * architecture specifications using SOLID principles and best practices.
  *
  * Usage:
- *   npm run dev:code "Implement user authentication"
- *   npm run dev:code "Build payment processing" --test-driven
+ *   npx myaidev-method dev:code "Implement user authentication"
+ *   npx myaidev-method dev:code "Build payment processing" --test-driven
  */
 
 import { SparcWorkflow } from '../lib/dev-workflow/sparc-workflow.js';
@@ -22,8 +22,8 @@ async function main() {
 💻 MyAIDev Method - Code Implementation
 
 Usage:
-  npm run dev:code "Implement authentication"
-  npm run dev:code "Build API endpoints" --test-driven
+  npx myaidev-method dev:code "Implement authentication"
+  npx myaidev-method dev:code "Build API endpoints" --test-driven
 
 Options:
   --architecture <file>   Path to architecture spec (default: .myaidev-method/sparc/architecture.md)
@@ -32,9 +32,9 @@ Options:
   --help, -h             Show this help message
 
 Examples:
-  npm run dev:code "Implement JWT authentication"
-  npm run dev:code "Create REST API for users" --test-driven
-  npm run dev:code "Refactor database queries" --architecture custom-arch.md
+  npx myaidev-method dev:code "Implement JWT authentication"
+  npx myaidev-method dev:code "Create REST API for users" --test-driven
+  npx myaidev-method dev:code "Refactor database queries" --architecture custom-arch.md
 
 Code Quality Standards:
   - SOLID Principles (Single Responsibility, DRY, KISS)
@@ -48,7 +48,7 @@ Output:
 
 Next Phase:
   After implementation, run:
-  npm run dev:test "Test [feature]"
+  npx myaidev-method dev:test "Test [feature]"
     `);
     process.exit(0);
   }
@@ -94,7 +94,7 @@ Next Phase:
     console.log('');
     console.log('📌 Next Steps:');
     console.log('  1. Review code in .myaidev-method/sparc/code-output/');
-    console.log('  2. Run: npm run dev:test "Test [feature]"');
+    console.log('  2. Run: npx myaidev-method dev:test "Test [feature]"');
     console.log('');
 
   } catch (error) {

package/src/scripts/dev-docs.js

@@ -7,8 +7,8 @@
  * API documentation, user guides, and technical specifications.
  *
  * Usage:
- *   npm run dev:docs "Document authentication API"
- *   npm run dev:docs "Create user guide" --type user-guide
+ *   npx myaidev-method dev:docs "Document authentication API"
+ *   npx myaidev-method dev:docs "Create user guide" --type user-guide
  */
 
 import { SparcWorkflow } from '../lib/dev-workflow/sparc-workflow.js';
@@ -22,8 +22,8 @@ async function main() {
 📚 MyAIDev Method - Documentation
 
 Usage:
-  npm run dev:docs "Document authentication API"
-  npm run dev:docs "Create user guide" --type user-guide --format html
+  npx myaidev-method dev:docs "Document authentication API"
+  npx myaidev-method dev:docs "Create user guide" --type user-guide --format html
 
 Options:
   --type <type>         Documentation type: api, user-guide, architecture, technical
@@ -32,10 +32,10 @@ Options:
   --help, -h            Show this help message
 
 Examples:
-  npm run dev:docs "Document REST API endpoints"
-  npm run dev:docs "Create user guide for checkout flow" --type user-guide
-  npm run dev:docs "Generate OpenAPI spec" --format openapi
-  npm run dev:docs "Document system architecture" --type architecture
+  npx myaidev-method dev:docs "Document REST API endpoints"
+  npx myaidev-method dev:docs "Create user guide for checkout flow" --type user-guide
+  npx myaidev-method dev:docs "Generate OpenAPI spec" --format openapi
+  npx myaidev-method dev:docs "Document system architecture" --type architecture
 
 Documentation Standards:
   - Clarity: Simple language, clear examples, visual aids

package/src/scripts/dev-review.js

@@ -7,8 +7,8 @@
  * performance, and best practices compliance.
  *
  * Usage:
- *   npm run dev:review "Review authentication module"
- *   npm run dev:review "Security audit for payments" --security
+ *   npx myaidev-method dev:review "Review authentication module"
+ *   npx myaidev-method dev:review "Security audit for payments" --security
  */
 
 import { SparcWorkflow } from '../lib/dev-workflow/sparc-workflow.js';
@@ -22,8 +22,8 @@ async function main() {
 👁️  MyAIDev Method - Code Review
 
 Usage:
-  npm run dev:review "Review authentication"
-  npm run dev:review "Audit payment module" --security --performance
+  npx myaidev-method dev:review "Review authentication"
+  npx myaidev-method dev:review "Audit payment module" --security --performance
 
 Options:
   --security            Focus on security analysis (OWASP Top 10)
@@ -32,9 +32,9 @@ Options:
   --help, -h            Show this help message
 
 Examples:
-  npm run dev:review "Review user authentication module"
-  npm run dev:review "Security audit for payment processing" --security
-  npm run dev:review "Performance review of database queries" --performance
+  npx myaidev-method dev:review "Review user authentication module"
+  npx myaidev-method dev:review "Security audit for payment processing" --security
+  npx myaidev-method dev:review "Performance review of database queries" --performance
 
 Review Standards:
   - Code Quality: Complexity, readability, maintainability
@@ -48,7 +48,7 @@ Output:
 
 Next Phase:
   After review, run:
-  npm run dev:docs "Document [feature]"
+  npx myaidev-method dev:docs "Document [feature]"
     `);
     process.exit(0);
   }
@@ -105,7 +105,7 @@ Next Phase:
     console.log('📌 Next Steps:');
     console.log('  1. Review report in .myaidev-method/sparc/review-report.md');
     console.log('  2. Address critical and high-priority issues');
-    console.log('  3. Run: npm run dev:docs "Document [feature]"');
+    console.log('  3. Run: npx myaidev-method dev:docs "Document [feature]"');
     console.log('');
 
   } catch (error) {

package/src/scripts/dev-test.js

@@ -7,8 +7,8 @@
  * generate coverage reports, and validate quality gates.
  *
  * Usage:
- *   npm run dev:test "Test authentication system"
- *   npm run dev:test "Integration tests for checkout" --integration
+ *   npx myaidev-method dev:test "Test authentication system"
+ *   npx myaidev-method dev:test "Integration tests for checkout" --integration
  */
 
 import { SparcWorkflow } from '../lib/dev-workflow/sparc-workflow.js';
@@ -22,8 +22,8 @@ async function main() {
 🧪 MyAIDev Method - Testing
 
 Usage:
-  npm run dev:test "Test authentication"
-  npm run dev:test "Test checkout flow" --integration --coverage
+  npx myaidev-method dev:test "Test authentication"
+  npx myaidev-method dev:test "Test checkout flow" --integration --coverage
 
 Options:
   --coverage            Generate coverage report
@@ -33,9 +33,9 @@ Options:
   --help, -h            Show this help message
 
 Examples:
-  npm run dev:test "Test user authentication"
-  npm run dev:test "Integration tests for API" --integration --coverage
-  npm run dev:test "Test payment module" --framework jest
+  npx myaidev-method dev:test "Test user authentication"
+  npx myaidev-method dev:test "Integration tests for API" --integration --coverage
+  npx myaidev-method dev:test "Test payment module" --framework jest
 
 Testing Standards:
   - 80%+ coverage for critical paths
@@ -49,7 +49,7 @@ Output:
 
 Next Phase:
   After testing, run:
-  npm run dev:review "Review [feature]"
+  npx myaidev-method dev:review "Review [feature]"
     `);
     process.exit(0);
   }
@@ -103,7 +103,7 @@ Next Phase:
     console.log('');
     console.log('📌 Next Steps:');
     console.log('  1. Review test results in .myaidev-method/sparc/test-results/');
-    console.log('  2. Run: npm run dev:review "Review [feature]"');
+    console.log('  2. Run: npx myaidev-method dev:review "Review [feature]"');
     console.log('');
 
   } catch (error) {

package/src/scripts/sparc-workflow.js

@@ -7,8 +7,9 @@
  * Architecture → Implementation → Testing → Review → Documentation
  *
  * Usage:
- *   npm run sparc "Build user authentication system"
- *   npm run sparc "Create payment module" --tech-stack "node,stripe,postgres"
+ *   npx myaidev-method sparc "Build user authentication system"
+ *   npx myaidev-method sparc "Create payment module" --tech-stack "node,stripe,postgres"
+ *   npm run sparc "Build feature" (from package root)
  */
 
 import { SparcWorkflow } from '../lib/dev-workflow/sparc-workflow.js';
@@ -29,8 +30,8 @@ Execute the complete 5-phase systematic development workflow:
   5. Documentation - Generate complete docs
 
 Usage:
-  npm run sparc "Build authentication system"
-  npm run sparc "Create payment module" --tech-stack "node,stripe,postgres"
+  npx myaidev-method sparc "Build authentication system"
+  npx myaidev-method sparc "Create payment module" --tech-stack "node,stripe,postgres"
 
 Options:
   --phases <phases>       Run specific phases (comma-separated)
@@ -41,9 +42,9 @@ Options:
   --help, -h              Show this help message
 
 Examples:
-  npm run sparc "Build JWT authentication with refresh tokens"
-  npm run sparc "Create e-commerce checkout" --tech-stack "react,node,stripe"
-  npm run sparc "Refactor payment module" --phases "architecture,review,documentation"
+  npx myaidev-method sparc "Build JWT authentication with refresh tokens"
+  npx myaidev-method sparc "Create e-commerce checkout" --tech-stack "react,node,stripe"
+  npx myaidev-method sparc "Refactor payment module" --phases "architecture,review,documentation"
 
 Workflow Phases:
   1. 🏗️  Architecture   - System design, API specs, data modeling