@pjmendonca/devflow 1.10.2 → 1.11.1

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.1] - 2025-12-24
+
+### Changed
+- **Bin Scripts Refactoring** - Simplified and streamlined all installation and setup scripts
+  - Reduced code size by ~50% in devflow.js, devflow-install.js, and create-devflow.js
+  - Removed verbose logging and decorative message formatting
+  - Simplified installation flow to focus on core functionality
+  - Improved code maintainability and consistency across all bin scripts
+  - Same functionality with cleaner, more focused implementation
+
+## [1.11.0] - 2025-12-24
+
+### Added
+- **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

package/README.md

@@ -44,10 +44,6 @@ A production-ready, portable workflow automation system that uses Claude Code CL
 
 ### Installation
 
-**Option 1: Quick Start**
-
-This creates a new "Devflow" directory with all necessary files:
-
 ```bash
 # Create a new Devflow project directory
 npx @pjmendonca/devflow@latest
@@ -62,20 +58,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 +514,7 @@ Free to use in commercial and personal projects.
 
 
 <!-- VERSION_START - Auto-updated by update_version.py -->
-**Version**: 1.10.2
+**Version**: 1.11.1
 **Status**: Production Ready
 **Last Updated**: 2025-12-24
 <!-- VERSION_END -->

package/bin/create-devflow.js

@@ -1,44 +1,25 @@
 #!/usr/bin/env node
 
-/**
- * create-devflow - NPM initializer for Devflow
- *
- * Creates a new "Devflow" directory with all necessary files
- * Usage: npm create @pjmendonca/devflow
- */
-
 const fs = require('fs');
 const path = require('path');
 const { execSync } = require('child_process');
 
-// Get the current working directory where the user ran the command
 const targetDir = path.join(process.cwd(), 'Devflow');
-
-// Get the source directory (where this package is installed)
 const sourceDir = path.join(__dirname, '..');
 
-console.log('\n========================================');
-console.log('  Devflow Project Initializer');
-console.log('========================================\n');
+console.log('\nDevflow Project Initializer\n');
 
-// Check if Devflow directory already exists
 if (fs.existsSync(targetDir)) {
-  console.error(`Error: Directory "Devflow" already exists in ${process.cwd()}`);
-  console.error('Please remove it or run this command from a different location.\n');
+  console.error(`Error: "Devflow" directory already exists`);
+  console.error('Remove it or run from a different location.\n');
   process.exit(1);
 }
 
-console.log(`Creating Devflow directory at: ${targetDir}`);
+console.log(`Creating: ${targetDir}\n`);
 fs.mkdirSync(targetDir, { recursive: true });
 
-/**
- * Recursively copy directory
- */
 function copyDir(src, dest) {
-  // Create destination directory
   fs.mkdirSync(dest, { recursive: true });
-
-  // Read source directory
   const entries = fs.readdirSync(src, { withFileTypes: true });
 
   for (const entry of entries) {
@@ -53,17 +34,7 @@ function copyDir(src, dest) {
   }
 }
 
-/**
- * Copy file
- */
-function copyFile(src, dest) {
-  const destDir = path.dirname(dest);
-  fs.mkdirSync(destDir, { recursive: true });
-  fs.copyFileSync(src, dest);
-}
-
-// Files and directories to copy
-const itemsToCopy = [
+const items = [
   { type: 'dir', name: 'tooling' },
   { type: 'dir', name: 'bin' },
   { type: 'dir', name: 'lib' },
@@ -75,67 +46,43 @@ const itemsToCopy = [
   { type: 'file', name: '.gitignore' }
 ];
 
-console.log('\nCopying project files...');
-for (const item of itemsToCopy) {
+console.log('Copying files...');
+for (const item of items) {
   const src = path.join(sourceDir, item.name);
   const dest = path.join(targetDir, item.name);
 
-  if (!fs.existsSync(src)) {
-    console.log(`  Skipping ${item.name} (not found)`);
-    continue;
-  }
-
-  try {
+  if (fs.existsSync(src)) {
+    console.log(`  ${item.name}`);
     if (item.type === 'dir') {
-      console.log(`  Copying ${item.name}/ ...`);
       copyDir(src, dest);
     } else {
-      console.log(`  Copying ${item.name} ...`);
-      copyFile(src, dest);
+      fs.mkdirSync(path.dirname(dest), { recursive: true });
+      fs.copyFileSync(src, dest);
     }
-  } catch (error) {
-    console.error(`  Error copying ${item.name}: ${error.message}`);
   }
 }
 
-console.log('\n[OK] Files copied successfully!\n');
-
-// Initialize git repo if not already in one
-console.log('Initializing git repository...');
+console.log('\nInitializing git...');
 try {
   process.chdir(targetDir);
   execSync('git init', { stdio: 'ignore' });
-  console.log('[OK] Git repository initialized\n');
+  console.log('Done\n');
 } catch (error) {
-  console.log('[INFO] Git not available or already initialized\n');
+  console.log('Skipped\n');
 }
 
-// Run the setup wizard
-console.log('========================================');
-console.log('  Running Setup Wizard');
-console.log('========================================\n');
-
+console.log('Running setup wizard...\n');
 try {
   const initScript = path.join(targetDir, 'bin', 'devflow-init.js');
-
   if (fs.existsSync(initScript)) {
-    console.log('Starting interactive setup wizard...\n');
     execSync(`node "${initScript}"`, { stdio: 'inherit' });
-  } else {
-    console.log('[WARNING] Setup wizard not found. You may need to run it manually:');
-    console.log('  cd Devflow');
-    console.log('  npx devflow-init\n');
   }
 } catch (error) {
-  console.log('[WARNING] Setup wizard encountered an issue.');
-  console.log('You can run it manually later with: npx devflow-init\n');
+  console.log('\nSetup wizard failed. Run manually: cd Devflow && npx devflow-init\n');
 }
 
-console.log('\n========================================');
-console.log('  Setup Complete!');
-console.log('========================================\n');
-console.log('Next steps:');
-console.log('  1. cd Devflow');
-console.log('  2. Review the README.md for usage instructions');
-console.log('  3. Start using Devflow with: /story <key>\n');
+console.log('\nProject created successfully!');
+console.log('\nNext steps:');
+console.log('  cd Devflow');
+console.log('  Use /story <key> in Claude Code\n');
 console.log('Documentation: https://github.com/Pedro-Jose-da-Rocha-Mendonca/Devflow\n');

package/bin/devflow-install.js

@@ -0,0 +1,83 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+const targetDir = process.cwd();
+const sourceDir = path.join(__dirname, '..');
+
+console.log('\nDevflow Installer\n');
+
+if (fs.existsSync(path.join(targetDir, '.claude', 'commands', 'story.md'))) {
+  console.log('Devflow is already installed. Running validation...\n');
+  try {
+    execSync(`node "${path.join(__dirname, 'devflow-validate.js')}"`, { stdio: 'inherit' });
+  } catch (error) {
+    process.exit(1);
+  }
+  process.exit(0);
+}
+
+function copyDir(src, dest, exclude = []) {
+  fs.mkdirSync(dest, { recursive: true });
+  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);
+
+    if (exclude.some(pattern => entry.name.match(pattern))) continue;
+
+    if (entry.isDirectory()) {
+      copyDir(srcPath, destPath, exclude);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+const items = [
+  { name: '.claude', exclude: [] },
+  { name: 'tooling', exclude: [/^\.automation\/logs/, /^\.automation\/costs/, /^\.automation\/checkpoints/] }
+];
+
+console.log(`Installing into: ${targetDir}\n`);
+
+for (const item of items) {
+  const src = path.join(sourceDir, item.name);
+  const dest = path.join(targetDir, item.name);
+
+  if (fs.existsSync(src)) {
+    console.log(`Copying ${item.name}/`);
+    copyDir(src, dest, item.exclude);
+  }
+}
+
+const configs = ['CLAUDE.md', '.gitignore'];
+for (const file of configs) {
+  const src = path.join(sourceDir, file);
+  const dest = path.join(targetDir, file);
+  if (fs.existsSync(src) && !fs.existsSync(dest)) {
+    console.log(`Copying ${file}`);
+    fs.copyFileSync(src, dest);
+  }
+}
+
+console.log('\nInstallation complete!\n');
+
+const args = process.argv.slice(2);
+if (!args.includes('--skip-setup') && !args.includes('-s')) {
+  console.log('Running setup wizard...\n');
+  try {
+    execSync(`node "${path.join(__dirname, 'devflow-init.js')}"`, { stdio: 'inherit', cwd: targetDir });
+  } catch (error) {
+    console.log('\nSetup wizard failed. Run manually: npx @pjmendonca/devflow init\n');
+  }
+}
+
+console.log('\nDevflow installed successfully!');
+console.log('\nNext steps:');
+console.log('  1. Open Claude Code in this directory');
+console.log('  2. Use /story <key> or npx @pjmendonca/devflow story <key>');
+console.log('\nDocumentation: https://github.com/Pedro-Jose-da-Rocha-Mendonca/Devflow\n');

package/bin/devflow.js

@@ -1,11 +1,10 @@
 #!/usr/bin/env node
 
-const fs = require('fs');
-const path = require('path');
 const { spawn } = require('child_process');
 
 const commands = {
-  'init': 'Initialize Devflow in your project',
+  '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',
@@ -21,22 +20,6 @@ const commands = {
   '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');
@@ -47,35 +30,26 @@ function showHelp() {
   });
 
   console.log('\nRun "devflow <command> --help" for more information on a command.');
-  console.log('\nGet started: devflow init');
+  console.log('\nGet started:');
+  console.log('  devflow install    Install into existing project');
+  console.log('  devflow init       Initialize configuration');
 }
 
 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 - run scaffolder
-    console.log('No Devflow project detected. Running project scaffolder...\n');
-    const createScript = require.resolve('./create-devflow.js');
-    const child = spawn('node', [createScript], { stdio: 'inherit' });
-    child.on('exit', (code) => process.exit(code || 0));
-  } else {
-    // In a project - show help
-    showHelp();
-    process.exit(0);
-  }
-} else {
-  // Command provided
-  const command = args[0];
+  showHelp();
+  process.exit(0);
+}
+
+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);
-  }
+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.2",
+  "version": "1.11.1",
   "description": "Development workflow automation with Claude Code - agent-based development system with cost tracking",
   "keywords": [
     "devflow",
@@ -26,6 +26,7 @@
   "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.2"
+__version__ = "1.11.1"
 
 # Lazy imports to avoid circular dependencies
 __all__ = [