claude-code-templates 1.0.1 → 1.1.0

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/javascript-typescript/.claude/commands/route.md

@@ -0,0 +1,193 @@
+# Route Creator
+
+Create API routes and endpoints for Node.js applications with proper structure and best practices.
+
+## Purpose
+
+This command helps you quickly create new API routes with:
+- RESTful endpoint structure  
+- Proper HTTP method handling
+- Input validation
+- Error handling
+- Documentation comments
+- TypeScript support
+
+## Usage
+
+Use this command to create API routes for your Node.js application:
+
+```
+/route
+```
+
+## What this command does
+
+1. **Analyzes your project structure** to understand your routing setup
+2. **Asks for route details** (endpoint path, HTTP methods, parameters)
+3. **Creates route files** with proper structure and validation
+4. **Generates TypeScript types** for request/response (if TypeScript project)
+5. **Adds proper error handling** and status codes
+6. **Includes documentation** and examples
+
+## Example Output
+
+For a `/users` route, this might create:
+
+### Express.js Route
+```javascript
+// routes/users.js
+const express = require('express');
+const router = express.Router();
+
+// GET /users - Get all users
+router.get('/', async (req, res) => {
+  try {
+    // TODO: Implement user fetching logic
+    const users = [];
+    res.json(users);
+  } catch (error) {
+    res.status(500).json({ error: 'Failed to fetch users' });
+  }
+});
+
+// GET /users/:id - Get user by ID
+router.get('/:id', async (req, res) => {
+  try {
+    const { id } = req.params;
+    // TODO: Implement user fetching by ID
+    const user = {};
+    
+    if (!user) {
+      return res.status(404).json({ error: 'User not found' });
+    }
+    
+    res.json(user);
+  } catch (error) {
+    res.status(500).json({ error: 'Failed to fetch user' });
+  }
+});
+
+// POST /users - Create new user
+router.post('/', async (req, res) => {
+  try {
+    const { name, email } = req.body;
+    
+    // Input validation
+    if (!name || !email) {
+      return res.status(400).json({ 
+        error: 'Name and email are required' 
+      });
+    }
+    
+    // TODO: Implement user creation logic
+    const newUser = { id: Date.now(), name, email };
+    
+    res.status(201).json(newUser);
+  } catch (error) {
+    res.status(500).json({ error: 'Failed to create user' });
+  }
+});
+
+module.exports = router;
+```
+
+### TypeScript Route (if TS project)
+```typescript
+// routes/users.ts
+import { Router, Request, Response } from 'express';
+
+interface User {
+  id: number;
+  name: string;
+  email: string;
+}
+
+interface CreateUserRequest {
+  name: string;
+  email: string;
+}
+
+const router = Router();
+
+// GET /users - Get all users
+router.get('/', async (req: Request, res: Response<User[]>) => {
+  try {
+    // TODO: Implement user fetching logic
+    const users: User[] = [];
+    res.json(users);
+  } catch (error) {
+    res.status(500).json({ error: 'Failed to fetch users' } as any);
+  }
+});
+
+// POST /users - Create new user
+router.post('/', async (req: Request<{}, User, CreateUserRequest>, res: Response<User>) => {
+  try {
+    const { name, email } = req.body;
+    
+    if (!name || !email) {
+      return res.status(400).json({ 
+        error: 'Name and email are required' 
+      } as any);
+    }
+    
+    // TODO: Implement user creation logic
+    const newUser: User = { id: Date.now(), name, email };
+    
+    res.status(201).json(newUser);
+  } catch (error) {
+    res.status(500).json({ error: 'Failed to create user' } as any);
+  }
+});
+
+export default router;
+```
+
+## When to use this command
+
+- **Creating new API endpoints** for your application
+- **Adding CRUD operations** for data models
+- **Building RESTful APIs** with proper structure
+- **Setting up route handlers** with validation and error handling
+- **Generating boilerplate** for API development
+
+## Framework Support
+
+This command adapts to your specific Node.js framework:
+
+### Express.js
+- Creates `routes/` directory structure
+- Uses Express Router
+- Includes middleware support
+- Adds common HTTP methods (GET, POST, PUT, DELETE)
+
+### Fastify
+- Creates Fastify route plugins
+- Includes schema validation
+- Uses Fastify's built-in serialization
+- Adds proper error handling
+
+### NestJS
+- Creates controller classes
+- Includes decorators (@Get, @Post, etc.)
+- Generates DTOs for validation
+- Uses dependency injection
+
+## Best Practices Included
+
+- **Input Validation** - Validates request parameters and body
+- **Error Handling** - Proper try/catch blocks and error responses
+- **Status Codes** - Appropriate HTTP status codes for different scenarios
+- **TypeScript Types** - Strong typing for requests and responses
+- **Documentation** - JSDoc comments explaining each endpoint
+- **Security** - Basic input sanitization and validation
+- **Testing Setup** - Suggests test cases for the new routes
+
+## Tips
+
+1. **Plan your API structure** before creating routes
+2. **Use consistent naming** for endpoints (plural nouns for collections)
+3. **Include proper validation** for all input data
+4. **Add authentication/authorization** where needed
+5. **Test your routes** after creation
+6. **Document your API** for other developers

