@pjmendonca/devflow 1.10.1 → 1.11.0

package/.claude/commands/adversarial.md

@@ -5,6 +5,6 @@ allowed-tools: Bash, Read, Glob, Grep
 
 Run the Devflow adversarial review for story: $ARGUMENTS
 
-Execute: `devflow adversarial $ARGUMENTS`
+Execute: `npx @pjmendonca/devflow adversarial $ARGUMENTS`
 
 This performs a critical, thorough review using the Opus model.

package/.claude/commands/agent.md

@@ -5,6 +5,6 @@ argument-hint: <agent-name>
 
 Invoke the Devflow agent: $ARGUMENTS
 
-Execute: `devflow agent $ARGUMENTS`
+Execute: `npx @pjmendonca/devflow agent $ARGUMENTS`
 
 Available agents: architect, ba, dev, maintainer, pm, reviewer, sm

package/.claude/commands/bugfix.md

@@ -5,4 +5,4 @@ argument-hint: <bug-id>
 
 Run the Devflow bugfix automation for: $ARGUMENTS
 
-Execute: `devflow bugfix $ARGUMENTS`
+Execute: `npx @pjmendonca/devflow bugfix $ARGUMENTS`

package/.claude/commands/checkpoint.md

@@ -5,7 +5,7 @@ argument-hint: [save|restore|list] [checkpoint-name]
 
 Manage Devflow context checkpoints: $ARGUMENTS
 
-Execute: `devflow checkpoint $ARGUMENTS`
+Execute: `npx @pjmendonca/devflow checkpoint $ARGUMENTS`
 
 This manages context preservation checkpoints:
 - Save current context state before risky operations

package/.claude/commands/collab.md

@@ -5,7 +5,7 @@ argument-hint: <story-key> [--swarm|--pair|--auto]
 
 Run Devflow collaboration for: $ARGUMENTS
 
-Execute: `devflow collab $ARGUMENTS`
+Execute: `npx @pjmendonca/devflow collab $ARGUMENTS`
 
 This is the unified collaboration CLI with all modes:
 

package/.claude/commands/costs.md

@@ -5,7 +5,7 @@ argument-hint: [--period day|week|month]
 
 View Devflow cost dashboard: $ARGUMENTS
 
-Execute: `devflow costs $ARGUMENTS`
+Execute: `npx @pjmendonca/devflow costs $ARGUMENTS`
 
 This displays cost tracking and analytics:
 - Total spend by model (Opus, Sonnet, Haiku)

package/.claude/commands/develop.md

@@ -5,4 +5,4 @@ argument-hint: <story-key>
 
 Run the Devflow development phase for story: $ARGUMENTS
 
-Execute: `devflow develop $ARGUMENTS`
+Execute: `npx @pjmendonca/devflow develop $ARGUMENTS`

package/.claude/commands/handoff.md

@@ -5,7 +5,7 @@ argument-hint: <story-key> [--from AGENT] [--to AGENT]
 
 View agent handoff summaries: $ARGUMENTS
 
-Execute: `devflow handoff $ARGUMENTS`
+Execute: `npx @pjmendonca/devflow handoff $ARGUMENTS`
 
 This shows structured handoff information between agents:
 - What was completed in the previous phase

package/.claude/commands/memory.md

@@ -5,7 +5,7 @@ argument-hint: <story-key> [--query "question"]
 
 View shared memory for: $ARGUMENTS
 
-Execute: `devflow memory $ARGUMENTS`
+Execute: `npx @pjmendonca/devflow memory $ARGUMENTS`
 
 This displays the shared memory and knowledge graph for a story:
 - Cross-agent shared memory pool

package/.claude/commands/pair.md

@@ -5,7 +5,7 @@ argument-hint: <story-key>
 
 Run Devflow pair programming for: $ARGUMENTS
 
-Execute: `devflow pair $ARGUMENTS`
+Execute: `npx @pjmendonca/devflow pair $ARGUMENTS`
 
 This runs DEV and REVIEWER in an interleaved pair programming mode:
 - DEV implements code in small, reviewable chunks

package/.claude/commands/review.md

@@ -5,4 +5,4 @@ argument-hint: <story-key>
 
 Run the Devflow code review for story: $ARGUMENTS
 
-Execute: `devflow review $ARGUMENTS`
+Execute: `npx @pjmendonca/devflow review $ARGUMENTS`

