claude-code-templates 1.21.1 → 1.21.3

package/cli-tool/components/commands/automation/ci-pipeline.md

@@ -1,378 +0,0 @@
----
-allowed-tools: Read, Write, Edit, Bash
-argument-hint: [pipeline-name] | setup | status | fix
-description: Manage and automate CI/CD pipeline configuration with GitHub Actions, multi-environment support, and deployment strategies
-model: sonnet
----
-
-# CI/CD Pipeline Manager
-
-Manage CI/CD pipeline automation: $ARGUMENTS
-
-## Current Pipeline State
-
-- GitHub Actions: !`find .github/workflows -name "*.yml" -o -name "*.yaml" 2>/dev/null | head -5`
-- CI configuration: @.github/workflows/ (if exists)
-- Package scripts: @package.json
-- Environment files: !`find . -name ".env*" | head -3`
-- Recent workflow runs: !`gh run list --limit 5 2>/dev/null || echo "GitHub CLI not available"`
-
-## Task
-
-Automate CI/CD pipeline management with comprehensive workflow orchestration.
-
-## Pipeline Operations
-
-### Setup New Pipeline
-Create complete CI/CD pipeline with:
-
-```yaml
-# .github/workflows/ci.yml
-name: CI Pipeline
-on:
-  push:
-    branches: [main, develop]
-  pull_request:
-    branches: [main]
-
-jobs:
-  test:
-    runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        node-version: [18, 20]
-    steps:
-      - uses: actions/checkout@v4
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: ${{ matrix.node-version }}
-          cache: 'npm'
-      
-      - name: Install dependencies
-        run: npm ci
-      
-      - name: Run linter
-        run: npm run lint
-      
-      - name: Run tests
-        run: npm run test:coverage
-      
-      - name: Build application
-        run: npm run build
-      
-      - name: Upload coverage
-        uses: codecov/codecov-action@v3
-        with:
-          file: ./coverage/lcov.info
-```
-
-### Multi-Environment Deployment
-```yaml
-# .github/workflows/deploy.yml
-name: Deploy
-on:
-  push:
-    branches: [main]
-  release:
-    types: [published]
-
-jobs:
-  deploy-staging:
-    if: github.ref == 'refs/heads/main'
-    runs-on: ubuntu-latest
-    environment: staging
-    steps:
-      - uses: actions/checkout@v4
-      - name: Deploy to Staging
-        run: |
-          npm run build:staging
-          npm run deploy:staging
-        env:
-          STAGING_API_URL: ${{ secrets.STAGING_API_URL }}
-          STAGING_SECRET: ${{ secrets.STAGING_SECRET }}
-
-  deploy-production:
-    if: github.event_name == 'release'
-    runs-on: ubuntu-latest
-    environment: production
-    needs: [test]
-    steps:
-      - uses: actions/checkout@v4
-      - name: Deploy to Production
-        run: |
-          npm run build:production
-          npm run deploy:production
-        env:
-          PROD_API_URL: ${{ secrets.PROD_API_URL }}
-          PROD_SECRET: ${{ secrets.PROD_SECRET }}
-```
-
-### Security & Quality Gates
-```yaml
-  security-scan:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      
-      - name: Run security audit
-        run: npm audit --audit-level=moderate
-      
-      - name: Scan for secrets
-        uses: trufflesecurity/trufflehog@main
-        with:
-          path: ./
-          base: main
-          head: HEAD
-      
-      - name: SAST Scan
-        uses: github/super-linter@v4
-        env:
-          DEFAULT_BRANCH: main
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-```
-
-### Performance Testing
-```yaml
-  performance:
-    runs-on: ubuntu-latest
-    if: github.event_name == 'pull_request'
-    steps:
-      - uses: actions/checkout@v4
-      - name: Performance Test
-        run: |
-          npm run build
-          npm run start:test &
-          sleep 10
-          npx lighthouse http://localhost:3000 --output=json --output-path=./lighthouse.json
-      
-      - name: Comment PR
-        uses: actions/github-script@v6
-        with:
-          script: |
-            const fs = require('fs');
-            const lighthouse = JSON.parse(fs.readFileSync('./lighthouse.json'));
-            const score = lighthouse.lhr.categories.performance.score * 100;
-            
-            github.rest.issues.createComment({
-              issue_number: context.issue.number,
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              body: `⚡ Performance Score: ${score}/100`
-            });
-```
-
-## Advanced Features
-
-### 1. **Matrix Strategy Testing**
-```yaml
-strategy:
-  matrix:
-    os: [ubuntu-latest, windows-latest, macos-latest]
-    node-version: [16, 18, 20]
-    include:
-      - os: ubuntu-latest
-        node-version: 20
-        coverage: true
-```
-
-### 2. **Conditional Workflows**
-```yaml
-- name: Skip CI
-  if: contains(github.event.head_commit.message, '[skip ci]')
-  run: echo "Skipping CI as requested"
-
-- name: Deploy only on version tags
-  if: startsWith(github.ref, 'refs/tags/v')
-  run: npm run deploy
-```
-
-### 3. **Workflow Dependencies**
-```yaml
-jobs:
-  test:
-    runs-on: ubuntu-latest
-    
-  build:
-    needs: test
-    runs-on: ubuntu-latest
-    
-  deploy:
-    needs: [test, build]
-    if: github.ref == 'refs/heads/main'
-    runs-on: ubuntu-latest
-```
-
-### 4. **Cache Optimization**
-```yaml
-- name: Cache node modules
-  uses: actions/cache@v3
-  with:
-    path: ~/.npm
-    key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }}
-    restore-keys: |
-      ${{ runner.os }}-node-
-
-- name: Cache build output
-  uses: actions/cache@v3
-  with:
-    path: dist
-    key: build-${{ github.sha }}
-```
-
-### 5. **Artifact Management**
-```yaml
-- name: Upload build artifacts
-  uses: actions/upload-artifact@v3
-  with:
-    name: dist-files
-    path: dist/
-    retention-days: 7
-
-- name: Download artifacts
-  uses: actions/download-artifact@v3
-  with:
-    name: dist-files
-    path: dist/
-```
-
-### 6. **Environment Management**
-```yaml
-environments:
-  staging:
-    url: https://staging.example.com
-    
-  production:
-    url: https://example.com
-    protection_rules:
-      - type: required_reviewers
-        required_reviewers:
-          - devops-team
-      - type: wait_timer
-        wait_timer: 5
-```
-
-## Pipeline Monitoring
-
-### Status Checks
-```bash
-# Check workflow status
-gh run list --workflow=ci.yml --limit=10
-
-# View specific run
-gh run view [run-id] --log
-
-# Monitor failure rate
-gh api repos/:owner/:repo/actions/runs \
-  --jq '.workflow_runs[0:20] | map(select(.conclusion=="failure")) | length'
-```
-
-### Performance Metrics
-```bash
-# Average build time
-gh api repos/:owner/:repo/actions/runs \
-  --jq '.workflow_runs[0:50] | map(.run_duration_ms) | add / length'
-
-# Success rate calculation
-gh api repos/:owner/:repo/actions/runs \
-  --jq '.workflow_runs[0:100] | [group_by(.conclusion)[] | {conclusion: .[0].conclusion, count: length}]'
-```
-
-## Troubleshooting
-
-### Common Issues
-
-#### 1. **Workflow Permission Issues**
-```yaml
-permissions:
-  contents: read
-  actions: write
-  security-events: write
-  pull-requests: write
-```
-
-#### 2. **Secret Management**
-```bash
-# Add repository secret
-gh secret set STAGING_API_URL --body "https://staging-api.example.com"
-
-# List secrets
-gh secret list
-```
-
-#### 3. **Timeout Configuration**
-```yaml
-jobs:
-  long-running-job:
-    runs-on: ubuntu-latest
-    timeout-minutes: 60
-    steps:
-      - name: Long task
-        timeout-minutes: 30
-        run: npm run long-task
-```
-
-#### 4. **Debugging Workflows**
-```yaml
-- name: Debug information
-  run: |
-    echo "Event name: ${{ github.event_name }}"
-    echo "Ref: ${{ github.ref }}"
-    echo "SHA: ${{ github.sha }}"
-    echo "Actor: ${{ github.actor }}"
-```
-
-## Best Practices
-
-### 1. **Fail Fast Strategy**
-- Run fastest jobs first
-- Use `fail-fast: true` in matrix
-- Implement early validation steps
-
-### 2. **Security First**
-- Never store secrets in code
-- Use least privilege permissions
-- Scan for vulnerabilities early
-
-### 3. **Efficiency Optimization**
-- Use appropriate cache strategies
-- Minimize workflow duration
-- Parallel job execution
-
-### 4. **Monitoring & Alerting**
-- Track build success rates
-- Monitor deployment frequency
-- Alert on critical failures
-
-## Integration Examples
-
-### Docker Integration
-```yaml
-- name: Build Docker image
-  run: |
-    docker build -t myapp:${{ github.sha }} .
-    docker tag myapp:${{ github.sha }} myapp:latest
-
-- name: Push to registry
-  run: |
-    echo ${{ secrets.DOCKER_PASSWORD }} | docker login -u ${{ secrets.DOCKER_USERNAME }} --password-stdin
-    docker push myapp:${{ github.sha }}
-    docker push myapp:latest
-```
-
-### Cloud Deployment
-```yaml
-- name: Deploy to AWS
-  uses: aws-actions/configure-aws-credentials@v2
-  with:
-    aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }}
-    aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
-    aws-region: us-east-1
-
-- name: Deploy to S3
-  run: |
-    aws s3 sync dist/ s3://my-bucket --delete
-    aws cloudfront create-invalidation --distribution-id ${{ secrets.CLOUDFRONT_ID }} --paths "/*"
-```
-
-This pipeline manager provides comprehensive automation for modern CI/CD workflows with security, performance, and monitoring built-in.

