5-phase-workflow 1.4.3 → 1.5.0

package/README.md

@@ -126,10 +126,11 @@ All commands are available under the `/5:` namespace:
 | `/5:verify-implementation` | 4 | Verify completeness and correctness |
 | `/5:review-code` | 5 | AI-powered code review (CodeRabbit) |
 | `/5:quick-implement` | Fast | Streamlined workflow for small tasks |
+| `/5:unlock` | Utility | Remove planning guard lock |
 
 ## Configuration
 
-The workflow is configured via `.claude/.5/config.json`. Here's an example:
+The workflow is configured via `.5/config.json`. Here's an example:
 
 ```json
 {
@@ -181,7 +182,7 @@ Claude asks 5-10 clarifying questions to understand your requirements:
 - How will we verify it works?
 - Are there simpler alternatives?
 
-The output is a comprehensive feature spec at `.claude/.features/{ticket-id}.md`.
+The output is a comprehensive feature spec at `.5/features/{ticket-id}/feature.md`.
 
 ### Phase 2: Implementation Planning
 
@@ -207,7 +208,7 @@ Claude executes the plan using specialized agents:
 - **step-verifier**: Compiles and checks for errors after each step
 - **integration-agent**: Wires components and registers routes
 
-State is tracked in `.claude/.implementations/state/{ticket-id}.json` for resumability.
+State is tracked in `.5/features/{ticket-id}/state.json` for resumability.
 
 ### Phase 4: Verify Implementation
 
@@ -234,9 +235,12 @@ Automated review using CodeRabbit (if installed):
 After installation, your `.claude/` directory will contain:
 
 ```
+.5/
+├── config.json               # Project configuration
+├── version.json              # Version tracking
+└── features/                 # Feature tracking
+
 .claude/
-├── .5/
-│   └── config.json           # Project configuration
 ├── commands/5/               # Workflow commands
 │   ├── plan-feature.md
 │   ├── plan-implementation.md
@@ -245,13 +249,17 @@ After installation, your `.claude/` directory will contain:
 │   ├── review-code.md
 │   ├── discuss-feature.md
 │   ├── quick-implement.md
-│   └── configure.md
+│   ├── configure.md
+│   └── unlock.md
 ├── skills/                   # Atomic operations
 │   ├── build-project/
 │   ├── run-tests/
 │   └── generate-readme/
 ├── hooks/
-│   └── statusline.js         # Status line integration
+│   ├── statusline.js         # Status line integration
+│   ├── check-updates.js      # Update notifications
+│   ├── plan-guard.js         # Planning phase edit guard
+│   └── config-guard.js       # Configuration guard
 └── settings.json             # Claude Code settings
 ```
 
@@ -293,7 +301,7 @@ After installation, your `.claude/` directory will contain:
 
 1. Run `/5:configure` to verify configuration
 2. Test commands manually in terminal
-3. Update `.claude/.5/config.json` with correct commands
+3. Update `.5/config.json` with correct commands
 
 ### "Cannot find project type"
 
@@ -303,7 +311,7 @@ The auto-detection failed. Run `/5:configure` and manually select your project t
 
 If implementation gets stuck:
 
-1. Check `.claude/.implementations/state/{ticket-id}.json`
+1. Check `.5/features/{ticket-id}/state.json`
 2. Note the `currentStep` value
 3. Run `/5:implement-feature` again - it will resume from that step
 
@@ -338,7 +346,7 @@ npx 5-phase-workflow
 ```
 
 **Note:** During updates:
-- Config files in `.claude/.5/` are preserved
+- Config files in `.5/` are preserved
 - User-created commands, agents, skills, hooks, and templates are preserved
 - Only workflow-managed files are updated
 

package/bin/install.js

@@ -23,9 +23,10 @@ const log = {
 };
 
 // Version comparison (semver)
