create-claude-context 1.0.0 → 1.2.1

package/templates/base/ci-templates/README.md

@@ -1,108 +1,108 @@
-# CI/CD Templates
-
-Pre-built CI/CD workflows for Claude Context Engineering validation.
-
-## Available Templates
-
-### GitHub Actions
-
-| Template | Purpose | Trigger |
-|----------|---------|---------|
-| `validate-docs.yml` | Validate documentation on PRs | Pull requests |
-| `context-check.yml` | Monitor context budget health | Push, weekly, manual |
-
-## Installation
-
-### GitHub Actions
-
-Copy templates to your `.github/workflows/` directory:
-
-```bash
-# From project root
-mkdir -p .github/workflows
-cp .claude/ci-templates/github-actions/*.yml .github/workflows/
-```
-
-### Prerequisites
-
-1. Node.js 18+ available in CI environment
-2. `.claude/tools/` dependencies installed:
-   ```bash
-   cd .claude/tools && npm ci
-   ```
-
-## Customization
-
-### Adjust Validation Strictness
-
-Edit the workflow files to change thresholds:
-
-```yaml
-# In validate-docs.yml
-- name: Check Line Number Accuracy
-  run: |
-    npx claude-context validate --lines --threshold 70  # Stricter
-```
-
-### Add Notifications
-
-Add Slack/Discord notifications on failure:
-
-```yaml
-- name: Notify on Failure
-  if: failure()
-  uses: 8398a7/action-slack@v3
-  with:
-    status: ${{ job.status }}
-    webhook_url: ${{ secrets.SLACK_WEBHOOK }}
-```
-
-### Skip on Specific Files
-
-Modify the `paths` filter:
-
-```yaml
-on:
-  pull_request:
-    paths:
-      - '.claude/**'
-      - 'src/**'
-      - '!src/**/*.test.js'  # Exclude test files
-```
-
-## Workflow Outputs
-
-### validate-docs.yml
-
-- **validation-report.md** - Detailed validation results
-- PR comment on failure with specific issues
-
-### context-check.yml
-
-- **metrics.json** - Documentation metrics
-- **diagnostics.txt** - System diagnostics
-- **validation.txt** - Full validation output
-- Auto-creates issue on weekly failure
-
-## Troubleshooting
-
-### "CLI tools not found"
-
-Ensure tools are installed:
-```bash
-cd .claude/tools && npm ci
-```
-
-### "Validation always fails on line numbers"
-
-Line number drift is expected. Adjust threshold:
-```yaml
---threshold 50  # More lenient
-```
-
-### "Context budget exceeded"
-
-Review documentation and consider:
-1. Splitting large workflow files
-2. Moving rarely-used content to separate files
-3. Compacting verbose sections
+# CI/CD Templates
+
+Pre-built CI/CD workflows for Claude Context Engineering validation.
+
+## Available Templates
+
+### GitHub Actions
+
+| Template | Purpose | Trigger |
+|----------|---------|---------|
+| `validate-docs.yml` | Validate documentation on PRs | Pull requests |
+| `context-check.yml` | Monitor context budget health | Push, weekly, manual |
+
+## Installation
+
+### GitHub Actions
+
+Copy templates to your `.github/workflows/` directory:
+
+```bash
+# From project root
+mkdir -p .github/workflows
+cp .claude/ci-templates/github-actions/*.yml .github/workflows/
+```
+
+### Prerequisites
+
+1. Node.js 18+ available in CI environment
+2. `.claude/tools/` dependencies installed:
+   ```bash
+   cd .claude/tools && npm ci
+   ```
+
+## Customization
+
+### Adjust Validation Strictness
+
+Edit the workflow files to change thresholds:
+
+```yaml
+# In validate-docs.yml
+- name: Check Line Number Accuracy
+  run: |
+    npx claude-context validate --lines --threshold 70  # Stricter
+```
+
+### Add Notifications
+
+Add Slack/Discord notifications on failure:
+
+```yaml
+- name: Notify on Failure
+  if: failure()
+  uses: 8398a7/action-slack@v3
+  with:
+    status: ${{ job.status }}
+    webhook_url: ${{ secrets.SLACK_WEBHOOK }}
+```
+
+### Skip on Specific Files
+
+Modify the `paths` filter:
+
+```yaml
+on:
+  pull_request:
+    paths:
+      - '.claude/**'
+      - 'src/**'
+      - '!src/**/*.test.js'  # Exclude test files
+```
+
+## Workflow Outputs
+
+### validate-docs.yml
+
+- **validation-report.md** - Detailed validation results
+- PR comment on failure with specific issues
+
+### context-check.yml
+
+- **metrics.json** - Documentation metrics
+- **diagnostics.txt** - System diagnostics
+- **validation.txt** - Full validation output
+- Auto-creates issue on weekly failure
+
+## Troubleshooting
+
+### "CLI tools not found"
+
+Ensure tools are installed:
+```bash
+cd .claude/tools && npm ci
+```
+
+### "Validation always fails on line numbers"
+
+Line number drift is expected. Adjust threshold:
+```yaml
+--threshold 50  # More lenient
+```
+
+### "Context budget exceeded"
+
+Review documentation and consider:
+1. Splitting large workflow files
+2. Moving rarely-used content to separate files
+3. Compacting verbose sections

