create-claude-context 1.0.0 → 1.2.1

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

@@ -1,105 +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*`
-            });
+# 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*`
+            });

package/templates/base/commands/analytics.md

@@ -1,238 +1,238 @@
----
-name: analytics
-version: "1.0.0"
-displayName: "Usage Analytics"
-description: "View local usage statistics and context metrics"
-category: "system"
-complexity: "low"
-context_budget: "~5K tokens"
-typical_context_usage: "2%"
-prerequisites:
-  - "Analytics enabled in settings (optional)"
-outputs:
-  - "Usage statistics report"
-  - "Context metrics summary"
-  - "Exported metrics file (with --export)"
-related_agents: []
-examples:
-  - command: "/analytics"
-    description: "View local usage statistics"
-  - command: "/analytics context"
-    description: "Show context budget metrics"
-  - command: "/analytics export"
-    description: "Export metrics to JSON file"
----
-
-# /analytics - Usage Analytics Command
-
-View local usage statistics, context metrics, and export data for analysis.
-
-## Privacy First
-
-**All analytics are local by default.** No data is sent externally unless explicitly configured in `.claude/settings.json`:
-
-```json
-{
-  "telemetry": {
-    "enabled": false
-  }
-}
-```
-
-## Subcommands
-
-### `/analytics` (default)
-
-Display summary of local usage statistics.
-
-**Metrics Shown:**
-- Session count (last 7/30 days)
-- Command usage frequency
-- Agent invocation counts
-- Average session duration
-- Files modified per session
-
-### `/analytics context`
-
-Show context budget metrics and trends.
-
-**Metrics Shown:**
-- Current documentation size (tokens)
-- Budget utilization percentage
-- Largest context consumers
-- Token trend over time
-- Recommendations for optimization
-
-### `/analytics commands`
-
-Show command usage breakdown.
-
-**Metrics Shown:**
-- Most used commands
-- Command success/failure rates
-- Average command duration
-- Command usage by day/week
-
-### `/analytics agents`
-
-Show agent utilization breakdown.
-
-**Metrics Shown:**
-- Most invoked agents
-- Agent task completion rates
-- Average context per agent
-- Agent usage patterns
-
-### `/analytics export`
-
-Export metrics to JSON file.
-
-**Output:** `.claude/analytics/export-YYYY-MM-DD.json`
-
-### `/analytics clear`
-
-Clear local analytics data.
-
-**Confirmation required** before clearing.
-
-## Usage Examples
-
-### View Summary Statistics
-
-```
-User: /analytics
-
-Claude: ## Usage Analytics (Local)
-
-### Session Summary (Last 30 Days)
-| Metric | Value |
-|--------|-------|
-| Total Sessions | 42 |
-| Avg Duration | 45 min |
-| Files Modified | 312 |
-| Commits Made | 87 |
-
-### Top Commands
-1. /rpi-research (23 uses)
-2. /rpi-implement (19 uses)
-3. /verify-docs-current (15 uses)
-4. /rpi-plan (12 uses)
-5. /help (8 uses)
-
-### Top Agents
-1. @core-architect (18 invocations)
-2. @api-developer (14 invocations)
-3. @database-ops (9 invocations)
-
-### Context Health
-- Documentation: 45K tokens (23% of budget)
-- Status: Healthy ✓
-
-Data stored locally in .claude/analytics/
-```
-
-### View Context Metrics
-
-```
-User: /analytics context
-
-Claude: ## Context Budget Analysis
-
-### Current State
-| Category | Tokens | % Budget |
-|----------|--------|----------|
-| Indexes | 12,400 | 6.2% |
-| Workflows | 18,200 | 9.1% |
-| Agents | 8,600 | 4.3% |
-| Commands | 5,800 | 2.9% |
-| **Total** | **45,000** | **22.5%** |
-
-### Budget Status
-✓ Under 40% target (healthy)
-
-### Largest Files
-1. context/workflows/authentication.md (4,200 tokens)
-2. context/ARCHITECTURE_SNAPSHOT.md (3,800 tokens)
-3. agents/core-architect.md (2,100 tokens)
-
-### Trend (Last 4 Weeks)
-Week 1: 42K tokens
-Week 2: 43K tokens
-Week 3: 44K tokens
-Week 4: 45K tokens (+7% growth)
-
-### Recommendations
-- Growth rate sustainable
-- No immediate action needed
-- Review if exceeds 50K tokens
-```
-
-### Export Metrics
-
-```
-User: /analytics export
-
-Claude: Exporting analytics data...
-
-Exported to: .claude/analytics/export-2024-01-15.json
-
-Contents:
-- Session history (42 sessions)
-- Command usage (156 invocations)
-- Agent usage (41 invocations)
-- Context metrics (4 weekly snapshots)
-
-File size: 24 KB
-```
-
-## Data Storage
-
-Analytics data is stored locally in `.claude/analytics/`:
-
-```
-.claude/analytics/
-├── sessions.json      # Session history
-├── commands.json      # Command usage
-├── agents.json        # Agent invocations
-├── context.json       # Context metrics
-└── exports/           # Exported files
-```
-
-## Configuration
-
-Configure analytics behavior in `.claude/settings.json`:
-
-```json
-{
-  "telemetry": {
-    "enabled": false,
-    "events": {
-      "command_usage": true,
-      "context_metrics": true,
-      "error_reports": false
-    },
-    "retention_days": 90
-  }
-}
-```
-
-| Setting | Default | Description |
-|---------|---------|-------------|
-| `enabled` | false | Enable/disable all tracking |
-| `command_usage` | true | Track command invocations |
-| `context_metrics` | true | Track context budget |
-| `error_reports` | false | Track errors (local only) |
-| `retention_days` | 90 | Days to retain data |
-
-## Privacy Notes
-
-1. **Local Only**: All data stays on your machine
-2. **No External Calls**: Nothing sent to external services
-3. **User Control**: Clear data anytime with `/analytics clear`
-4. **Opt-in**: Tracking disabled by default
-5. **Transparent**: All data in readable JSON files
-
-## Related
-
-- [Settings Configuration](./../settings.json)
-- [Context Budget Guidelines](./../README.md#context-budget)
+---
+name: analytics
+version: "1.0.0"
+displayName: "Usage Analytics"
+description: "View local usage statistics and context metrics"
+category: "system"
+complexity: "low"
+context_budget: "~5K tokens"
+typical_context_usage: "2%"
+prerequisites:
+  - "Analytics enabled in settings (optional)"
+outputs:
+  - "Usage statistics report"
+  - "Context metrics summary"
+  - "Exported metrics file (with --export)"
+related_agents: []
+examples:
+  - command: "/analytics"
+    description: "View local usage statistics"
+  - command: "/analytics context"
+    description: "Show context budget metrics"
+  - command: "/analytics export"
+    description: "Export metrics to JSON file"
+---
+
+# /analytics - Usage Analytics Command
+
+View local usage statistics, context metrics, and export data for analysis.
+
+## Privacy First
+
+**All analytics are local by default.** No data is sent externally unless explicitly configured in `.claude/settings.json`:
+
+```json
+{
+  "telemetry": {
+    "enabled": false
+  }
+}
+```
+
+## Subcommands
+
+### `/analytics` (default)
+
+Display summary of local usage statistics.
+
+**Metrics Shown:**
+- Session count (last 7/30 days)
+- Command usage frequency
+- Agent invocation counts
+- Average session duration
+- Files modified per session
+
+### `/analytics context`
+
+Show context budget metrics and trends.
+
+**Metrics Shown:**
+- Current documentation size (tokens)
+- Budget utilization percentage
+- Largest context consumers
+- Token trend over time
+- Recommendations for optimization
+
+### `/analytics commands`
+
+Show command usage breakdown.
+
+**Metrics Shown:**
+- Most used commands
+- Command success/failure rates
+- Average command duration
+- Command usage by day/week
+
+### `/analytics agents`
+
+Show agent utilization breakdown.
+
+**Metrics Shown:**
+- Most invoked agents
+- Agent task completion rates
+- Average context per agent
+- Agent usage patterns
+
+### `/analytics export`
+
+Export metrics to JSON file.
+
+**Output:** `.claude/analytics/export-YYYY-MM-DD.json`
+
+### `/analytics clear`
+
+Clear local analytics data.
+
+**Confirmation required** before clearing.
+
+## Usage Examples
+
+### View Summary Statistics
+
+```
+User: /analytics
+
+Claude: ## Usage Analytics (Local)
+
+### Session Summary (Last 30 Days)
+| Metric | Value |
+|--------|-------|
+| Total Sessions | 42 |
+| Avg Duration | 45 min |
+| Files Modified | 312 |
+| Commits Made | 87 |
+
+### Top Commands
+1. /rpi-research (23 uses)
+2. /rpi-implement (19 uses)
+3. /verify-docs-current (15 uses)
+4. /rpi-plan (12 uses)
+5. /help (8 uses)
+
+### Top Agents
+1. @core-architect (18 invocations)
+2. @api-developer (14 invocations)
+3. @database-ops (9 invocations)
+
+### Context Health
+- Documentation: 45K tokens (23% of budget)
+- Status: Healthy ✓
+
+Data stored locally in .claude/analytics/
+```
+
+### View Context Metrics
+
+```
+User: /analytics context
+
+Claude: ## Context Budget Analysis
+
+### Current State
+| Category | Tokens | % Budget |
+|----------|--------|----------|
+| Indexes | 12,400 | 6.2% |
+| Workflows | 18,200 | 9.1% |
+| Agents | 8,600 | 4.3% |
+| Commands | 5,800 | 2.9% |
+| **Total** | **45,000** | **22.5%** |
+
+### Budget Status
+✓ Under 40% target (healthy)
+
+### Largest Files
+1. context/workflows/authentication.md (4,200 tokens)
+2. context/ARCHITECTURE_SNAPSHOT.md (3,800 tokens)
+3. agents/core-architect.md (2,100 tokens)
+
+### Trend (Last 4 Weeks)
+Week 1: 42K tokens
+Week 2: 43K tokens
+Week 3: 44K tokens
+Week 4: 45K tokens (+7% growth)
+
+### Recommendations
+- Growth rate sustainable
+- No immediate action needed
+- Review if exceeds 50K tokens
+```
+
+### Export Metrics
+
+```
+User: /analytics export
+
+Claude: Exporting analytics data...
+
+Exported to: .claude/analytics/export-2024-01-15.json
+
+Contents:
+- Session history (42 sessions)
+- Command usage (156 invocations)
+- Agent usage (41 invocations)
+- Context metrics (4 weekly snapshots)
+
+File size: 24 KB
+```
+
+## Data Storage
+
+Analytics data is stored locally in `.claude/analytics/`:
+
+```
+.claude/analytics/
+├── sessions.json      # Session history
+├── commands.json      # Command usage
+├── agents.json        # Agent invocations
+├── context.json       # Context metrics
+└── exports/           # Exported files
+```
+
+## Configuration
+
+Configure analytics behavior in `.claude/settings.json`:
+
+```json
+{
+  "telemetry": {
+    "enabled": false,
+    "events": {
+      "command_usage": true,
+      "context_metrics": true,
+      "error_reports": false
+    },
+    "retention_days": 90
+  }
+}
+```
+
+| Setting | Default | Description |
+|---------|---------|-------------|
+| `enabled` | false | Enable/disable all tracking |
+| `command_usage` | true | Track command invocations |
+| `context_metrics` | true | Track context budget |
+| `error_reports` | false | Track errors (local only) |
+| `retention_days` | 90 | Days to retain data |
+
+## Privacy Notes
+
+1. **Local Only**: All data stays on your machine
+2. **No External Calls**: Nothing sent to external services
+3. **User Control**: Clear data anytime with `/analytics clear`
+4. **Opt-in**: Tracking disabled by default
+5. **Transparent**: All data in readable JSON files
+
+## Related
+
+- [Settings Configuration](./../settings.json)
+- [Context Budget Guidelines](./../README.md#context-budget)