claude-code-templates 1.0.2 → 1.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-templates",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "description": "CLI tool to setup Claude Code configurations for different programming languages",
   "main": "src/index.js",
   "bin": {

package/src/command-scanner.js

@@ -0,0 +1,175 @@
+const fs = require('fs-extra');
+const path = require('path');
+
+/**
+ * Scans and returns available commands for a given language
+ * @param {string} language - The language template to scan
+ * @returns {Array} Array of available commands with metadata
+ */
+function getAvailableCommands(language) {
+  const templatesDir = path.join(__dirname, '..', 'templates');
+  const languageDir = path.join(templatesDir, language);
+  
+  // Check if language directory exists
+  if (!fs.existsSync(languageDir)) {
+    return [];
+  }
+  
+  const commands = [];
+  
+  // Scan main .claude/commands directory
+  const mainCommandsDir = path.join(languageDir, '.claude', 'commands');
+  if (fs.existsSync(mainCommandsDir)) {
+    const mainCommands = scanCommandsInDirectory(mainCommandsDir, 'core');
+    commands.push(...mainCommands);
+  }
+  
+  // Scan framework-specific commands in examples
+  const examplesDir = path.join(languageDir, 'examples');
+  if (fs.existsSync(examplesDir)) {
+    const frameworkDirs = fs.readdirSync(examplesDir).filter(dir => {
+      return fs.statSync(path.join(examplesDir, dir)).isDirectory();
+    });
+    
+    frameworkDirs.forEach(framework => {
+      const frameworkCommandsDir = path.join(examplesDir, framework, '.claude', 'commands');
+      if (fs.existsSync(frameworkCommandsDir)) {
+        const frameworkCommands = scanCommandsInDirectory(frameworkCommandsDir, framework);
+        commands.push(...frameworkCommands);
+      }
+    });
+  }
+  
+  // Remove duplicates based on command name
+  const uniqueCommands = commands.reduce((acc, command) => {
+    const existing = acc.find(c => c.name === command.name);
+    if (!existing) {
+      acc.push(command);
+    } else {
+      // If duplicate, prefer core commands over framework-specific ones
+      if (command.category === 'core' && existing.category !== 'core') {
+        const index = acc.findIndex(c => c.name === command.name);
+        acc[index] = command;
+      }
+    }
+    return acc;
+  }, []);
+  
+  return uniqueCommands.sort((a, b) => {
+    // Sort by category first (core first), then by name
+    if (a.category !== b.category) {
+      return a.category === 'core' ? -1 : 1;
+    }
+    return a.name.localeCompare(b.name);
+  });
+}
+
+/**
+ * Scans a directory for command files and returns command metadata
+ * @param {string} commandsDir - Directory to scan
+ * @param {string} category - Category of commands (core, react-app, node-api, etc.)
+ * @returns {Array} Array of command objects
+ */
+function scanCommandsInDirectory(commandsDir, category) {
+  const commands = [];
+  
+  try {
+    const files = fs.readdirSync(commandsDir);
+    
+    files.forEach(file => {
+      if (path.extname(file) === '.md') {
+        const commandName = path.basename(file, '.md');
+        const filePath = path.join(commandsDir, file);
+        
+        // Read the command file to extract metadata
+        const content = fs.readFileSync(filePath, 'utf8');
+        const metadata = parseCommandMetadata(content, commandName);
+        
+        commands.push({
+          name: commandName,
+          displayName: metadata.title || commandName,
+          description: metadata.description || `${commandName} command`,
+          category: category,
+          filePath: filePath,
+          checked: metadata.defaultChecked || false
+        });
+      }
+    });
+  } catch (error) {
+    console.warn(`Warning: Could not scan commands in ${commandsDir}:`, error.message);
+  }
+  
+  return commands;
+}
+
+/**
+ * Parses command metadata from markdown file content
+ * @param {string} content - The markdown content
+ * @param {string} commandName - The command name
+ * @returns {Object} Parsed metadata
+ */
+function parseCommandMetadata(content, commandName) {
+  const metadata = {
+    title: null,
+    description: null,
+    defaultChecked: false
+  };
+  
+  const lines = content.split('\n');
+  
+  // Extract title from first heading
+  for (let i = 0; i < Math.min(lines.length, 10); i++) {
+    const line = lines[i].trim();
+    if (line.startsWith('# ')) {
+      metadata.title = line.substring(2).trim();
+      break;
+    }
+  }
+  
+  // Extract description from purpose section or first paragraph
+  const purposeMatch = content.match(/## Purpose\s*\n\s*(.+?)(?=\n\n|\n##|$)/s);
+  if (purposeMatch) {
+    metadata.description = purposeMatch[1].trim().replace(/\n/g, ' ');
+  } else {
+    // Try to find first paragraph after title
+    const paragraphMatch = content.match(/^#[^\n]*\n\s*\n(.+?)(?=\n\n|\n##|$)/s);
+    if (paragraphMatch) {
+      metadata.description = paragraphMatch[1].trim().replace(/\n/g, ' ');
+    }
+  }
+  
+  // Determine default checked state (core commands usually checked by default)
+  const coreCommands = ['test', 'lint', 'debug', 'refactor'];
+  metadata.defaultChecked = coreCommands.includes(commandName);
+  
+  return metadata;
+}
+
+/**
+ * Get commands available for a specific language and framework combination
+ * @param {string} language - The language template
+ * @param {string} framework - The framework (optional)
+ * @returns {Array} Array of available commands
+ */
+function getCommandsForLanguageAndFramework(language, framework = null) {
+  const allCommands = getAvailableCommands(language);
+  
+  if (!framework || framework === 'none') {
+    // Return only core commands
+    return allCommands.filter(cmd => cmd.category === 'core');
+  }
+  
+  // Return core commands + framework-specific commands
+  return allCommands.filter(cmd => 
+    cmd.category === 'core' || 
+    cmd.category === framework ||
+    cmd.category === `${framework}-app`
+  );
+}
+
+module.exports = {
+  getAvailableCommands,
+  getCommandsForLanguageAndFramework,
+  scanCommandsInDirectory,
+  parseCommandMetadata
+};

package/src/file-operations.js

@@ -23,19 +23,51 @@ async function copyTemplateFiles(templateConfig, targetDir) {
     console.log(chalk.yellow(`📁 Existing .claude directory backed up to .claude.backup`));
   }
   
-  // Copy files
+  // Copy base files (but skip .claude/commands for now)
   for (const file of templateConfig.files) {
     const sourcePath = path.join(templateDir, file.source);
     const destPath = path.join(targetDir, file.destination);
     
     try {
-      await fs.copy(sourcePath, destPath, { overwrite: true });
+      // Skip .claude/commands directories - we'll handle them separately
+      if (file.source.includes('.claude/commands')) {
+        continue;
+      }
+      
+      await fs.copy(sourcePath, destPath, { 
+        overwrite: true,
+        filter: (src) => {
+          // Skip commands directory during base copy
+          return !src.includes('.claude/commands');
+        }
+      });
       console.log(chalk.green(`✓ Copied ${file.source} → ${file.destination}`));
     } catch (error) {
       console.error(chalk.red(`✗ Failed to copy ${file.source}:`), error.message);
       throw error;
     }
   }
+  
+  // Copy selected commands individually
+  if (templateConfig.selectedCommands && templateConfig.selectedCommands.length > 0) {
+    const commandsDir = path.join(targetDir, '.claude', 'commands');
+    await fs.ensureDir(commandsDir);
+    
+    for (const command of templateConfig.selectedCommands) {
+      try {
+        const commandFileName = `${command.name}.md`;
+        const destPath = path.join(commandsDir, commandFileName);
+        
+        await fs.copy(command.filePath, destPath);
+        console.log(chalk.green(`✓ Added command: ${command.displayName}`));
+      } catch (error) {
+        console.error(chalk.red(`✗ Failed to copy command ${command.name}:`), error.message);
+        // Don't throw - continue with other commands
+      }
+    }
+    
+    console.log(chalk.cyan(`📋 Installed ${templateConfig.selectedCommands.length} commands`));
+  }
 }
 
 async function ensureDirectoryExists(dirPath) {

package/src/prompts.js

@@ -1,5 +1,6 @@
 const chalk = require('chalk');
 const { getAvailableLanguages, getFrameworksForLanguage } = require('./templates');
+const { getCommandsForLanguageAndFramework } = require('./command-scanner');
 
 function createPrompts(projectInfo, options = {}) {
   const prompts = [];
@@ -41,6 +42,40 @@ function createPrompts(projectInfo, options = {}) {
     });
   }
   
+  // Command selection
+  prompts.push({
+    type: 'checkbox',
+    name: 'commands',
+    message: 'Select commands to include (use space to select):',
+    choices: (answers) => {
+      const selectedLanguage = answers.language || options.language;
+      const selectedFramework = answers.framework || options.framework;
+      
+      if (!selectedLanguage || selectedLanguage === 'common') {
+        return [
+          {
+            value: 'basic-commands',
+            name: 'Basic development commands',
+            checked: true
+          }
+        ];
+      }
+      
+      const availableCommands = getCommandsForLanguageAndFramework(selectedLanguage, selectedFramework);
+      
+      return availableCommands.map(cmd => ({
+        value: cmd.name,
+        name: `${cmd.displayName} - ${cmd.description}`,
+        checked: cmd.checked
+      }));
+    },
+    prefix: chalk.cyan('📋'),
+    when: (answers) => {
+      const selectedLanguage = answers.language || options.language;
+      return selectedLanguage && selectedLanguage !== 'common';
+    }
+  });
+
   // Features selection
   prompts.push({
     type: 'checkbox',
@@ -78,7 +113,18 @@ function createPrompts(projectInfo, options = {}) {
     message: (answers) => {
       const language = answers.language || options.language || 'common';
       const framework = answers.framework || options.framework || 'none';
-      return `Setup Claude Code for ${chalk.cyan(language)}${framework !== 'none' ? ` with ${chalk.green(framework)}` : ''}?`;
+      const commandCount = answers.commands ? answers.commands.length : 0;
+      
+      let message = `Setup Claude Code for ${chalk.cyan(language)}`;
+      if (framework !== 'none') {
+        message += ` with ${chalk.green(framework)}`;
+      }
+      if (commandCount > 0) {
+        message += ` (${chalk.yellow(commandCount)} commands)`;
+      }
+      message += '?';
+      
+      return message;
     },
     default: true,
     prefix: chalk.red('🚀')

package/src/templates.js

@@ -1,4 +1,5 @@
 const path = require('path');
+const { getCommandsForLanguageAndFramework } = require('./command-scanner');
 
 const TEMPLATES_CONFIG = {
   'common': {
@@ -101,7 +102,7 @@ function getFrameworksForLanguage(language) {
 }
 
 function getTemplateConfig(selections) {
-  const { language, framework } = selections;
+  const { language, framework, commands = [] } = selections;
   const baseConfig = TEMPLATES_CONFIG[language];
   
   if (!baseConfig) {
@@ -118,10 +119,18 @@ function getTemplateConfig(selections) {
     }
   }
   
+  // Handle command selection
+  let selectedCommands = [];
+  if (commands && commands.length > 0) {
+    const availableCommands = getCommandsForLanguageAndFramework(language, framework);
+    selectedCommands = availableCommands.filter(cmd => commands.includes(cmd.name));
+  }
+  
   return {
     language,
     framework,
     files,
+    selectedCommands,
     config: baseConfig
   };
 }

package/templates/common/.claude/commands/git-workflow.md

@@ -0,0 +1,239 @@
+# Git Workflow Helper
+
+Manage Git workflows with best practices and common operations.
+
+## Purpose
+
+This command helps you perform common Git operations following best practices for collaborative development.
+
+## Usage
+
+```
+/git-workflow
+```
+
+## What this command does
+
+1. **Guides through Git operations** with proper workflow
+2. **Suggests best practices** for commits and branches
+3. **Helps with conflict resolution** and merging
+4. **Provides templates** for commit messages
+5. **Manages branching strategies** (Git Flow, GitHub Flow)
+
+## Common Workflows
+
+### Feature Development
+```bash
+# Create and switch to feature branch
+git checkout -b feature/user-authentication
+
+# Work on your feature
+# ... make changes ...
+
+# Stage and commit changes
+git add .
+git commit -m "feat: add user authentication system
+
+- Implement login/logout functionality
+- Add password validation
+- Create user session management
+- Add authentication middleware"
+
+# Push feature branch
+git push -u origin feature/user-authentication
+
+# Create pull request (via GitHub/GitLab interface)
+```
+
+### Hotfix Workflow
+```bash
+# Create hotfix branch from main
+git checkout main
+git checkout -b hotfix/security-patch
+
+# Fix the issue
+# ... make changes ...
+
+# Commit the fix
+git commit -m "fix: resolve security vulnerability in auth module
+
+- Patch XSS vulnerability in login form
+- Update input validation
+- Add CSRF protection"
+
+# Push and create urgent PR
+git push -u origin hotfix/security-patch
+```
+
+### Sync with Remote
+```bash
+# Update main branch
+git checkout main
+git pull origin main
+
+# Update feature branch with latest main
+git checkout feature/your-feature
+git rebase main
+# OR
+git merge main
+```
+
+## Commit Message Conventions
+
+### Conventional Commits Format
+```
+<type>[optional scope]: <description>
+
+[optional body]
+
+[optional footer(s)]
+```
+
+### Common Types
+- **feat**: New feature
+- **fix**: Bug fix
+- **docs**: Documentation changes
+- **style**: Code style changes (formatting, etc.)
+- **refactor**: Code refactoring
+- **test**: Adding or updating tests
+- **chore**: Maintenance tasks
+
+### Examples
+```bash
+# Feature
+git commit -m "feat(auth): add OAuth2 integration"
+
+# Bug fix
+git commit -m "fix(api): handle null response in user endpoint"
+
+# Documentation
+git commit -m "docs: update API documentation for v2.0"
+
+# Breaking change
+git commit -m "feat!: change API response format
+
+BREAKING CHANGE: API responses now use 'data' wrapper"
+```
+
+## Branch Management
+
+### Git Flow Strategy
+```bash
+# Main branches
+main        # Production-ready code
+develop     # Integration branch
+
+# Supporting branches
+feature/*   # New features
+release/*   # Release preparation
+hotfix/*    # Quick fixes to production
+```
+
+### GitHub Flow (Simplified)
+```bash
+# Only main branch + feature branches
+main        # Production-ready code
+feature/*   # All new work
+```
+
+## Conflict Resolution
+
+### When Conflicts Occur
+```bash
+# Start merge/rebase
+git merge feature-branch
+# OR
+git rebase main
+
+# If conflicts occur, Git will list conflicted files
+# Edit each file to resolve conflicts
+
+# Mark conflicts as resolved
+git add conflicted-file.js
+
+# Continue the merge/rebase
+git merge --continue
+# OR
+git rebase --continue
+```
+
+### Conflict Markers
+```javascript
+<<<<<<< HEAD
+// Your current branch code
+const user = getCurrentUser();
+=======
+// Incoming branch code
+const user = getAuthenticatedUser();
+>>>>>>> feature-branch
+```
+
+## Useful Git Commands
+
+### Status and Information
+```bash
+git status                    # Check working directory status
+git log --oneline            # View commit history
+git branch -a                # List all branches
+git remote -v                # List remote repositories
+```
+
+### Undoing Changes
+```bash
+git checkout -- file.js     # Discard changes to file
+git reset HEAD file.js       # Unstage file
+git reset --soft HEAD~1     # Undo last commit (keep changes)
+git reset --hard HEAD~1     # Undo last commit (discard changes)
+```
+
+### Stashing Work
+```bash
+git stash                    # Save current work
+git stash pop               # Apply and remove latest stash
+git stash list              # List all stashes
+git stash apply stash@{1}   # Apply specific stash
+```
+
+## Best Practices
+
+1. **Commit Often** - Make small, focused commits
+2. **Write Clear Messages** - Use conventional commit format
+3. **Test Before Committing** - Ensure code works
+4. **Pull Before Push** - Keep history clean
+5. **Use Branches** - Don't work directly on main
+6. **Review Code** - Use pull requests for collaboration
+7. **Keep History Clean** - Rebase feature branches when appropriate
+
+## Git Hooks (Optional)
+
+### Pre-commit Hook
+```bash
+#!/bin/sh
+# .git/hooks/pre-commit
+
+# Run linter
+npm run lint
+if [ $? -ne 0 ]; then
+  echo "Linting failed. Please fix errors before committing."
+  exit 1
+fi
+
+# Run tests
+npm test
+if [ $? -ne 0 ]; then
+  echo "Tests failed. Please fix tests before committing."
+  exit 1
+fi
+```
+
+### Commit Message Hook
+```bash
+#!/bin/sh
+# .git/hooks/commit-msg
+
+# Check commit message format
+if ! grep -qE "^(feat|fix|docs|style|refactor|test|chore)(\(.+\))?: .{1,50}" "$1"; then
+  echo "Invalid commit message format. Use conventional commits."
+  exit 1
+fi
+```