myaidev-method 0.2.3 → 0.2.4

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/package.json

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