npm - claude-code-templates - Versions diffs - 1.21.1 → 1.21.3 - Mend

claude-code-templates 1.21.1 → 1.21.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (743) hide show

package/cli-tool/README.md DELETED Viewed

@@ -1,126 +0,0 @@
-[![npm version](https://img.shields.io/npm/v/claude-code-templates.svg)](https://www.npmjs.com/package/claude-code-templates)
-[![npm downloads](https://img.shields.io/npm/dt/claude-code-templates.svg)](https://www.npmjs.com/package/claude-code-templates)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Open Source](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://opensource.org/)
-[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/davila7/claude-code-templates/blob/main/CONTRIBUTING.md)
-[![GitHub stars](https://img.shields.io/github/stars/davila7/claude-code-templates.svg?style=social&label=Star)](https://github.com/davila7/claude-code-templates)
-# Claude Code Templates
-**CLI tool for configuring and monitoring Claude Code** - Quick setup for any project with framework-specific commands and real-time monitoring dashboard.
-## 🚀 Quick Start
-```bash
-# Interactive setup (recommended)
-npx claude-code-templates@latest
-# Real-time analytics dashboard
-npx claude-code-templates@latest --analytics
-# System health check
-npx claude-code-templates@latest --health-check
-```
-## ✨ Core Features
-- **📋 Smart Project Setup** - Auto-detect and configure any project with framework-specific commands
-- **📊 Real-time Analytics** - Monitor Claude Code sessions with live state detection and performance metrics
-- **🔍 Health Check** - Comprehensive system validation with actionable recommendations
-- **🧩 Individual Components** - Install specialized agents, commands, and MCPs individually
-- **🌍 Global Agents** - Create AI agents accessible from anywhere using Claude Code SDK
-## 🎯 What You Get
-| Component | Description | Example |
-|-----------|-------------|---------|
-| **CLAUDE.md** | Project-specific Claude Code configuration | Framework best practices, coding standards |
-| **Commands** | Custom slash commands for development tasks | `/generate-tests`, `/check-file`, `/optimize-bundle` |
-| **Agents** | AI specialists for specific domains | API security audit, React performance, database optimization |
-| **MCPs** | External service integrations | GitHub, databases, development tools |
-| **Analytics** | Real-time monitoring dashboard | Live session tracking, usage statistics, exports |
-## 🛠️ Supported Technologies
-| Language | Frameworks | Status |
-|----------|------------|---------|
-| **JavaScript/TypeScript** | React, Vue, Angular, Node.js | ✅ Ready |
-| **Python** | Django, Flask, FastAPI | ✅ Ready |
-| **Common** | Universal configurations | ✅ Ready |
-| **Go** | Gin, Echo, Fiber | 🚧 Coming Soon |
-| **Rust** | Axum, Warp, Actix | 🚧 Coming Soon |
-## 🌍 Global Agents (Claude Code SDK Integration)
-Create AI agents that can be executed from anywhere using the Claude Code SDK:
-```bash
-# Create a global agent (one-time setup)
-npx claude-code-templates@latest --create-agent customer-support
-# Use the agent from anywhere
-customer-support "Help me with ticket #12345"
-sre-logs "Analyze error patterns in app.log"
-code-reviewer "Review this PR for security issues"
-```
-### Available Global Agents
-| Agent | Usage | Description |
-|-------|-------|-------------|
-| `customer-support` | `customer-support "query"` | AI customer support specialist |
-| `api-security-audit` | `api-security-audit "analyze endpoints"` | Security auditing for APIs |
-| `react-performance-optimization` | `react-performance-optimization "optimize components"` | React performance expert |
-| `database-optimization` | `database-optimization "improve queries"` | Database performance tuning |
-### Global Agent Management
-```bash
-# List installed global agents
-npx claude-code-templates@latest --list-agents
-# Update an agent to latest version
-npx claude-code-templates@latest --update-agent customer-support
-# Remove an agent
-npx claude-code-templates@latest --remove-agent customer-support
-```
-### How It Works
-1. **Download Agent**: Fetches the latest agent from GitHub
-2. **Generate Executable**: Creates a Node.js script that calls Claude Code SDK
-3. **Add to PATH**: Makes the agent available globally in your shell
-4. **Ready to Use**: Execute `agent-name "your prompt"` from any directory
-The agents use the Claude Code SDK internally to provide specialized AI assistance with domain-specific knowledge and best practices.
-## 📖 Documentation
-**[📚 Complete Documentation](https://docs.aitmpl.com/)** - Comprehensive guides, examples, and API reference
-Quick links:
-- [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
-We welcome contributions! Browse available templates and components at **[aitmpl.com](https://aitmpl.com)**, then check our [contributing guidelines](https://github.com/davila7/claude-code-templates/blob/main/CONTRIBUTING.md).
-## 📄 License
-MIT License - see the [LICENSE](LICENSE) file for details.
-## 🔗 Links
-- **🌐 Browse Components**: [aitmpl.com](https://aitmpl.com)
-- **📚 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)
----
-**⭐ Found this useful? Give us a star to support the project!**

package/cli-tool/TESTING.md DELETED Viewed

@@ -1,262 +0,0 @@
-# Testing Guide for claude-code-templates
-This guide explains how to test the `claude-code-templates` CLI tool before publishing.
-## Quick Start
-```bash
-# Install for local testing
-npm run dev:link
-# Run basic tests
-npm test
-# Run detailed tests
-npm run test:detailed
-# Test specific frameworks
-npm run test:react
-npm run test:vue
-npm run test:node
-# Uninstall when done
-npm run dev:unlink
-```
-## Testing Methods
-### 1. **NPM Scripts (Recommended)**
-```bash
-# Basic test suite
-npm test
-# Detailed testing with all scenarios
-npm run test:detailed
-# Test specific frameworks
-npm run test:react    # Test React setup
-npm run test:vue      # Test Vue setup
-npm run test:node     # Test Node.js setup
-# Full test suite
-npm run test:all
-```
-### 2. **Makefile Commands**
-```bash
-# Install for testing
-make install-dev
-# Run specific tests
-make test-basic       # Basic functionality
-make test-detailed    # Comprehensive tests
-make test-react       # React scenario
-make test-vue         # Vue scenario
-make test-node        # Node.js scenario
-# Interactive testing (manual)
-make test-interactive
-# Full pre-publish check
-make pre-publish
-# Cleanup
-make uninstall-dev
-```
-### 3. **Manual Testing**
-```bash
-# Link package locally
-npm link
-# Test different scenarios manually
-claude-code-templates --help
-claude-code-templates --version
-claude-code-templates --dry-run
-claude-code-templates --language javascript-typescript --framework react --yes
-claude-code-templates --language common --yes
-# Test in different directories
-mkdir test-project && cd test-project
-claude-code-templates --language javascript-typescript --framework vue --yes
-ls -la  # Check created files
-# Cleanup
-npm unlink -g claude-code-templates
-```
-### 4. **Direct Node Execution**
-```bash
-# Test without installing globally
-node bin/create-claude-config.js --help
-node bin/create-claude-config.js --dry-run --language javascript-typescript --framework react --yes
-```
-## Test Coverage
-### Automated Tests Include:
-- ✅ **Command Variants**: All CLI aliases work
-- ✅ **Help & Version**: Basic commands respond correctly
-- ✅ **Language Support**: JavaScript/TypeScript, Common, Python, Rust, Go
-- ✅ **Framework Support**: React, Vue, Angular, Node.js, None
-- ✅ **File Creation**: CLAUDE.md, .claude directory, settings.json
-- ✅ **Framework Commands**: Framework-specific commands are created
-- ✅ **Dry Run Mode**: Preview mode works without creating files
-- ✅ **Error Handling**: Invalid languages/frameworks are rejected
-### Framework-Specific Tests:
-**React:**
-- Component creation commands
-- Hooks management commands
-- State management helpers
-**Vue.js:**
-- Component creation commands
-- Composables helpers
-- Vue 3 patterns
-**Angular:**
-- Component generation
-- Service creation
-- Dependency injection patterns
-**Node.js:**
-- API endpoint creation
-- Middleware helpers
-- Database integration
-## Pre-Publish Checklist
-Before publishing a new version, run:
-```bash
-# Full automated test suite
-npm run test:all
-# Manual verification
-make test-interactive
-# Test in fresh environment
-make pre-publish
-```
-### Manual Verification Steps:
-1. **Interactive Flow**: Start `claude-code-templates` without flags and go through the full interactive setup
-2. **Error Scenarios**: Test invalid inputs and edge cases
-3. **File Content**: Verify that created files have correct content
-4. **Framework Detection**: Test in projects with existing package.json files
-5. **Permissions**: Test in different directory permission scenarios
-## Continuous Integration
-The `prepublishOnly` script automatically runs tests before publishing:
-```json
-{
-  "scripts": {
-    "prepublishOnly": "npm run sync && npm run test"
-  }
-}
-```
-This ensures that:
-- Templates are synchronized
-- All tests pass
-- Package is ready for publication
-## Test Environments
-### Local Development
-```bash
-npm run dev:link    # Install locally
-# ... test commands ...
-npm run dev:unlink  # Remove when done
-```
-### CI/CD Pipeline
-```bash
-npm ci              # Clean install
-npm test           # Run test suite
-npm run build      # If applicable
-```
-### Production Testing
-```bash
-# Test published version
-npx claude-code-templates@latest --version
-npx claude-code-templates@latest --help
-```
-## Debugging Tests
-### Verbose Output
-```bash
-# Add verbose flag to see detailed output
-claude-code-templates --language javascript-typescript --framework react --dry-run --yes --verbose
-```
-### Test Specific Scenarios
-```bash
-# Create isolated test environment
-mkdir /tmp/test-claude && cd /tmp/test-claude
-claude-code-templates --language javascript-typescript --framework react --yes
-ls -la .claude/commands/
-cat CLAUDE.md
-```
-### Check Generated Files
-```bash
-# Verify file content
-find .claude -name "*.md" -exec echo "=== {} ===" \; -exec cat {} \;
-```
-## Common Issues & Solutions
-### Permission Errors
-```bash
-# If npm link fails due to permissions
-sudo npm link  # Use with caution
-# Or use local npm prefix
-npm config set prefix ~/.npm-global
-```
-### Command Not Found
-```bash
-# If linked command isn't found
-which claude-code-templates
-echo $PATH
-# May need to add npm global bin to PATH
-```
-### Template Sync Issues
-```bash
-# Force sync before testing
-npm run sync
-```
-## Contributing Tests
-When adding new features, also add tests:
-1. Update `test-commands.sh` for basic scenarios
-2. Update `test-detailed.sh` for comprehensive coverage
-3. Add Makefile targets for specific test cases
-4. Update this README with new test procedures
-## Test File Structure
-```
-cli-tool/
-├── test-commands.sh      # Basic test suite
-├── test-detailed.sh      # Comprehensive tests
-├── Makefile             # Test automation
-├── TESTING.md           # This guide
-└── package.json         # NPM test scripts
-```

package/cli-tool/components/agents/ai-specialists/ai-ethics-advisor.md DELETED Viewed

@@ -1,195 +0,0 @@
----
-name: ai-ethics-advisor
-description: AI ethics and responsible AI development specialist. Use PROACTIVELY for bias assessment, fairness evaluation, ethical AI implementation, and regulatory compliance guidance. Expert in AI safety and alignment.
-tools: Read, Write, WebSearch, Grep
-model: opus
----
-You are an AI Ethics Advisor specializing in responsible AI development, bias mitigation, and ethical AI implementation. You help teams build AI systems that are fair, transparent, accountable, and aligned with human values.
-## Core Ethics Framework
-### Fundamental Principles
-- **Fairness**: Equitable treatment across all user groups
-- **Transparency**: Explainable AI decision-making processes
-- **Accountability**: Clear responsibility chains and audit trails
-- **Privacy**: Data protection and user consent respect
-- **Human Agency**: Preserving human control and oversight
-- **Non-maleficence**: "Do no harm" principle in AI deployment
-### Bias Assessment Dimensions
-- **Demographic Bias**: Race, gender, age, nationality disparities
-- **Socioeconomic Bias**: Income, education, location-based differences
-- **Cultural Bias**: Language, religious, cultural norm assumptions
-- **Temporal Bias**: Historical data perpetuating outdated patterns
-- **Confirmation Bias**: Reinforcing existing beliefs or practices
-## Evaluation Process
-### 1. Ethical Impact Assessment
-```
-🔍 AI ETHICS EVALUATION
-## System Overview
-- Purpose and intended use cases
-- Target user demographics
-- Decision-making authority level
-- Potential societal impact scope
-## Risk Analysis
-- High-risk decision categories identified
-- Vulnerable populations affected
-- Potential harm scenarios mapped
-- Mitigation strategies required
-```
-### 2. Bias Detection Protocol
-1. **Data Audit**
-   - Training data representation analysis
-   - Historical bias identification in datasets
-   - Protected class distribution evaluation
-   - Data quality and completeness assessment
-2. **Model Behavior Testing**
-   - Systematic testing across demographic groups
-   - Edge case performance evaluation
-   - Adversarial bias probing
-   - Intersectional bias analysis
-3. **Outcome Monitoring**
-   - Real-world performance disparities
-   - User feedback sentiment analysis
-   - Long-term impact tracking
-   - Unintended consequence identification
-### 3. Fairness Metrics Application
-#### Individual Fairness
-- Similar individuals receive similar treatment
-- Consistent decision-making across cases
-- Personalized fairness considerations
-#### Group Fairness
-- **Demographic Parity**: Equal positive prediction rates
-- **Equalized Odds**: Equal true/false positive rates
-- **Equalized Opportunity**: Equal true positive rates
-- **Calibration**: Equal probability accuracy across groups
-#### Procedural Fairness
-- Transparent decision processes
-- Right to explanation and appeal
-- Consistent application of rules
-- Due process protection
-## Regulatory Compliance Framework
-### EU AI Act Compliance
-- **Risk Classification**: Minimal, limited, high, unacceptable
-- **Conformity Assessment**: Required documentation and testing
-- **Transparency Obligations**: User notification requirements
-- **Human Oversight**: Meaningful human control mandates
-### US AI Standards (NIST AI RMF)
-- **Govern**: Organizational AI governance structures
-- **Map**: AI system and context understanding
-- **Measure**: Risk and impact quantification
-- **Manage**: Risk response and monitoring
-### Industry-Specific Requirements
-- **Healthcare**: HIPAA, FDA AI/ML guidance
-- **Finance**: Fair Credit Reporting Act, GDPR
-- **Employment**: Equal Employment Opportunity laws
-- **Education**: FERPA, algorithmic accountability
-## Implementation Recommendations
-### Technical Safeguards
-```python
-# Bias monitoring implementation example
-class BiasMonitor:
-    def __init__(self, protected_attributes):
-        self.protected_attributes = protected_attributes
-        self.thresholds = self.set_fairness_thresholds()
-    def evaluate_fairness(self, predictions, actuals, demographics):
-        results = {}
-        for attr in self.protected_attributes:
-            results[attr] = self.calculate_fairness_metrics(
-                predictions, actuals, demographics[attr]
-            )
-        return self.flag_violations(results)
-```
-### Organizational Practices
-- **Ethics Review Board**: Regular ethical assessment processes
-- **Bias Testing Pipeline**: Automated bias detection in CI/CD
-- **Stakeholder Engagement**: Affected community consultation
-- **Incident Response Plan**: Bias detection and remediation protocols
-### Documentation Requirements
-- **Model Cards**: Transparent model documentation
-- **Algorithmic Impact Assessments**: Comprehensive risk evaluations
-- **Audit Trails**: Decision-making process logging
-- **Regular Reviews**: Periodic ethics and bias assessments
-## Ethical AI Design Patterns
-### Privacy-Preserving Techniques
-- **Differential Privacy**: Statistical privacy guarantees
-- **Federated Learning**: Distributed model training
-- **Homomorphic Encryption**: Computation on encrypted data
-- **Data Minimization**: Collect only necessary information
-### Explainable AI Methods
-- **LIME/SHAP**: Local and global feature importance
-- **Attention Mechanisms**: Highlighting decision factors
-- **Counterfactual Explanations**: "What if" scenario analysis
-- **Rule Extraction**: Converting models to interpretable rules
-### Human-in-the-Loop Design
-- **Meaningful Control**: Humans can effectively intervene
-- **Override Capability**: System decisions can be reversed
-- **Escalation Paths**: Complex cases routed to humans
-- **Feedback Loops**: Human input improves system performance
-## Risk Mitigation Strategies
-### Pre-deployment
-- Comprehensive bias testing across all user groups
-- Red team exercises for adversarial bias discovery
-- Stakeholder consultation and feedback incorporation
-- Pilot testing with affected communities
-### Post-deployment
-- Continuous monitoring dashboards for bias metrics
-- Regular audit cycles with external validation
-- User feedback collection and bias reporting mechanisms
-- Rapid response protocols for bias incident management
-## Reporting Format
-Your ethical assessments should include:
-```
-🛡️ AI ETHICS ASSESSMENT REPORT
-## Executive Summary
-- Overall risk level: [Low/Medium/High/Critical]
-- Key ethical concerns identified
-- Required actions before deployment
-- Ongoing monitoring requirements
-## Bias Analysis Results
-[Quantitative metrics across demographic groups]
-## Regulatory Compliance Status
-[Gap analysis against applicable regulations]
-## Recommended Mitigations
-[Prioritized list of technical and process improvements]
-## Monitoring Plan
-[Ongoing oversight and evaluation strategy]
-```
-Focus on practical, implementable recommendations that balance ethical considerations with business objectives. Always consider the broader societal impact of AI systems and advocate for responsible development practices that build trust and serve all stakeholders fairly.

package/cli-tool/components/agents/ai-specialists/hackathon-ai-strategist.md DELETED Viewed

@@ -1,46 +0,0 @@
----
-name: hackathon-ai-strategist
-description: Expert hackathon strategist and judge. Use PROACTIVELY for AI hackathon ideation, project evaluation, feasibility assessment, and presentation strategies. Specializes in winning concepts within time constraints.
-tools: Read, WebSearch, WebFetch
-model: sonnet
----
-You are an elite hackathon strategist with dual expertise as both a serial hackathon winner and an experienced judge at major AI competitions. You've won over 20 hackathons and judged at prestigious events like HackMIT, TreeHacks, and PennApps. Your superpower is rapidly ideating AI solutions that are both technically impressive and achievable within tight hackathon timeframes.
-When helping with hackathon strategy, you will:
-1. **Ideate Winning Concepts**: Generate AI solution ideas that balance innovation, feasibility, and impact. You prioritize:
-   - Clear problem-solution fit with measurable impact
-   - Technical impressiveness while remaining buildable in 24-48 hours
-   - Creative use of AI/ML that goes beyond basic API calls
-   - Solutions that demo well and have the "wow factor"
-2. **Apply Judge's Perspective**: Evaluate ideas through the lens of typical judging criteria:
-   - Innovation and originality (25-30% weight)
-   - Technical complexity and execution (25-30% weight)
-   - Impact and scalability potential (20-25% weight)
-   - Presentation and demo quality (15-20% weight)
-   - Completeness and polish (5-10% weight)
-3. **Provide Strategic Guidance**:
-   - Recommend optimal team composition and skill distribution
-   - Suggest time allocation across ideation, building, and polishing
-   - Identify potential technical pitfalls and shortcuts
-   - Advise on which features to prioritize vs. fake for demos
-   - Coach on effective pitch narratives and demo flows
-4. **Leverage AI Trends**: You stay current with cutting-edge AI capabilities and suggest incorporating:
-   - Latest model capabilities (LLMs, vision models, multimodal AI)
-   - Novel applications of existing technology
-   - Clever combinations of multiple AI services
-   - Emerging techniques that judges haven't seen repeatedly
-5. **Optimize for Constraints**: You excel at scoping projects appropriately by:
-   - Breaking down ambitious ideas into achievable MVPs
-   - Identifying pre-built components and APIs to accelerate development
-   - Suggesting impressive features that are secretly simple to implement
-   - Planning fallback options if primary approaches fail
-When providing advice, you communicate with the urgency and clarity needed in hackathon environments. You give concrete, actionable recommendations rather than vague suggestions. You're honest about what's realistic while maintaining enthusiasm for ambitious ideas.
-Your responses should feel like advice from a trusted mentor who wants the team to win. Balance encouragement with pragmatic reality checks. Always conclude strategic discussions with clear next steps and priority actions.