package/cli-tool/components/commands/automation/husky.md

@@ -1,130 +0,0 @@
----
-allowed-tools: Bash, Read
-argument-hint: [--skip-install] | [--only-lint] | [--skip-tests]
-description: Run comprehensive CI checks and fix issues until repository is in working state
-model: sonnet
----
-
-# Husky CI Pre-commit Checks
-
-Run comprehensive CI checks and fix issues: $ARGUMENTS
-
-## Current Repository State
-
-- Git status: !`git status --porcelain`
-- Package manager: !`which pnpm npm yarn | head -1`
-- Current branch: !`git branch --show-current`
-- Package.json: @package.json
-- Environment file: @.env (if exists)
-
-## Task
-
-Verify repository is in working state and fix issues. All commands run from repo root.
-
-## CI Check Protocol
-
-### Step 0: Environment Setup
-- Update dependencies: `pnpm i` (unless --skip-install)
-- Source environment: `.env` file if exists
-
-### Step 1: Linting
-- Check linter passes: `pnpm lint`
-- Fix formatting issues automatically when possible
-
-### Step 2: TypeScript & Build
-- Run comprehensive build checks:
-  ```bash
-  pnpm nx run-many --targets=build:types,build:dist,build:app,generate:docs,dev:run,typecheck
-  ```
-- If specific command fails, debug that command individually
-- Fix TypeScript errors and build issues
-
-### Step 3: Test Coverage
-- Source `.env` file first if exists
-- Run test coverage: `pnpm nx run-many --target=test:coverage`
-- **NEVER** run normal test command (times out)
-- Run individual packages one by one for easier debugging
-- For snapshot test failures: explain thesis before updating snapshots
-
-### Step 4: Package Validation
-- Sort package.json: `pnpm run sort-package-json`
-- Lint packages: `pnpm nx run-many --targets=lint:package,lint:deps`
-
-### Step 5: Double Check
-- If fixes made in any step, re-run all preceding checks
-- Ensure no regression introduced
-
-### Step 6: Staging
-- Check status: `git status`
-- Add files: `git add`
-- **EXCLUDE**: Git submodules in `lib/*` folders
-- **DO NOT COMMIT**: Only stage files
-
-## Error Handling Protocol
-
-### 1. Diagnosis
-- Explain why command broke with complete analysis
-- Cite source code and logs supporting thesis
-- Add console logs if needed for confirmation
-- Ask for help if insufficient context
-
-### 2. Fix Implementation
-- Propose specific fix with full explanation
-- Explain why fix will work
-- If fix fails, return to Step 1
-
-### 3. Impact Analysis
-- Consider if same bug exists elsewhere
-- Search codebase for similar patterns
-- Fix related issues proactively
-
-### 4. Cleanup
-- Remove all added console.logs after fixing
-- Run `pnpm run lint` to format files
-- Ask user before staging changes
-- Suggest commit message (don't commit)
-
-## Development Notes
-
-### File Organization
-- Functions/types like `createTevmNode` are in:
-  - Implementation: `createTevmNode.js`
-  - Types: `TevmNode.ts`
-  - Tests: `createTevmNode.spec.ts`
-
-### Tool-Specific Tips
-
-#### pnpm i
-- If fails, abort unless simple syntax error (missing comma)
-
-#### pnpm lint (Biome)
-- Lints entire codebase
-- Auto-fixes most formatting issues
-
-#### TypeScript Builds
-- Look for types in node_modules if not obvious
-- For tevm packages, check monorepo structure
-- Consult documentation if multiple failures
-
-#### Test Execution
-- Use Vite test runner
-- Run packages individually for debugging
-- Add console logs to test assumptions
-- Explain snapshot changes before updating
-
-## Success Criteria
-
-Print checklist at end with ✅ for passed steps:
-- ✅ Dependencies updated
-- ✅ Linting passed
-- ✅ TypeScript/Build passed
-- ✅ Tests passed
-- ✅ Package validation passed
-- ✅ Files staged (no commits made)
-
-## Safety Guidelines
-
-- **Fix errors proactively** - TypeScript/tests will catch regressions
-- **Never commit** - Only stage changes
-- **One step at a time** - Don't proceed until current step passes
-- **Ask permission** before staging if fixes were made