create-claude-context 1.0.0

package/templates/base/agents/deployment-ops.md

@@ -0,0 +1,76 @@
+---
+name: deployment-ops
+version: "1.0.0"
+displayName: "Deployment Operations"
+description: "CI/CD pipeline management, infrastructure as code, and deployment automation specialist"
+category: "deployment"
+complexity: "high"
+context_budget: "~45K tokens"
+capabilities:
+  - "ci-cd-pipeline-design"
+  - "infrastructure-as-code"
+  - "deployment-strategies"
+  - "environment-management"
+  - "monitoring-and-rollback"
+workflows:
+  - "deployment"
+  - "infrastructure"
+  - "ci-cd"
+commands: ["/rpi-research", "/rpi-plan", "/rpi-implement", "/validate-all"]
+dependencies:
+  agents: []
+  commands: []
+hooks:
+  pre_invoke: null
+  post_invoke: "verify-docs-current"
+examples:
+  - invocation: '@deployment-ops "Document deployment pipeline"'
+    description: "Create CI/CD documentation"
+  - invocation: '@deployment-ops "Review infrastructure configuration"'
+    description: "Audit IaC files and configurations"
+  - invocation: '@deployment-ops "Plan rollback strategy"'
+    description: "Design safe rollback procedures"
+---
+
+# Deployment Ops Agent
+
+**Purpose:** CI/CD pipeline management, infrastructure as code, and deployment automation
+
+## Capabilities
+
+This agent specializes in:
+- **Pipeline design and optimization** - Creating and optimizing CI/CD pipelines
+- **Infrastructure as code** - Managing cloud infrastructure with Terraform, CloudFormation, etc.
+- **Deployment strategies** - Implementing blue-green, canary, rolling deployments
+- **Environment management** - Managing development, staging, and production environments
+- **Monitoring and rollback** - Implementing monitoring and automatic rollback strategies
+
+## Usage
+
+After template initialization, this agent will be generated based on your deployment requirements. It will:
+1. Analyze your existing deployment pipelines
+2. Create comprehensive deployment documentation
+3. Identify potential reliability issues
+4. Provide recommendations for deployment optimization
+
+## Example Commands
+
+```bash
+@deployment-ops "Document deployment pipeline for [environment]"
+@deployment-ops "Validate infrastructure as code for [service]"
+@deployment-ops "Generate rollback strategy for [deployment]"
+```
+
+## Integration Points
+
+This agent integrates with:
+- Workflow documentation
+- API design (for deployment endpoints)
+- Monitoring and alerting
+- Security validation
+
+## Validation
+
+- Pipeline reliability checks
+- Infrastructure consistency validation
+- Deployment strategy verification

package/templates/base/agents/integration-hub.md

@@ -0,0 +1,76 @@
+---
+name: integration-hub
+version: "1.0.0"
+displayName: "Integration Hub"
+description: "External service integration, third-party API management, and webhook handling specialist"
+category: "integration"
+complexity: "medium-high"
+context_budget: "~40K tokens"
+capabilities:
+  - "third-party-api-integration"
+  - "webhook-handling"
+  - "authentication-management"
+  - "rate-limiting-implementation"
+  - "error-handling-patterns"
+workflows:
+  - "external-services"
+  - "webhooks"
+  - "integrations"
+commands: ["/rpi-research", "/rpi-plan", "/rpi-implement"]
+dependencies:
+  agents: []
+  commands: []
+hooks:
+  pre_invoke: null
+  post_invoke: "verify-docs-current"
+examples:
+  - invocation: '@integration-hub "Document integration with [service]"'
+    description: "Create integration documentation"
+  - invocation: '@integration-hub "Analyze webhook endpoints"'
+    description: "Review webhook security and reliability"
+  - invocation: '@integration-hub "Review authentication flows"'
+    description: "Audit third-party auth mechanisms"
+---
+
+# Integration Hub Agent
+
+**Purpose:** External service integration, third-party API management, and webhook handling
+
+## Capabilities
+
+This agent specializes in:
+- **Third-party API integration** - Connecting with external services and APIs
+- **Webhook handling** - Managing incoming and outgoing webhooks
+- **Authentication management** - Handling API keys, OAuth, and other auth mechanisms
+- **Rate limiting and retries** - Implementing robust integration patterns
+- **Error handling** - Managing integration failures and retries
+
+## Usage
+
+After template initialization, this agent will be generated based on your integration requirements. It will:
+1. Analyze your existing external integrations
+2. Create comprehensive integration documentation
+3. Identify potential security vulnerabilities
+4. Provide recommendations for integration optimization
+
+## Example Commands
+
+```bash
+@integration-hub "Document integration with [service]"
+@integration-hub "Validate webhook endpoints for [integration]"
+@integration-hub "Generate authentication strategy for [service]"
+```
+
+## Integration Points
+
+This agent integrates with:
+- Workflow documentation
+- API design (for integration endpoints)
+- Testing strategies
+- Monitoring and alerting
+
+## Validation
+
+- Integration security checks
+- Authentication mechanism validation
+- Rate limiting configuration

