claude-code-templates 1.14.13 → 1.14.15

package/README.md

@@ -51,14 +51,14 @@ npx claude-code-templates@latest --health-check
 
 ## 📖 Documentation
 
-**[📚 Complete Documentation](https://aitmpl.com/docu/)** - Comprehensive guides, examples, and API reference
+**[📚 Complete Documentation](https://docs.aitmpl.com/)** - Comprehensive guides, examples, and API reference
 
 Quick links:
-- [Getting Started](https://aitmpl.com/docu/docs/intro) - Installation and first steps
-- [Project Setup](https://aitmpl.com/docu/docs/project-setup/interactive-setup) - Configure your projects
-- [Analytics Dashboard](https://aitmpl.com/docu/docs/analytics/overview) - Real-time monitoring
-- [Individual Components](https://aitmpl.com/docu/docs/components/overview) - Agents, Commands, MCPs
-- [CLI Options](https://aitmpl.com/docu/docs/cli-options) - All available commands
+- [Getting Started](https://docs.aitmpl.com/docs/intro) - Installation and first steps
+- [Project Setup](https://docs.aitmpl.com/docs/project-setup/interactive-setup) - Configure your projects
+- [Analytics Dashboard](https://docs.aitmpl.com/docs/analytics/overview) - Real-time monitoring
+- [Individual Components](https://docs.aitmpl.com/docs/components/overview) - Agents, Commands, MCPs
+- [CLI Options](https://docs.aitmpl.com/docs/cli-options) - All available commands
 
 ## 🤝 Contributing
 
@@ -71,7 +71,7 @@ MIT License - see the [LICENSE](LICENSE) file for details.
 ## 🔗 Links
 
 - **🌐 Browse Components**: [aitmpl.com](https://aitmpl.com)
-- **📚 Documentation**: [aitmpl.com/docu](https://aitmpl.com/docu)
+- **📚 Documentation**: [docs.aitmpl.com](https://docs.aitmpl.com)
 - **🐛 Issues**: [GitHub Issues](https://github.com/davila7/claude-code-templates/issues)
 - **💬 Discussions**: [GitHub Discussions](https://github.com/davila7/claude-code-templates/discussions)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-templates",
-  "version": "1.14.13",
+  "version": "1.14.15",
   "description": "CLI tool to setup Claude Code configurations with framework-specific commands, automation hooks and MCP Servers for your projects",
   "main": "src/index.js",
   "bin": {
@@ -85,7 +85,6 @@
   "files": [
     "bin/",
     "src/",
-    "templates/",
     "README.md"
   ],
   "devDependencies": {

package/src/health-check.js

@@ -16,7 +16,9 @@ class HealthChecker {
       system: [],
       claudeCode: [],
       project: [],
+      agents: [],
       commands: [],
+      mcps: [],
       hooks: []
     };
     this.totalChecks = 0;
@@ -42,6 +44,14 @@ class HealthChecker {
     await this.checkProjectSetupWithSpinner();
     await this.sleep(3000);
     
+    // Agents check
+    await this.checkAgentsWithSpinner();
+    await this.sleep(3000);
+    
+    // MCP servers check
+    await this.checkMCPServersWithSpinner();
+    await this.sleep(3000);
+    
     // Custom commands check
     await this.checkCustomCommandsWithSpinner();
     await this.sleep(3000);
@@ -165,6 +175,54 @@ class HealthChecker {
     localSettingsSpinner.succeed(`${this.getStatusIcon(localSettingsInfo.status)} Local Settings       │ ${localSettingsInfo.message}`);
   }
 
+  /**
+   * Check agents with spinner and immediate results
+   */
+  async checkAgentsWithSpinner() {
+    console.log(chalk.cyan('\n┌──────────┐'));
+    console.log(chalk.cyan('│  AGENTS  │'));
+    console.log(chalk.cyan('└──────────┘'));
+    
+    // Project agents
+    const projectSpinner = ora('Scanning Project Agents...').start();
+    const projectAgents = this.checkProjectAgents();
+    this.addResult('agents', 'Project Agents', projectAgents.status, projectAgents.message);
+    projectSpinner.succeed(`${this.getStatusIcon(projectAgents.status)} Project Agents      │ ${projectAgents.message}`);
+
+    // Personal agents
+    const personalSpinner = ora('Scanning Personal Agents...').start();
+    const personalAgents = this.checkPersonalAgents();
+    this.addResult('agents', 'Personal Agents', personalAgents.status, personalAgents.message);
+    personalSpinner.succeed(`${this.getStatusIcon(personalAgents.status)} Personal Agents     │ ${personalAgents.message}`);
+
+    // Agent syntax validation
+    const syntaxSpinner = ora('Validating Agent Syntax...').start();
+    const syntaxInfo = this.checkAgentSyntax();
+    this.addResult('agents', 'Agent Syntax', syntaxInfo.status, syntaxInfo.message);
+    syntaxSpinner.succeed(`${this.getStatusIcon(syntaxInfo.status)} Agent Syntax        │ ${syntaxInfo.message}`);
+  }
+
+  /**
+   * Check MCP servers with spinner and immediate results
+   */
+  async checkMCPServersWithSpinner() {
+    console.log(chalk.cyan('\n┌──────────────┐'));
+    console.log(chalk.cyan('│  MCP SERVERS │'));
+    console.log(chalk.cyan('└──────────────┘'));
+    
+    // Project MCP configuration
+    const projectMCPSpinner = ora('Scanning Project MCP Configuration...').start();
+    const projectMCP = this.checkProjectMCPConfiguration();
+    this.addResult('mcps', 'Project MCP Config', projectMCP.status, projectMCP.message);
+    projectMCPSpinner.succeed(`${this.getStatusIcon(projectMCP.status)} Project MCP Config   │ ${projectMCP.message}`);
+
+    // MCP configuration validation
+    const mcpValidationSpinner = ora('Validating MCP Configuration...').start();
+    const mcpValidation = this.checkMCPConfigurationSyntax();
+    this.addResult('mcps', 'MCP Config Syntax', mcpValidation.status, mcpValidation.message);
+    mcpValidationSpinner.succeed(`${this.getStatusIcon(mcpValidation.status)} MCP Config Syntax   │ ${mcpValidation.message}`);
+  }
+
   /**
    * Check custom commands with spinner and immediate results
    */
@@ -552,6 +610,123 @@ class HealthChecker {
     }
   }
 
+  checkProjectMCPConfiguration() {
+    const currentDir = process.cwd();
+    const mcpConfigPath = path.join(currentDir, '.mcp.json');
+    
+    if (fs.existsSync(mcpConfigPath)) {
+      try {
+        const mcpConfig = JSON.parse(fs.readFileSync(mcpConfigPath, 'utf8'));
+        
+        if (mcpConfig.mcpServers && typeof mcpConfig.mcpServers === 'object') {
+          const serverCount = Object.keys(mcpConfig.mcpServers).length;
+          return {
+            status: 'pass',
+            message: `${serverCount} MCP servers configured in .mcp.json`
+          };
+        } else {
+          return {
+            status: 'warn',
+            message: 'No mcpServers found in .mcp.json'
+          };
+        }
+      } catch (error) {
+        return {
+          status: 'fail',
+          message: 'Invalid JSON syntax in .mcp.json'
+        };
+      }
+    } else {
+      return {
+        status: 'warn',
+        message: 'No project MCP configuration found (.mcp.json)'
+      };
+    }
+  }
+
+  checkMCPConfigurationSyntax() {
+    const configPaths = [
+      path.join(process.cwd(), '.mcp.json')
+    ];
+    
+    let totalServers = 0;
+    let validServers = 0;
+    let invalidServers = 0;
+    const issues = [];
+    
+    for (const configPath of configPaths) {
+      if (fs.existsSync(configPath)) {
+        try {
+          const mcpConfig = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+          
+          if (mcpConfig.mcpServers && typeof mcpConfig.mcpServers === 'object') {
+            const servers = mcpConfig.mcpServers;
+            
+            for (const [serverName, serverConfig] of Object.entries(servers)) {
+              totalServers++;
+              
+              // Validate server configuration structure
+              if (!serverConfig || typeof serverConfig !== 'object') {
+                invalidServers++;
+                issues.push(`Invalid server config for ${serverName} in ${path.basename(configPath)}`);
+                continue;
+              }
+              
+              // Check required fields
+              if (!serverConfig.command) {
+                invalidServers++;
+                issues.push(`Missing command for ${serverName} in ${path.basename(configPath)}`);
+                continue;
+              }
+              
+              // Optional: Check if args is array when present
+              if (serverConfig.args && !Array.isArray(serverConfig.args)) {
+                invalidServers++;
+                issues.push(`Invalid args format for ${serverName} in ${path.basename(configPath)} (should be array)`);
+                continue;
+              }
+              
+              // Optional: Check if env is object when present
+              if (serverConfig.env && typeof serverConfig.env !== 'object') {
+                invalidServers++;
+                issues.push(`Invalid env format for ${serverName} in ${path.basename(configPath)} (should be object)`);
+                continue;
+              }
+              
+              validServers++;
+            }
+          }
+        } catch (error) {
+          // JSON parsing error already handled in other checks
+        }
+      }
+    }
+    
+    if (totalServers === 0) {
+      return {
+        status: 'warn',
+        message: 'No MCP servers configured'
+      };
+    }
+    
+    if (invalidServers === 0) {
+      return {
+        status: 'pass',
+        message: `All ${totalServers} MCP server configurations are valid`
+      };
+    } else if (validServers > 0) {
+      return {
+        status: 'warn',
+        message: `${validServers}/${totalServers} MCP servers valid, ${invalidServers} issues found`
+      };
+    } else {
+      return {
+        status: 'fail',
+        message: `All ${totalServers} MCP server configurations have issues`
+      };
+    }
+  }
+
   checkProjectCommands() {
     const currentDir = process.cwd();
     const commandsDir = path.join(currentDir, '.claude', 'commands');
@@ -625,6 +800,129 @@ class HealthChecker {
     }
   }
 
+  checkProjectAgents() {
+    const currentDir = process.cwd();
+    const agentsDir = path.join(currentDir, '.claude', 'agents');
+    
+    if (fs.existsSync(agentsDir)) {
+      const agents = this.countAgentsRecursively(agentsDir);
+      return {
+        status: 'pass',
+        message: `${agents} agents found in .claude/agents/`
+      };
+    } else {
+      return {
+        status: 'warn',
+        message: 'No project agents directory found'
+      };
+    }
+  }
+
+  checkPersonalAgents() {
+    const homeDir = os.homedir();
+    const agentsDir = path.join(homeDir, '.claude', 'agents');
+    
+    if (fs.existsSync(agentsDir)) {
+      const agents = this.countAgentsRecursively(agentsDir);
+      return {
+        status: 'pass',
+        message: `${agents} agents found in ~/.claude/agents/`
+      };
+    } else {
+      return {
+        status: 'warn',
+        message: 'No personal agents directory found'
+      };
+    }
+  }
+
+  countAgentsRecursively(dir) {
+    let count = 0;
+    try {
+      const items = fs.readdirSync(dir);
+      for (const item of items) {
+        const itemPath = path.join(dir, item);
+        const stat = fs.statSync(itemPath);
+        if (stat.isDirectory()) {
+          count += this.countAgentsRecursively(itemPath);
+        } else if (item.endsWith('.md')) {
+          count++;
+        }
+      }
+    } catch (error) {
+      // Handle permission or access errors
+    }
+    return count;
+  }
+
+  checkAgentSyntax() {
+    const currentDir = process.cwd();
+    const agentsDir = path.join(currentDir, '.claude', 'agents');
+    
+    if (!fs.existsSync(agentsDir)) {
+      return {
+        status: 'warn',
+        message: 'No agents to validate'
+      };
+    }
+    
+    const agents = this.getAgentFilesRecursively(agentsDir);
+    let issuesFound = 0;
+    let agentsChecked = 0;
+    
+    for (const agentPath of agents) {
+      try {
+        const content = fs.readFileSync(agentPath, 'utf8');
+        agentsChecked++;
+        
+        // Check for frontmatter (agent metadata)
+        if (!content.includes('---') || !content.includes('name:') || !content.includes('description:')) {
+          issuesFound++;
+        }
+      } catch (error) {
+        issuesFound++;
+      }
+    }
+    
+    if (agentsChecked === 0) {
+      return {
+        status: 'warn',
+        message: 'No agents to validate'
+      };
+    }
+    
+    if (issuesFound === 0) {
+      return {
+        status: 'pass',
+        message: `All ${agentsChecked} agents have proper syntax`
+      };
+    } else {
+      return {
+        status: 'warn',
+        message: `${issuesFound}/${agentsChecked} agents missing proper frontmatter`
+      };
+    }
+  }
+
+  getAgentFilesRecursively(dir) {
+    let files = [];
+    try {
+      const items = fs.readdirSync(dir);
+      for (const item of items) {
+        const itemPath = path.join(dir, item);
+        const stat = fs.statSync(itemPath);
+        if (stat.isDirectory()) {
+          files = files.concat(this.getAgentFilesRecursively(itemPath));
+        } else if (item.endsWith('.md')) {
+          files.push(itemPath);
+        }
+      }
+    } catch (error) {
+      // Handle permission or access errors
+    }
+    return files;
+  }
+
   checkUserHooks() {
     const homeDir = os.homedir();
     const settingsPath = path.join(homeDir, '.claude', 'settings.json');
@@ -1041,7 +1339,9 @@ class HealthChecker {
       ...this.results.system,
       ...this.results.claudeCode,
       ...this.results.project,
+      ...this.results.agents,
       ...this.results.commands,
+      ...this.results.mcps,
       ...this.results.hooks
     ];
     
@@ -1052,6 +1352,16 @@ class HealthChecker {
           recommendations.push('Consider switching to Zsh for better autocompletion and features');
         } else if (result.check === 'Command Syntax' && result.message.includes('$ARGUMENTS')) {
           recommendations.push('Add $ARGUMENTS placeholder to command files for proper parameter handling');
+        } else if (result.check === 'Agent Syntax' && result.message.includes('frontmatter')) {
+          recommendations.push('Add proper frontmatter (name, description) to agent files');
+        } else if (result.check === 'Project Agents' && result.message.includes('No project agents directory')) {
+          recommendations.push('Create .claude/agents/ directory to organize your custom agents');
+        } else if (result.check === 'Project MCP Config' && result.message.includes('No project MCP configuration')) {
+          recommendations.push('Create .mcp.json file to configure MCP servers for your project');
+        } else if (result.check === 'MCP Config Syntax' && result.message.includes('Invalid JSON')) {
+          recommendations.push('Fix JSON syntax errors in MCP configuration files');
+        } else if (result.check === 'MCP Config Syntax' && result.message.includes('Missing command')) {
+          recommendations.push('Add missing command fields to MCP server configurations');
         } else if (result.check === 'Local Hooks' && result.message.includes('Invalid JSON')) {
           recommendations.push('Fix JSON syntax error in .claude/settings.local.json');
         }

package/src/index.js

@@ -271,7 +271,7 @@ async function createClaudeConfig(options = {}) {
   console.log(chalk.white('  3. Start using Claude Code with: claude'));
   console.log('');
   console.log(chalk.blue('🌐 View all available templates at: https://aitmpl.com/'));
-  console.log(chalk.blue('📖 Read the complete documentation at: https://aitmpl.com/docu/'));
+  console.log(chalk.blue('📖 Read the complete documentation at: https://docs.aitmpl.com/'));
   
   if (config.language !== 'common') {
     console.log(chalk.yellow(`💡 Language-specific features for ${config.language} have been configured`));

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

@@ -1,239 +0,0 @@
-# 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
-```