package/.claude/commands/route.md

@@ -5,7 +5,7 @@ argument-hint: <task-description>
 
 Auto-route task to optimal agents: $ARGUMENTS
 
-Execute: `devflow route $ARGUMENTS`
+Execute: `npx @pjmendonca/devflow route $ARGUMENTS`
 
 This intelligently selects the best agents based on task analysis:
 - Analyzes task description for keywords and patterns

package/.claude/commands/story.md

@@ -5,6 +5,6 @@ argument-hint: <story-key>
 
 Run the Devflow story automation for story: $ARGUMENTS
 
-Execute: `devflow story $ARGUMENTS`
+Execute: `npx @pjmendonca/devflow story $ARGUMENTS`
 
 This runs the full pipeline: context creation, development, and review.

package/.claude/commands/swarm.md

@@ -5,7 +5,7 @@ argument-hint: <story-key> [--agents AGENT1,AGENT2,...]
 
 Run Devflow swarm mode for: $ARGUMENTS
 
-Execute: `devflow swarm $ARGUMENTS`
+Execute: `npx @pjmendonca/devflow swarm $ARGUMENTS`
 
 This runs multi-agent collaboration where agents debate and iterate until consensus:
 - Multiple agents analyze the task simultaneously

package/CHANGELOG.md

@@ -5,6 +5,36 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.11.0] - 2025-12-24
+
+### Added
+- **BMAD-Style Installation** - Seamless Claude Code ecosystem integration
+  - New `devflow install` command copies .claude/ and tooling/ into any project
+  - Claude Code automatically detects slash commands in .claude/commands/ directory
+  - Usage: `npx @pjmendonca/devflow install` integrates into existing projects
+  - Commands execute via npx - no global installation required
+  - Updated all .claude/commands/*.md files to use `npx @pjmendonca/devflow`
+  - Added devflow-install.js for installation logic
+  - Updated README with BMAD-style installation as recommended option
+  - Supports skipping setup wizard with --skip-setup flag
+
+### Changed
+- **Installation Flow** - Updated recommended installation method to BMAD-style
+  - Option 1 (Recommended): `npx @pjmendonca/devflow install` for existing projects
+  - Option 2: `npm create @pjmendonca/devflow` for standalone Devflow directory
+  - Option 3: `npm install -g @pjmendonca/devflow` for global installation
+- **Command Execution** - All Claude Code slash commands now use npx for better portability
+
+## [1.10.2] - 2025-12-24
+
+### Fixed
+- **npx Command** - Fixed "could not determine executable to run" error when running `npx @pjmendonca/devflow`
+  - Added main `devflow` bin entry to package.json
+  - Created bin/devflow.js as smart entry point with context detection
+  - Outside Devflow project: automatically scaffolds new project
+  - Inside Devflow project: shows help and dispatches to commands
+  - Simplified workflow: single command for both setup and usage
+
 ## [1.10.1] - 2025-12-24
 
 ### Fixed

package/README.md

@@ -62,20 +62,6 @@ cd Devflow
 /story <key>
 ```
 
-**Requirements:** Python 3.9+ and Node.js 14+
-
-**Option 2: Add to Existing Project**
-
-Install Devflow into your current project:
-
-```bash
-# Local installation
-npm install @pjmendonca/devflow
-
-# IMPORTANT: Local installs require npx to run commands
-npx devflow-validate
-npx devflow-init
-```
 
 ### Agent Personas
 
@@ -532,7 +518,7 @@ Free to use in commercial and personal projects.
 
 
 <!-- VERSION_START - Auto-updated by update_version.py -->
-**Version**: 1.10.1
+**Version**: 1.10.2
 **Status**: Production Ready
 **Last Updated**: 2025-12-24
 <!-- VERSION_END -->

package/bin/devflow-install.js

@@ -0,0 +1,165 @@
+#!/usr/bin/env node
+
+/**
+ * devflow-install - Install Devflow into the current project
+ *
+ * Copies .claude/ and tooling/ directories into the user's project
+ * This enables Claude Code to automatically detect slash commands
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+const targetDir = process.cwd();
+const sourceDir = path.join(__dirname, '..');
+
+console.log('\n========================================');
+console.log('  Devflow Installer');
+console.log('========================================\n');
+
+// Check if we're already in a Devflow directory
+const isAlreadyDevflow = fs.existsSync(path.join(targetDir, '.claude', 'commands', 'story.md'));
+if (isAlreadyDevflow) {
+  console.log('[INFO] Devflow is already installed in this directory.');
+  console.log('[INFO] Running validation instead...\n');
+  try {
+    const validateScript = path.join(__dirname, 'devflow-validate.js');
+    execSync(`node "${validateScript}"`, { stdio: 'inherit' });
+  } catch (error) {
+    process.exit(1);
+  }
+  process.exit(0);
+}
+
+/**
+ * Recursively copy directory
+ */
+function copyDir(src, dest, options = {}) {
+  const { exclude = [] } = options;
+
+  // Create destination directory
+  fs.mkdirSync(dest, { recursive: true });
+
+  // Read source directory
+  const entries = fs.readdirSync(src, { withFileTypes: true });
+
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+
+    // Skip excluded files/directories
+    if (exclude.some(pattern => entry.name.match(pattern))) {
+      continue;
+    }
+
+    if (entry.isDirectory()) {
+      copyDir(srcPath, destPath, options);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+// Directories to copy
+const itemsToCopy = [
+  {
+    type: 'dir',
+    name: '.claude',
+    desc: 'Claude Code commands and skills',
+    exclude: []
+  },
+  {
+    type: 'dir',
+    name: 'tooling',
+    desc: 'Automation scripts and agents',
+    exclude: [/^\.automation\/logs/, /^\.automation\/costs/, /^\.automation\/checkpoints/]
+  }
+];
+
+console.log('Installing Devflow into:', targetDir);
+console.log('\nCopying essential files...\n');
+
+for (const item of itemsToCopy) {
+  const src = path.join(sourceDir, item.name);
+  const dest = path.join(targetDir, item.name);
+
+  if (!fs.existsSync(src)) {
+    console.log(`  [SKIP] ${item.name}/ (not found in package)`);
+    continue;
+  }
+
+  try {
+    console.log(`  [COPY] ${item.name}/ - ${item.desc}`);
+    copyDir(src, dest, { exclude: item.exclude });
+  } catch (error) {
+    console.error(`  [ERROR] Failed to copy ${item.name}: ${error.message}`);
+    process.exit(1);
+  }
+}
+
+// Copy essential config files if they don't exist
+const configFiles = [
+  { src: 'CLAUDE.md', desc: 'Project instructions for Claude' },
+  { src: '.gitignore', desc: 'Git ignore patterns' }
+];
+
+console.log('\nCopying configuration files...\n');
+for (const file of configFiles) {
+  const src = path.join(sourceDir, file.src);
+  const dest = path.join(targetDir, file.src);
+
+  if (!fs.existsSync(src)) {
+    console.log(`  [SKIP] ${file.src} (not found)`);
+    continue;
+  }
+
+  if (fs.existsSync(dest)) {
+    console.log(`  [SKIP] ${file.src} (already exists)`);
+    continue;
+  }
+
+  try {
+    console.log(`  [COPY] ${file.src} - ${file.desc}`);
+    fs.copyFileSync(src, dest);
+  } catch (error) {
+    console.error(`  [ERROR] Failed to copy ${file.src}: ${error.message}`);
+  }
+}
+
+console.log('\n[OK] Installation complete!\n');
+
+// Check if user wants to run the setup wizard
+const args = process.argv.slice(2);
+const skipSetup = args.includes('--skip-setup') || args.includes('-s');
+
+if (!skipSetup) {
+  console.log('========================================');
+  console.log('  Running Setup Wizard');
+  console.log('========================================\n');
+
+  try {
+    const initScript = path.join(__dirname, 'devflow-init.js');
+    console.log('Starting interactive setup wizard...\n');
+    execSync(`node "${initScript}"`, { stdio: 'inherit', cwd: targetDir });
+  } catch (error) {
+    console.log('\n[WARNING] Setup wizard encountered an issue.');
+    console.log('You can run it manually later with: npx @pjmendonca/devflow init\n');
+  }
+}
+
+console.log('\n========================================');
+console.log('  Installation Complete!');
+console.log('========================================\n');
+console.log('Devflow is now integrated with your project.\n');
+console.log('Next steps:');
+console.log('  1. Open Claude Code in this directory');
+console.log('  2. Use slash commands like /story <key>');
+console.log('  3. Or run directly: npx @pjmendonca/devflow story <key>\n');
+console.log('Available commands:');
+console.log('  /story <key>     - Full development pipeline');
+console.log('  /swarm <key>     - Multi-agent collaboration');
+console.log('  /pair <key>      - Pair programming mode');
+console.log('  /costs           - View cost dashboard');
+console.log('  /memory <key>    - Query shared memory\n');
+console.log('Documentation: https://github.com/Pedro-Jose-da-Rocha-Mendonca/Devflow\n');

package/bin/devflow.js

@@ -0,0 +1,84 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+const { spawn } = require('child_process');
+
+const commands = {
+  'install': 'Install Devflow into your project',
+  'init': 'Initialize Devflow configuration',
+  'story': 'Run full story pipeline (context + dev + review)',
+  'collab': 'Run collaborative story with mode selection',
+  'checkpoint': 'Create or restore context checkpoints',
+  'memory': 'View or query shared agent memory',
+  'cost': 'View cost dashboard and spending analytics',
+  'validate': 'Validate project configuration',
+  'create-persona': 'Create a new agent persona',
+  'personalize': 'Personalize agent behavior with guided wizard',
+  'validate-overrides': 'Validate override configurations',
+  'new-doc': 'Create new documentation',
+  'tech-debt': 'Analyze and track technical debt',
+  'setup-checkpoint': 'Setup checkpoint system',
+  'version': 'Show version information'
+};
+
+/**
+ * Check if we're in a Devflow project
+ */
+function isInDevflowProject() {
+  const indicators = [
+    'tooling/.automation',
+    'tooling/scripts',
+    '.claude'
+  ];
+
+  return indicators.some(indicator => fs.existsSync(path.join(process.cwd(), indicator)));
+}
+
+/**
+ * Show help message
+ */
+function showHelp() {
+  console.log('Devflow - Development workflow automation with Claude Code\n');
+  console.log('Usage: devflow <command> [options]\n');
+  console.log('Available commands:\n');
+
+  Object.entries(commands).forEach(([cmd, desc]) => {
+    console.log(`  ${cmd.padEnd(20)} ${desc}`);
+  });
+
+  console.log('\nRun "devflow <command> --help" for more information on a command.');
+  console.log('\nGet started: devflow init');
+}
+
+const args = process.argv.slice(2);
+
+// If no arguments or --help, check if we're in a project
+if (args.length === 0 || args[0] === '--help' || args[0] === '-h') {
+  if (!isInDevflowProject()) {
+    // Not in a project - suggest install
+    console.log('No Devflow project detected.\n');
+    console.log('To install Devflow in this directory, run:');
+    console.log('  npx @pjmendonca/devflow install\n');
+    console.log('Or to create a new standalone Devflow project:');
+    console.log('  npm create @pjmendonca/devflow\n');
+    process.exit(1);
+  } else {
+    // In a project - show help
+    showHelp();
+    process.exit(0);
+  }
+} else {
+  // Command provided
+  const command = args[0];
+
+  if (commands[command]) {
+    const binPath = require.resolve(`./devflow-${command}.js`);
+    const child = spawn('node', [binPath, ...args.slice(1)], { stdio: 'inherit' });
+    child.on('exit', (code) => process.exit(code || 0));
+  } else {
+    console.error(`Unknown command: ${command}`);
+    console.error('Run "devflow --help" to see available commands.');
+    process.exit(1);
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pjmendonca/devflow",
-  "version": "1.10.1",
+  "version": "1.11.0",
   "description": "Development workflow automation with Claude Code - agent-based development system with cost tracking",
   "keywords": [
     "devflow",
@@ -24,7 +24,9 @@
     "name": "Pedro Jose da Rocha Mendonca"
   },
   "bin": {
+    "devflow": "bin/devflow.js",
     "create-devflow": "bin/create-devflow.js",
+    "devflow-install": "bin/devflow-install.js",
     "devflow-cost": "bin/devflow-cost.js",
     "devflow-validate": "bin/devflow-validate.js",
     "devflow-story": "bin/devflow-story.js",

package/tooling/scripts/lib/__init__.py

@@ -18,7 +18,7 @@ Usage:
     from lib.agent_router import AgentRouter
 """
 
-__version__ = "1.10.1"
+__version__ = "1.11.0"
 
 # Lazy imports to avoid circular dependencies
 __all__ = [