claude-code-templates 1.3.2 → 1.3.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-templates",
-  "version": "1.3.2",
+  "version": "1.3.3",
   "description": "CLI tool to setup Claude Code configurations with framework-specific commands and automation hooks for JavaScript/TypeScript and Python projects",
   "main": "src/index.js",
   "bin": {
@@ -69,6 +69,7 @@
   "files": [
     "bin/",
     "src/",
+    "templates/",
     "README.md"
   ]
 }

package/src/command-scanner.js

@@ -7,7 +7,7 @@ const path = require('path');
  * @returns {Array} Array of available commands with metadata
  */
 function getAvailableCommands(language) {
-  const templatesDir = path.join(__dirname, '../../');
+  const templatesDir = path.join(__dirname, '../templates');
   const languageDir = path.join(templatesDir, language);
   
   // Check if language directory exists

package/src/file-operations.js

@@ -4,7 +4,7 @@ const chalk = require('chalk');
 const { getHooksForLanguage, filterHooksBySelection, getMCPsForLanguage, filterMCPsBySelection } = require('./hook-scanner');
 
 async function copyTemplateFiles(templateConfig, targetDir) {
-  const templateDir = path.join(__dirname, '../../');
+  const templateDir = path.join(__dirname, '../templates');
   
   // Check if CLAUDE.md already exists
   const claudeFile = path.join(targetDir, 'CLAUDE.md');

package/src/hook-scanner.js

@@ -267,7 +267,7 @@ function getHookDescription(hook, matcher, type) {
  * @returns {Array} Array of available hooks for the language
  */
 function getHooksForLanguage(language) {
-  const templateDir = path.join(__dirname, '../../', language);
+  const templateDir = path.join(__dirname, '../templates', language);
   const settingsPath = path.join(templateDir, '.claude', 'settings.json');
   
   return getHooksFromSettings(settingsPath);
@@ -399,7 +399,7 @@ function getDefaultMCPSelection(serverId) {
  * @returns {Array} Array of available MCPs for the language
  */
 function getMCPsForLanguage(language) {
-  const templateDir = path.join(__dirname, '../../', language);
+  const templateDir = path.join(__dirname, '../templates', language);
   const mcpPath = path.join(templateDir, '.mcp.json');
   
   return getMCPsFromFile(mcpPath);

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
+```

package/templates/common/.claude/commands/project-setup.md

@@ -0,0 +1,316 @@
+# Project Setup Helper
+
+Set up new projects with proper structure and best practices.
+
+## Purpose
+
+This command helps you set up new projects with proper directory structure, configuration files, and development environment.
+
+## Usage
+
+```
+/project-setup
+```
+
+## What this command does
+
+1. **Creates project structure** with standard directories
+2. **Sets up configuration files** (.gitignore, README, etc.)
+3. **Initializes version control** and development tools
+4. **Configures environment files** and dependencies
+5. **Follows language-specific** conventions and best practices
+
+## Project Structure Templates
+
+### Generic Project Structure
+```
+project-name/
+├── README.md                 # Project documentation
+├── .gitignore               # Git ignore rules
+├── .env.example             # Environment variables template
+├── LICENSE                  # Project license
+├── CHANGELOG.md             # Version history
+├── docs/                    # Documentation
+│   ├── API.md
+│   ├── CONTRIBUTING.md
+│   └── DEPLOYMENT.md
+├── src/                     # Source code
+│   ├── main/
+│   ├── utils/
+│   └── config/
+├── tests/                   # Test files
+│   ├── unit/
+│   ├── integration/
+│   └── fixtures/
+├── scripts/                 # Build and deployment scripts
+│   ├── build.sh
+│   ├── deploy.sh
+│   └── setup.sh
+└── config/                  # Configuration files
+    ├── development.yml
+    ├── production.yml
+    └── testing.yml
+```
+
+### Web Application Structure
+```
+web-app/
+├── public/                  # Static assets
+│   ├── index.html
+│   ├── favicon.ico
+│   └── assets/
+│       ├── css/
+│       ├── js/
+│       └── images/
+├── src/                     # Source code
+│   ├── components/          # Reusable components
+│   ├── pages/              # Page components
+│   ├── services/           # API services
+│   ├── utils/              # Utility functions
+│   ├── styles/             # Stylesheets
+│   └── config/             # Configuration
+├── tests/                   # Test files
+└── build/                   # Build output
+```
+
+### API Project Structure
+```
+api-project/
+├── src/
+│   ├── controllers/         # Request handlers
+│   ├── models/             # Data models
+│   ├── services/           # Business logic
+│   ├── middleware/         # Custom middleware
+│   ├── routes/             # API routes
+│   ├── utils/              # Utility functions
+│   └── config/             # Configuration
+├── tests/
+│   ├── unit/
+│   ├── integration/
+│   └── e2e/
+├── docs/
+│   ├── api-spec.yml        # OpenAPI specification
+│   └── README.md
+└── scripts/
+    ├── seed-db.js          # Database seeding
+    └── migrate.js          # Database migrations
+```
+
+## Essential Configuration Files
+
+### .gitignore Template
+```gitignore
+# Dependencies
+node_modules/
+*.log
+npm-debug.log*
+
+# Environment files
+.env
+.env.local
+.env.production
+
+# Build outputs
+dist/
+build/
+*.tgz
+
+# IDE files
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# Temporary files
+*.tmp
+*.temp
+```
+
+### README.md Template
+```markdown
+# Project Name
+
+Brief description of what this project does.
+
+## Features
+
+- Feature 1
+- Feature 2
+- Feature 3
+
+## Installation
+
+\`\`\`bash
+# Clone the repository
+git clone https://github.com/username/project-name.git
+
+# Install dependencies
+npm install
+
+# Copy environment file
+cp .env.example .env
+\`\`\`
+
+## Usage
+
+\`\`\`bash
+# Start development server
+npm run dev
+
+# Run tests
+npm test
+
+# Build for production
+npm run build
+\`\`\`
+
+## API Documentation
+
+[API documentation](docs/API.md)
+
+## Contributing
+
+Please read [CONTRIBUTING.md](docs/CONTRIBUTING.md) for details.
+
+## License
+
+This project is licensed under the MIT License - see [LICENSE](LICENSE) file.
+```
+
+### .env.example Template
+```env
+# Application
+NODE_ENV=development
+PORT=3000
+HOST=localhost
+
+# Database
+DB_HOST=localhost
+DB_PORT=5432
+DB_NAME=myapp
+DB_USER=username
+DB_PASSWORD=password
+
+# API Keys
+API_KEY=your-api-key-here
+SECRET_KEY=your-secret-key-here
+
+# External Services
+REDIS_URL=redis://localhost:6379
+EMAIL_SERVICE_API_KEY=your-email-key
+```
+
+## Development Environment Setup
+
+### Package.json Scripts
+```json
+{
+  "scripts": {
+    "start": "node src/index.js",
+    "dev": "nodemon src/index.js",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "lint": "eslint src/",
+    "lint:fix": "eslint src/ --fix",
+    "format": "prettier --write src/",
+    "build": "webpack --mode production",
+    "build:dev": "webpack --mode development",
+    "clean": "rm -rf dist/"
+  }
+}
+```
+
+### Git Initialization
+```bash
+# Initialize Git repository
+git init
+
+# Add initial files
+git add .
+
+# Create initial commit
+git commit -m "feat: initial project setup
+
+- Add project structure
+- Configure development environment
+- Add documentation templates
+- Set up testing framework"
+
+# Add remote origin
+git remote add origin https://github.com/username/project-name.git
+
+# Push to remote
+git push -u origin main
+```
+
+## Language-Specific Setup
+
+### Node.js/JavaScript
+```bash
+npm init -y
+npm install --save-dev nodemon jest eslint prettier
+```
+
+### Python
+```bash
+python -m venv venv
+source venv/bin/activate  # On Windows: venv\Scripts\activate
+pip install -r requirements.txt
+```
+
+### Docker Setup
+```dockerfile
+# Dockerfile
+FROM node:16-alpine
+WORKDIR /app
+COPY package*.json ./
+RUN npm install
+COPY . .
+EXPOSE 3000
+CMD ["npm", "start"]
+```
+
+```yaml
+# docker-compose.yml
+version: '3.8'
+services:
+  app:
+    build: .
+    ports:
+      - "3000:3000"
+    environment:
+      - NODE_ENV=development
+    volumes:
+      - .:/app
+      - /app/node_modules
+```
+
+## Best Practices
+
+1. **Consistent Structure** - Follow established conventions
+2. **Clear Documentation** - Write comprehensive README
+3. **Environment Variables** - Keep secrets out of code
+4. **Version Control** - Initialize Git from the start
+5. **Testing Setup** - Configure testing from day one
+6. **Code Quality** - Set up linting and formatting
+7. **CI/CD Ready** - Structure for automated deployment
+8. **Security** - Include security best practices
+
+## Checklist
+
+- [ ] Create project directory structure
+- [ ] Initialize version control (Git)
+- [ ] Set up package manager (npm, pip, etc.)
+- [ ] Create README.md with project info
+- [ ] Add .gitignore file
+- [ ] Set up environment variables
+- [ ] Configure linting and formatting
+- [ ] Set up testing framework
+- [ ] Create basic documentation
+- [ ] Add license file
+- [ ] Set up CI/CD configuration (if needed)

package/templates/common/.mcp.json

@@ -0,0 +1,41 @@
+{
+  "mcpServers": {
+    "memory-bank": {
+      "name": "Memory Bank MCP",
+      "description": "Centralized memory system for AI agents",
+      "command": "server-memory",
+      "args": [],
+      "env": {}
+    },
+    "sequential-thinking": {
+      "name": "Sequential Thinking MCP",
+      "description": "Helps LLMs decompose complex tasks into logical steps",
+      "command": "code-reasoning",
+      "args": [],
+      "env": {}
+    },
+    "brave-search": {
+      "name": "Brave Search MCP",
+      "description": "Privacy-focused web search tool",
+      "command": "server-brave-search",
+      "args": [],
+      "env": {}
+    },
+    "google-maps": {
+      "name": "Google Maps MCP",
+      "description": "Integrates Google Maps for geolocation and directions",
+      "command": "server-google-maps",
+      "args": [],
+      "env": {
+        "GOOGLE_MAPS_API_KEY": "..."
+      }
+    },
+    "deep-graph": {
+      "name": "Deep Graph MCP (Code Graph)",
+      "description": "Transforms source code into semantic graphs via DeepGraph",
+      "command": "mcp-code-graph",
+      "args": [],
+      "env": {}
+    }
+  }
+}