package/templates/base/analytics/README.md

@@ -0,0 +1,114 @@
+# Analytics Data
+
+Local storage for usage analytics and metrics.
+
+## Overview
+
+This directory stores local analytics data collected during Claude Code sessions. All data is stored locally and never sent externally unless explicitly configured.
+
+## Files
+
+| File | Description |
+|------|-------------|
+| `sessions.json` | Session history and metadata |
+| `commands.json` | Command usage statistics |
+| `agents.json` | Agent invocation tracking |
+| `context.json` | Context budget metrics over time |
+| `exports/` | Exported analytics files |
+
+## Data Schema
+
+### sessions.json
+
+```json
+{
+  "sessions": [
+    {
+      "id": "uuid",
+      "started": "ISO-timestamp",
+      "ended": "ISO-timestamp",
+      "duration_minutes": 45,
+      "files_modified": 12,
+      "commits": 3,
+      "member_id": "dev-1"
+    }
+  ]
+}
+```
+
+### commands.json
+
+```json
+{
+  "commands": {
+    "/rpi-research": {
+      "count": 23,
+      "last_used": "ISO-timestamp",
+      "success_rate": 0.95,
+      "history": [
+        {
+          "timestamp": "ISO-timestamp",
+          "duration_seconds": 120,
+          "success": true
+        }
+      ]
+    }
+  }
+}
+```
+
+### agents.json
+
+```json
+{
+  "agents": {
+    "@core-architect": {
+      "invocations": 18,
+      "last_used": "ISO-timestamp",
+      "avg_context_tokens": 35000,
+      "tasks_completed": 15
+    }
+  }
+}
+```
+
+### context.json
+
+```json
+{
+  "snapshots": [
+    {
+      "timestamp": "ISO-timestamp",
+      "total_tokens": 45000,
+      "breakdown": {
+        "indexes": 12400,
+        "workflows": 18200,
+        "agents": 8600,
+        "commands": 5800
+      },
+      "budget_percentage": 22.5
+    }
+  ]
+}
+```
+
+## Retention
+
+Data is retained according to `telemetry.retention_days` in settings (default: 90 days). Older data is automatically pruned.
+
+## Clearing Data
+
+To clear all analytics data:
+
+```
+/analytics clear
+```
+
+Or manually delete files in this directory (except README.md).
+
+## Privacy
+
+- All data stored locally
+- No external transmission
+- User has full control
+- Can be disabled in settings

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

@@ -0,0 +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

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

@@ -0,0 +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']
+            });

package/templates/base/ci-templates/github-actions/validate-docs.yml

@@ -0,0 +1,105 @@
+# Claude Context Engineering - Documentation Validation
+#
+# This workflow validates that documentation is accurate and up-to-date.
+# Copy this file to .github/workflows/validate-docs.yml to enable.
+#
+# Runs on:
+# - Pull requests that modify .claude/ or source files
+# - Manual trigger
+
+name: Validate Documentation
+
+on:
+  pull_request:
+    paths:
+      - '.claude/**'
+      - 'src/**'
+      - 'lib/**'
+      - 'app/**'
+  workflow_dispatch:
+
+jobs:
+  validate:
+    name: Validate Claude Context Documentation
+    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: Validate JSON Schemas
+        run: |
+          echo "🔍 Validating JSON schemas..."
+          npx .claude/tools/bin/claude-context.js validate --schema
+        continue-on-error: false
+
+      - name: Validate Markdown Links
+        run: |
+          echo "🔗 Checking markdown links..."
+          npx .claude/tools/bin/claude-context.js validate --links
+        continue-on-error: false
+
+      - name: Check for Unresolved Placeholders
+        run: |
+          echo "📝 Checking for placeholders..."
+          npx .claude/tools/bin/claude-context.js validate --placeholders
+        continue-on-error: true  # Warning only
+
+      - name: Validate Directory Structure
+        run: |
+          echo "📁 Validating structure..."
+          npx .claude/tools/bin/claude-context.js validate --structure
+        continue-on-error: false
+
+      - name: Check Line Number Accuracy
+        run: |
+          echo "📍 Checking line number accuracy..."
+          npx .claude/tools/bin/claude-context.js validate --lines --threshold 60
+        continue-on-error: true  # Warning only for line drift
+
+      - name: Generate Validation Report
+        if: always()
+        run: |
+          echo "📊 Generating full validation report..."
+          npx .claude/tools/bin/claude-context.js validate --all --output markdown > validation-report.md
+          cat validation-report.md
+
+      - name: Upload Validation Report
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: validation-report
+          path: validation-report.md
+          retention-days: 7
+
+      - name: Comment on PR
+        if: github.event_name == 'pull_request' && failure()
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const fs = require('fs');
+            let report = '';
+            try {
+              report = fs.readFileSync('validation-report.md', 'utf8');
+            } catch (e) {
+              report = 'Validation report not available.';
+            }
+
+            github.rest.issues.createComment({
+              issue_number: context.issue.number,
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              body: `## 🔍 Documentation Validation Failed\n\n${report}\n\n---\n*Generated by Claude Context Engineering CI*`
+            });