+// Uses parseInt to handle pre-release tags (e.g., "2-beta" → 2)
 function compareVersions(v1, v2) {
-  const parts1 = v1.split('.').map(Number);
-  const parts2 = v2.split('.').map(Number);
+  const parts1 = v1.split('.').map(p => parseInt(p, 10) || 0);
+  const parts2 = v2.split('.').map(p => parseInt(p, 10) || 0);
   for (let i = 0; i < 3; i++) {
     if (parts1[i] > parts2[i]) return 1;
     if (parts1[i] < parts2[i]) return -1;
@@ -34,8 +35,8 @@ function compareVersions(v1, v2) {
 }
 
 // Get installed version from .5/version.json
-function getInstalledVersion(targetPath) {
-  const versionFile = path.join(targetPath, '.5', 'version.json');
+function getInstalledVersion(isGlobal) {
+  const versionFile = path.join(getDataPath(isGlobal), 'version.json');
   if (!fs.existsSync(versionFile)) return null;
 
   try {
@@ -54,13 +55,13 @@ function getPackageVersion() {
 }
 
 // Get full version info
-function getVersionInfo(targetPath) {
+function getVersionInfo(targetPath, isGlobal) {
   const exists = checkExistingInstallation(targetPath);
   if (!exists) {
     return { exists: false };
   }
 
-  const installed = getInstalledVersion(targetPath);
+  const installed = getInstalledVersion(isGlobal);
   const available = getPackageVersion();
 
   if (!installed) {
@@ -138,7 +139,7 @@ Examples:
 `);
 }
 
-// Get installation target path
+// Get installation target path (.claude/ directory)
 function getTargetPath(isGlobal) {
   if (isGlobal) {
     const homeDir = process.env.HOME || process.env.USERPROFILE;
@@ -147,6 +148,60 @@ function getTargetPath(isGlobal) {
   return path.join(process.cwd(), '.claude');
 }
 
+// Get data path (.5/ directory for config, version, features)
+// Local installs: <project>/.5 (project root)
+// Global installs: ~/.claude/.5 (alongside global install)
+function getDataPath(isGlobal) {
+  if (isGlobal) {
+    return path.join(getTargetPath(true), '.5');
+  }
+  return path.join(process.cwd(), '.5');
+}
+
+// Migrate data from old .claude/.5/ to new .5/ location (local installs only)
+// This runs during upgrades so existing users don't lose config/features/version data.
+function migrateDataDir(isGlobal) {
+  // Global installs: old and new paths are both ~/.claude/.5 — no migration needed
+  if (isGlobal) return;
+
+  const oldDir = path.join(process.cwd(), '.claude', '.5');
+  const newDir = getDataPath(false); // <project>/.5
+
+  if (!fs.existsSync(oldDir)) return;
+
+  // If new dir doesn't exist, move everything over
+  if (!fs.existsSync(newDir)) {
+    fs.mkdirSync(newDir, { recursive: true });
+  }
+
+  // Copy all files/dirs from old to new (skip files that already exist in new)
+  copyDirMerge(oldDir, newDir);
+
+  // Remove old directory
+  removeDir(oldDir);
+  log.success('Migrated .claude/.5/ → .5/');
+}
+
+// Copy directory recursively, skipping files that already exist at destination
+function copyDirMerge(src, dest) {
+  if (!fs.existsSync(dest)) {
+    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 (entry.isDirectory()) {
+      copyDirMerge(srcPath, destPath);
+    } else if (!fs.existsSync(destPath)) {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
 // Get source path (package installation directory)
 function getSourcePath() {
   // When installed via npm, __dirname is <install-location>/bin
@@ -214,7 +269,8 @@ function getWorkflowManagedFiles() {
     hooks: [
       'statusline.js',
       'check-updates.js',
-      'plan-guard.js'
+      'plan-guard.js',
+      'config-guard.js'
     ],
 
     // Templates: specific template files
@@ -234,7 +290,6 @@ function getWorkflowManagedFiles() {
       'workflow/VERIFICATION-REPORT.md',
       'workflow/REVIEW-FINDINGS.md',
       'workflow/REVIEW-SUMMARY.md',
-      'workflow/QUICK-PLAN.md',
       'workflow/FIX-PLAN.md'
     ]
   };
@@ -255,20 +310,22 @@ function selectiveUpdate(targetPath, sourcePath) {
     log.success('Updated commands/5/');
   }
 
-  // Update specific agents
-  const agentsSrc = path.join(sourcePath, 'agents');
-  const agentsDest = path.join(targetPath, 'agents');
-  if (!fs.existsSync(agentsDest)) {
-    fs.mkdirSync(agentsDest, { recursive: true });
-  }
-  for (const agent of managed.agents) {
-    const src = path.join(agentsSrc, agent);
-    const dest = path.join(agentsDest, agent);
-    if (fs.existsSync(src)) {
-      fs.copyFileSync(src, dest);
+  // Update specific agents (currently none — instructions are embedded inline in commands)
+  if (managed.agents.length > 0) {
+    const agentsSrc = path.join(sourcePath, 'agents');
+    const agentsDest = path.join(targetPath, 'agents');
+    if (!fs.existsSync(agentsDest)) {
+      fs.mkdirSync(agentsDest, { recursive: true });
     }
+    for (const agent of managed.agents) {
+      const src = path.join(agentsSrc, agent);
+      const dest = path.join(agentsDest, agent);
+      if (fs.existsSync(src)) {
+        fs.copyFileSync(src, dest);
+      }
+    }
+    log.success('Updated agents/ (workflow files only)');
   }
-  log.success('Updated agents/ (workflow files only)');
 
   // Update specific skills
   const skillsSrc = path.join(sourcePath, 'skills');
@@ -324,175 +381,13 @@ function selectiveUpdate(targetPath, sourcePath) {
   log.success('Updated templates/ (workflow files only)');
 }
 
-// Detect project type by examining files in current directory
-function detectProjectType() {
-  const cwd = process.cwd();
-
-  if (fs.existsSync(path.join(cwd, 'package.json'))) {
-    const pkg = JSON.parse(fs.readFileSync(path.join(cwd, 'package.json'), 'utf8'));
-    if (pkg.dependencies?.['next'] || pkg.devDependencies?.['next']) return 'nextjs';
-    if (pkg.dependencies?.['express'] || pkg.devDependencies?.['express']) return 'express';
-    if (pkg.dependencies?.['@nestjs/core']) return 'nestjs';
-    return 'javascript';
-  }
-
-  if (fs.existsSync(path.join(cwd, 'build.gradle')) || fs.existsSync(path.join(cwd, 'build.gradle.kts'))) {
-    return 'gradle-java';
-  }
-
-  if (fs.existsSync(path.join(cwd, 'pom.xml'))) {
-    return 'maven-java';
-  }
-
-  if (fs.existsSync(path.join(cwd, 'Cargo.toml'))) {
-    return 'rust';
-  }
-
-  if (fs.existsSync(path.join(cwd, 'go.mod'))) {
-    return 'go';
-  }
-
-  if (fs.existsSync(path.join(cwd, 'requirements.txt')) || fs.existsSync(path.join(cwd, 'pyproject.toml'))) {
-    const hasDjango = fs.existsSync(path.join(cwd, 'manage.py'));
-    const hasFlask = fs.existsSync(path.join(cwd, 'app.py')) || fs.existsSync(path.join(cwd, 'wsgi.py'));
-    if (hasDjango) return 'django';
-    if (hasFlask) return 'flask';
-    return 'python';
-  }
-
-  return 'unknown';
-}
-
-// Get default config based on project type
-function getDefaultConfig(projectType) {
-  const baseConfig = {
-    ticket: {
-      pattern: '[A-Z]+-\\d+',
-      extractFromBranch: true
-    },
-    build: {
-      command: 'auto',
-      testCommand: 'auto'
-    },
-    reviewTool: 'claude',
-    git: {
-      autoCommit: false,
-      commitMessage: { pattern: '{ticket-id} {short-description}' }
-    }
-  };
-
-  // Project-specific overrides
-  const overrides = {
-    'gradle-java': {
-      build: {
-        command: './gradlew build -x test -x javadoc --offline',
-        testCommand: './gradlew test --offline'
-      }
-    },
-    'maven-java': {
-      build: {
-        command: 'mvn compile',
-        testCommand: 'mvn test'
-      }
-    },
-    'javascript': {
-      build: {
-        command: 'npm run build',
-        testCommand: 'npm test'
-      }
-    },
-    'nextjs': {
-      build: {
-        command: 'npm run build',
-        testCommand: 'npm test'
-      }
-    },
-    'express': {
-      build: {
-        command: 'npm run build || tsc',
-        testCommand: 'npm test'
-      }
-    },
-    'nestjs': {
-      build: {
-        command: 'npm run build',
-        testCommand: 'npm test'
-      }
-    },
-    'rust': {
-      build: {
-        command: 'cargo build',
-        testCommand: 'cargo test'
-      }
-    },
-    'go': {
-      build: {
-        command: 'go build ./...',
-        testCommand: 'go test ./...'
-      }
-    },
-    'python': {
-      build: {
-        command: 'python -m py_compile **/*.py',
-        testCommand: 'pytest'
-      }
-    },
-    'django': {
-      build: {
-        command: 'python manage.py check',
-        testCommand: 'python manage.py test'
-      }
-    },
-    'flask': {
-      build: {
-        command: 'python -m py_compile **/*.py',
-        testCommand: 'pytest'
-      }
-    }
-  };
-
-  return {
-    ...baseConfig,
-    ...(overrides[projectType] || {}),
-    projectType
-  };
-}
-
-// Initialize config file
-function initializeConfig(targetPath) {
-  const configDir = path.join(targetPath, '.5');
-  const configFile = path.join(configDir, 'config.json');
-
-  if (fs.existsSync(configFile)) {
-    log.info('Config file already exists, skipping initialization');
-    return;
-  }
-
-  if (!fs.existsSync(configDir)) {
-    fs.mkdirSync(configDir, { recursive: true });
-  }
-
-  // Create features subdirectory
-  const featuresDir = path.join(configDir, 'features');
-  if (!fs.existsSync(featuresDir)) {
-    fs.mkdirSync(featuresDir, { recursive: true });
-    log.success('Created .5/features/ directory');
-  }
-
-  const projectType = detectProjectType();
-  const config = getDefaultConfig(projectType);
-
-  fs.writeFileSync(configFile, JSON.stringify(config, null, 2));
-  log.success(`Created config file with detected project type: ${projectType}`);
-}
-
 // Initialize version.json after successful install
-function initializeVersionJson(targetPath, isGlobal) {
-  const configDir = path.join(targetPath, '.5');
-  const versionFile = path.join(configDir, 'version.json');
+function initializeVersionJson(isGlobal) {
+  const dataDir = getDataPath(isGlobal);
+  const versionFile = path.join(dataDir, 'version.json');
 
-  if (!fs.existsSync(configDir)) {
-    fs.mkdirSync(configDir, { recursive: true });
+  if (!fs.existsSync(dataDir)) {
+    fs.mkdirSync(dataDir, { recursive: true });
   }
 
   const version = getPackageVersion();
@@ -512,16 +407,42 @@ function initializeVersionJson(targetPath, isGlobal) {
   log.success('Initialized version tracking');
 }
 
+// Merge hook arrays by matching on the command path.
+// Keeps user overrides for existing hooks, adds new hooks from source.
+function mergeHookArrays(targetArr, sourceArr) {
+  const result = [...targetArr];
+  for (const sourceEntry of sourceArr) {
+    const sourceCmd = sourceEntry.hooks?.[0]?.command || '';
+    const exists = result.some(entry => {
+      const cmd = entry.hooks?.[0]?.command || '';
+      return cmd === sourceCmd;
+    });
+    if (!exists) {
+      result.push(sourceEntry);
+    }
+  }
+  return result;
+}
+
+// Hook event keys that contain arrays of hook entries
+const HOOK_ARRAY_KEYS = new Set([
+  'PreToolUse', 'PostToolUse', 'SessionStart', 'SessionEnd',
+  'PreCompact', 'PostCompact'
+]);
+
 // Deep merge for settings.json
-function deepMerge(target, source) {
+function deepMerge(target, source, parentKey) {
   const result = { ...target };
 
   for (const key in source) {
     if (source[key] !== null && typeof source[key] === 'object' && !Array.isArray(source[key])) {
       // Recursively merge nested objects
-      result[key] = deepMerge(result[key] || {}, source[key]);
+      result[key] = deepMerge(result[key] || {}, source[key], key);
+    } else if (Array.isArray(source[key]) && Array.isArray(result[key]) && HOOK_ARRAY_KEYS.has(key)) {
+      // Hook arrays: merge by command path to add new hooks
+      result[key] = mergeHookArrays(result[key], source[key]);
     } else {
-      // For primitives and arrays: use source if target doesn't have it
+      // For primitives and non-hook arrays: use source if target doesn't have it
       if (!(key in result)) {
         result[key] = source[key];
       }
@@ -560,7 +481,7 @@ function checkExistingInstallation(targetPath) {
 }
 
 // Helper to show commands
-function showCommandsHelp(targetPath) {
+function showCommandsHelp(isGlobal) {
   log.info('Available commands:');
   log.info('  /5:plan-feature          - Start feature planning (Phase 1)');
   log.info('  /5:plan-implementation   - Create implementation plan (Phase 2)');
@@ -568,8 +489,9 @@ function showCommandsHelp(targetPath) {
   log.info('  /5:verify-implementation - Verify implementation (Phase 4)');
   log.info('  /5:review-code          - Code review (Phase 5)');
   log.info('  /5:configure            - Interactive project setup');
+  log.info('  /5:unlock               - Remove planning guard lock');
   log.info('');
-  log.info(`Config file: ${path.join(targetPath, '.5', 'config.json')}`);
+  log.info(`Config file: ${path.join(getDataPath(isGlobal), 'config.json')}`);
 }
 
 // Fresh installation
@@ -596,7 +518,7 @@ function performFreshInstall(targetPath, sourcePath, isGlobal) {
   mergeSettings(targetPath, sourcePath);
 
   // Initialize version tracking
-  initializeVersionJson(targetPath, isGlobal);
+  initializeVersionJson(isGlobal);
 
   log.header('Installation Complete!');
   log.info('');
@@ -610,10 +532,10 @@ function performFreshInstall(targetPath, sourcePath, isGlobal) {
   log.info('  • Create project-specific skills');
   log.info('');
 
-  showCommandsHelp(targetPath);
+  showCommandsHelp(isGlobal);
 }
 
-// Perform update (preserves .5/ directory and user-created files)
+// Perform update (preserves user-created files, updates .5/ data directory)
 function performUpdate(targetPath, sourcePath, isGlobal, versionInfo) {
   log.header(`Updating from ${versionInfo.installed || 'legacy'} to ${versionInfo.available}`);
   log.info('Preserving user-created commands, agents, skills, and hooks');
@@ -625,8 +547,8 @@ function performUpdate(targetPath, sourcePath, isGlobal, versionInfo) {
   mergeSettings(targetPath, sourcePath);
 
   // Update version.json
-  const configDir = path.join(targetPath, '.5');
-  const versionFile = path.join(configDir, 'version.json');
+  const dataDir = getDataPath(isGlobal);
+  const versionFile = path.join(dataDir, 'version.json');
 
   let versionData;
   if (fs.existsSync(versionFile)) {
@@ -644,22 +566,22 @@ function performUpdate(targetPath, sourcePath, isGlobal, versionInfo) {
   versionData.installedVersion = versionInfo.available;
   versionData.lastUpdated = new Date().toISOString();
 
-  if (!fs.existsSync(configDir)) {
-    fs.mkdirSync(configDir, { recursive: true });
+  if (!fs.existsSync(dataDir)) {
+    fs.mkdirSync(dataDir, { recursive: true });
   }
   fs.writeFileSync(versionFile, JSON.stringify(versionData, null, 2));
 
   // Create features directory if it doesn't exist
-  const featuresDir = path.join(configDir, 'features');
+  const featuresDir = path.join(dataDir, 'features');
   if (!fs.existsSync(featuresDir)) {
     fs.mkdirSync(featuresDir, { recursive: true });
-    log.info('📁 Feature folders now nest under .5/features/');
-    log.info('📋 See RELEASE_NOTES.md for migration if you have in-progress features');
+    log.info('Feature folders nest under .5/features/');
+    log.info('See RELEASE_NOTES.md for migration if you have in-progress features');
   }
 
   log.header('Update Complete!');
   log.success(`Now running version ${versionInfo.available}`);
-  showCommandsHelp(targetPath);
+  showCommandsHelp(isGlobal);
 }
 
 // Perform installation
@@ -671,8 +593,11 @@ function install(isGlobal, forceUpgrade = false) {
   log.info(`Target: ${targetPath}`);
   log.info(`Source: ${sourcePath}`);
 
+  // Migrate data from old .claude/.5/ to new .5/ location
+  migrateDataDir(isGlobal);
+
   // Check for existing installation and version
-  const versionInfo = getVersionInfo(targetPath);
+  const versionInfo = getVersionInfo(targetPath, isGlobal);
 
   if (versionInfo.exists) {
     if (versionInfo.legacy) {
@@ -727,21 +652,54 @@ function uninstall() {
     return;
   }
 
-  // Remove directories
-  const dirs = ['commands/5', 'agents', 'skills', 'hooks', 'templates'];
-  for (const dir of dirs) {
-    const fullPath = path.join(targetPath, dir);
-    if (fs.existsSync(fullPath)) {
-      removeDir(fullPath);
-      log.success(`Removed ${dir}`);
+  const managed = getWorkflowManagedFiles();
+
+  // Remove commands/5/ (workflow namespace only)
+  const commands5 = path.join(targetPath, 'commands', '5');
+  if (fs.existsSync(commands5)) {
+    removeDir(commands5);
+    log.success('Removed commands/5/');
+  }
+
+  // Remove only workflow-managed skills
+  for (const skill of managed.skills) {
+    const skillPath = path.join(targetPath, 'skills', skill);
+    if (fs.existsSync(skillPath)) {
+      removeDir(skillPath);
+    }
+  }
+  log.success('Removed workflow skills (preserved user-created skills)');
+
+  // Remove only workflow-managed hooks
+  for (const hook of managed.hooks) {
+    const hookPath = path.join(targetPath, 'hooks', hook);
+    if (fs.existsSync(hookPath)) {
+      fs.unlinkSync(hookPath);
     }
   }
+  log.success('Removed workflow hooks (preserved user-created hooks)');
+
+  // Remove only workflow-managed templates
+  for (const template of managed.templates) {
+    const templatePath = path.join(targetPath, 'templates', template);
+    if (fs.existsSync(templatePath)) {
+      fs.unlinkSync(templatePath);
+    }
+  }
+  log.success('Removed workflow templates (preserved user-created templates)');
+
+  // Remove data directory (.5/)
+  const dataDir = getDataPath(false);
+  if (fs.existsSync(dataDir)) {
+    removeDir(dataDir);
+    log.success('Removed .5/ data directory');
+  }
 
-  // Remove config
-  const configDir = path.join(targetPath, '.5');
-  if (fs.existsSync(configDir)) {
-    removeDir(configDir);
-    log.success('Removed .5/ config directory');
+  // Also clean up old .claude/.5/ if it still exists
+  const oldDataDir = path.join(targetPath, '.5');
+  if (fs.existsSync(oldDataDir)) {
+    removeDir(oldDataDir);
+    log.success('Removed legacy .claude/.5/ directory');
   }
 
   log.header('Uninstallation Complete!');
@@ -758,7 +716,8 @@ function main() {
 
   if (options.check) {
     const targetPath = getTargetPath(options.global);
-    const versionInfo = getVersionInfo(targetPath);
+    migrateDataDir(options.global);
+    const versionInfo = getVersionInfo(targetPath, options.global);
 
     if (!versionInfo.exists) {
       log.info('Not installed');

package/docs/workflow-guide.md

@@ -72,7 +72,7 @@ The installer copies workflow files to `.claude/` directory. **It does NOT creat
 4. **Phase 4** (`/5:verify-implementation`): Verifies configuration
 
 After completing these steps, you have:
-- `.claude/.5/config.json` with your project settings
+- `.5/config.json` with your project settings
 - `CLAUDE.md` with comprehensive project documentation
 - `.5/STRUCTURE.md`, `.5/STACK.md`, etc. with modular documentation
 - Project-specific skills in `.claude/skills/`
@@ -295,7 +295,7 @@ Map feature requirements to technical components, skills, and dependency steps.
    - **Step 2 (Logic)**: Business logic, services, handlers (sequential if needed)
    - **Step 3 (Integration)**: API routes, wiring, tests (sequential for integration)
 
-   Note: Step count and organization is configurable in `.claude/.5/config.json`
+   Note: Step count and organization is configurable in `.5/config.json`
 
 6. **Implementation Plan Creation**: Claude writes an **atomic plan structure** to:
    ```
@@ -997,7 +997,7 @@ If working on multiple features:
 
 ## Configuring for Different Tech Stacks
 
-The 5-phase workflow is designed to work with any technology stack. Configuration is stored in `.claude/.5/config.json` and can be customized using the `/5:configure` command.
+The 5-phase workflow is designed to work with any technology stack. Configuration is stored in `.5/config.json` and can be customized using the `/5:configure` command.
 
 ### Quick Setup
 
@@ -1096,7 +1096,7 @@ You can override auto-detected values in the config file.
 
 ### Further Customization
 
-See the `/5:configure` command for interactive configuration, or manually edit `.claude/.5/config.json` to customize:
+See the `/5:configure` command for interactive configuration, or manually edit `.5/config.json` to customize:
 - Ticket ID patterns
 - Branch naming conventions
 - Build and test commands

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "5-phase-workflow",
-  "version": "1.4.3",
+  "version": "1.5.0",
   "description": "A 5-phase feature development workflow for Claude Code",
   "bin": {
     "5-phase-workflow": "bin/install.js"