package/templates/python/.claude/commands/django-model.md

@@ -0,0 +1,124 @@
+# Django Model Generator
+
+Create Django models with proper structure and relationships.
+
+## Purpose
+
+This command helps you quickly create Django models with fields, relationships, and best practices.
+
+## Usage
+
+```
+/django-model
+```
+
+## What this command does
+
+1. **Creates model classes** with proper field definitions
+2. **Adds relationships** (ForeignKey, ManyToMany, OneToOne)
+3. **Includes meta options** and model methods
+4. **Generates migrations** automatically
+5. **Follows Django conventions** and best practices
+
+## Example Output
+
+```python
+# models.py
+from django.db import models
+from django.contrib.auth.models import User
+
+class Category(models.Model):
+    name = models.CharField(max_length=100, unique=True)
+    slug = models.SlugField(unique=True)
+    description = models.TextField(blank=True)
+    created_at = models.DateTimeField(auto_now_add=True)
+    updated_at = models.DateTimeField(auto_now=True)
+    
+    class Meta:
+        verbose_name_plural = "categories"
+        ordering = ['name']
+    
+    def __str__(self):
+        return self.name
+
+class Post(models.Model):
+    STATUS_CHOICES = [
+        ('draft', 'Draft'),
+        ('published', 'Published'),
+        ('archived', 'Archived'),
+    ]
+    
+    title = models.CharField(max_length=200)
+    slug = models.SlugField(unique=True)
+    content = models.TextField()
+    status = models.CharField(max_length=20, choices=STATUS_CHOICES, default='draft')
+    author = models.ForeignKey(User, on_delete=models.CASCADE, related_name='posts')
+    category = models.ForeignKey(Category, on_delete=models.SET_NULL, null=True, blank=True)
+    tags = models.ManyToManyField('Tag', blank=True)
+    created_at = models.DateTimeField(auto_now_add=True)
+    updated_at = models.DateTimeField(auto_now=True)
+    
+    class Meta:
+        ordering = ['-created_at']
+        verbose_name = 'blog post'
+        verbose_name_plural = 'blog posts'
+    
+    def __str__(self):
+        return self.title
+    
+    def get_absolute_url(self):
+        return reverse('post_detail', kwargs={'slug': self.slug})
+
+class Tag(models.Model):
+    name = models.CharField(max_length=50, unique=True)
+    slug = models.SlugField(unique=True)
+    
+    def __str__(self):
+        return self.name
+```
+
+## Field Types Supported
+
+- **CharField** - Text fields with max length
+- **TextField** - Large text fields
+- **IntegerField** - Integer numbers
+- **FloatField** - Floating point numbers
+- **BooleanField** - True/False values
+- **DateField** - Date only
+- **DateTimeField** - Date and time
+- **EmailField** - Email addresses
+- **URLField** - URLs
+- **ImageField** - Image uploads
+- **FileField** - File uploads
+- **JSONField** - JSON data (PostgreSQL)
+
+## Relationships
+
+- **ForeignKey** - One-to-many relationships
+- **ManyToManyField** - Many-to-many relationships
+- **OneToOneField** - One-to-one relationships
+
+## Best Practices Included
+
+- Proper field choices and defaults
+- Appropriate related_name attributes
+- __str__ methods for admin interface
+- Meta class with ordering and verbose names
+- get_absolute_url methods where appropriate
+- Proper use of null and blank parameters
+- Field validation and constraints
+
+## After Creating Models
+
+```bash
+# Create and apply migrations
+python manage.py makemigrations
+python manage.py migrate
+
+# Register in admin (optional)
+# Add to admin.py:
+from django.contrib import admin
+from .models import Post, Category, Tag
+
+admin.site.register([Post, Category, Tag])
+```