package/templates/base/ci-templates/github-actions/context-check.yml

@@ -1,144 +1,144 @@
-# Claude Context Engineering - Context Budget Check
-#
-# This workflow monitors context budget and documentation health.
-# Copy this file to .github/workflows/context-check.yml to enable.
-#
-# Runs on:
-# - Push to main/master branches
-# - Weekly schedule
-# - Manual trigger
-
-name: Context Budget Check
-
-on:
-  push:
-    branches:
-      - main
-      - master
-    paths:
-      - '.claude/**'
-  schedule:
-    # Run weekly on Monday at 9am UTC
-    - cron: '0 9 * * 1'
-  workflow_dispatch:
-
-jobs:
-  context-health:
-    name: Check Context Engineering Health
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: '18'
-          cache: 'npm'
-          cache-dependency-path: '.claude/tools/package-lock.json'
-
-      - name: Install CLI tools
-        run: |
-          cd .claude/tools
-          npm ci
-
-      - name: Run Full Diagnostics
-        id: diagnose
-        run: |
-          echo "🔬 Running diagnostics..."
-          npx .claude/tools/bin/claude-context.js diagnose --verbose > diagnostics.txt 2>&1
-          cat diagnostics.txt
-        continue-on-error: true
-
-      - name: Calculate Documentation Metrics
-        run: |
-          echo "📊 Calculating metrics..."
-
-          # Count workflow files
-          WORKFLOW_COUNT=$(find .claude/context/workflows -name "*.md" 2>/dev/null | wc -l || echo "0")
-          echo "Workflow files: $WORKFLOW_COUNT"
-
-          # Count agent files
-          AGENT_COUNT=$(find .claude/agents -name "*.md" 2>/dev/null | wc -l || echo "0")
-          echo "Agent files: $AGENT_COUNT"
-
-          # Count command files
-          COMMAND_COUNT=$(find .claude/commands -name "*.md" 2>/dev/null | wc -l || echo "0")
-          echo "Command files: $COMMAND_COUNT"
-
-          # Estimate total documentation tokens (rough: 1 token ≈ 4 chars)
-          TOTAL_CHARS=$(find .claude -name "*.md" -exec cat {} \; 2>/dev/null | wc -c || echo "0")
-          ESTIMATED_TOKENS=$((TOTAL_CHARS / 4))
-          echo "Estimated documentation tokens: $ESTIMATED_TOKENS"
-
-          # Calculate as percentage of budget
-          MAX_TOKENS=200000
-          PERCENTAGE=$((ESTIMATED_TOKENS * 100 / MAX_TOKENS))
-          echo "Context budget usage: ${PERCENTAGE}%"
-
-          # Save metrics
-          cat > metrics.json << EOF
-          {
-            "workflow_count": $WORKFLOW_COUNT,
-            "agent_count": $AGENT_COUNT,
-            "command_count": $COMMAND_COUNT,
-            "estimated_tokens": $ESTIMATED_TOKENS,
-            "budget_percentage": $PERCENTAGE,
-            "timestamp": "$(date -u +%Y-%m-%dT%H:%M:%SZ)"
-          }
-          EOF
-
-          cat metrics.json
-
-      - name: Check Budget Threshold
-        run: |
-          PERCENTAGE=$(jq '.budget_percentage' metrics.json)
-          echo "Current usage: ${PERCENTAGE}%"
-
-          if [ "$PERCENTAGE" -gt 60 ]; then
-            echo "⚠️ WARNING: Documentation exceeds 60% of context budget!"
-            echo "Consider compacting or splitting documentation."
-            exit 1
-          elif [ "$PERCENTAGE" -gt 40 ]; then
-            echo "📊 Documentation is at ${PERCENTAGE}% - approaching target limit"
-          else
-            echo "✅ Documentation is within healthy range (${PERCENTAGE}%)"
-          fi
-
-      - name: Run Validation Suite
-        run: |
-          echo "🔍 Running validation..."
-          npx .claude/tools/bin/claude-context.js validate --all > validation.txt 2>&1 || true
-          cat validation.txt
-
-      - name: Upload Metrics
-        uses: actions/upload-artifact@v4
-        with:
-          name: context-metrics
-          path: |
-            metrics.json
-            diagnostics.txt
-            validation.txt
-          retention-days: 30
-
-      - name: Create Issue on Failure
-        if: failure() && github.event_name == 'schedule'
-        uses: actions/github-script@v7
-        with:
-          script: |
-            const fs = require('fs');
-            let metrics = {};
-            try {
-              metrics = JSON.parse(fs.readFileSync('metrics.json', 'utf8'));
-            } catch (e) {
-              metrics = { error: 'Could not read metrics' };
-            }
-
-            github.rest.issues.create({
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              title: '⚠️ Claude Context Engineering Health Check Failed',
-              body: `## Weekly Health Check Failed\n\n**Metrics:**\n\`\`\`json\n${JSON.stringify(metrics, null, 2)}\n\`\`\`\n\n**Action Required:**\n- Review documentation health\n- Run \`npx claude-context diagnose\` locally\n- Consider documentation compaction if over budget\n\n---\n*Generated by Claude Context Engineering CI*`,
-              labels: ['documentation', 'maintenance']
-            });
+# Claude Context Engineering - Context Budget Check
+#
+# This workflow monitors context budget and documentation health.
+# Copy this file to .github/workflows/context-check.yml to enable.
+#
+# Runs on:
+# - Push to main/master branches
+# - Weekly schedule
+# - Manual trigger
+
+name: Context Budget Check
+
+on:
+  push:
+    branches:
+      - main
+      - master
+    paths:
+      - '.claude/**'
+  schedule:
+    # Run weekly on Monday at 9am UTC
+    - cron: '0 9 * * 1'
+  workflow_dispatch:
+
+jobs:
+  context-health:
+    name: Check Context Engineering Health
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+          cache: 'npm'
+          cache-dependency-path: '.claude/tools/package-lock.json'
+
+      - name: Install CLI tools
+        run: |
+          cd .claude/tools
+          npm ci
+
+      - name: Run Full Diagnostics
+        id: diagnose
+        run: |
+          echo "🔬 Running diagnostics..."
+          npx .claude/tools/bin/claude-context.js diagnose --verbose > diagnostics.txt 2>&1
+          cat diagnostics.txt
+        continue-on-error: true
+
+      - name: Calculate Documentation Metrics
+        run: |
+          echo "📊 Calculating metrics..."
+
+          # Count workflow files
+          WORKFLOW_COUNT=$(find .claude/context/workflows -name "*.md" 2>/dev/null | wc -l || echo "0")
+          echo "Workflow files: $WORKFLOW_COUNT"
+
+          # Count agent files
+          AGENT_COUNT=$(find .claude/agents -name "*.md" 2>/dev/null | wc -l || echo "0")
+          echo "Agent files: $AGENT_COUNT"
+
+          # Count command files
+          COMMAND_COUNT=$(find .claude/commands -name "*.md" 2>/dev/null | wc -l || echo "0")
+          echo "Command files: $COMMAND_COUNT"
+
+          # Estimate total documentation tokens (rough: 1 token ≈ 4 chars)
+          TOTAL_CHARS=$(find .claude -name "*.md" -exec cat {} \; 2>/dev/null | wc -c || echo "0")
+          ESTIMATED_TOKENS=$((TOTAL_CHARS / 4))
+          echo "Estimated documentation tokens: $ESTIMATED_TOKENS"
+
+          # Calculate as percentage of budget
+          MAX_TOKENS=200000
+          PERCENTAGE=$((ESTIMATED_TOKENS * 100 / MAX_TOKENS))
+          echo "Context budget usage: ${PERCENTAGE}%"
+
+          # Save metrics
+          cat > metrics.json << EOF
+          {
+            "workflow_count": $WORKFLOW_COUNT,
+            "agent_count": $AGENT_COUNT,
+            "command_count": $COMMAND_COUNT,
+            "estimated_tokens": $ESTIMATED_TOKENS,
+            "budget_percentage": $PERCENTAGE,
+            "timestamp": "$(date -u +%Y-%m-%dT%H:%M:%SZ)"
+          }
+          EOF
+
+          cat metrics.json
+
+      - name: Check Budget Threshold
+        run: |
+          PERCENTAGE=$(jq '.budget_percentage' metrics.json)
+          echo "Current usage: ${PERCENTAGE}%"
+
+          if [ "$PERCENTAGE" -gt 60 ]; then
+            echo "⚠️ WARNING: Documentation exceeds 60% of context budget!"
+            echo "Consider compacting or splitting documentation."
+            exit 1
+          elif [ "$PERCENTAGE" -gt 40 ]; then
+            echo "📊 Documentation is at ${PERCENTAGE}% - approaching target limit"
+          else
+            echo "✅ Documentation is within healthy range (${PERCENTAGE}%)"
+          fi
+
+      - name: Run Validation Suite
+        run: |
+          echo "🔍 Running validation..."
+          npx .claude/tools/bin/claude-context.js validate --all > validation.txt 2>&1 || true
+          cat validation.txt
+
+      - name: Upload Metrics
+        uses: actions/upload-artifact@v4
+        with:
+          name: context-metrics
+          path: |
+            metrics.json
+            diagnostics.txt
+            validation.txt
+          retention-days: 30
+
+      - name: Create Issue on Failure
+        if: failure() && github.event_name == 'schedule'
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const fs = require('fs');
+            let metrics = {};
+            try {
+              metrics = JSON.parse(fs.readFileSync('metrics.json', 'utf8'));
+            } catch (e) {
+              metrics = { error: 'Could not read metrics' };
+            }
+
+            github.rest.issues.create({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              title: '⚠️ Claude Context Engineering Health Check Failed',
+              body: `## Weekly Health Check Failed\n\n**Metrics:**\n\`\`\`json\n${JSON.stringify(metrics, null, 2)}\n\`\`\`\n\n**Action Required:**\n- Review documentation health\n- Run \`npx claude-context diagnose\` locally\n- Consider documentation compaction if over budget\n\n---\n*Generated by Claude Context Engineering CI*`,
+              labels: ['documentation', 'maintenance']
+            });