claude-code-orchestrator-kit 1.0.0

package/.claude/skills/generate-report-header/SKILL.md

@@ -0,0 +1,228 @@
+---
+name: generate-report-header
+description: Create standardized report headers with metadata for all agent-generated reports. Use when generating bug reports, security audits, dependency reports, or any worker output requiring consistent formatting.
+---
+
+# Generate Report Header
+
+Create consistent, well-formatted headers for all agent-generated reports with proper metadata.
+
+## When to Use
+
+- Beginning of all worker-generated reports
+- Summary documents
+- Validation reports
+- Audit reports
+- Any standardized output requiring header
+
+## Instructions
+
+### Step 1: Collect Header Information
+
+Gather required information for header.
+
+**Expected Input**:
+- `reportType`: String (e.g., "Bug Hunting", "Security Audit", "Version Update")
+- `version`: String (e.g., "0.8.0", "2025-10-17", "final")
+- `status`: String (success|partial|failed|in_progress)
+- `timestamp`: String (optional, ISO-8601 format, defaults to current time)
+- `duration`: String (optional, e.g., "3m 45s", "1h 12m")
+- `workflow`: String (optional, e.g., "bugs", "security", "dead-code", "dependencies")
+- `phase`: String (optional, e.g., "detection", "fixing", "verification")
+- `additionalMetadata`: Object (optional, extra fields)
+
+### Step 2: Format Timestamp
+
+Convert timestamp to readable format if needed.
+
+**Format**: "YYYY-MM-DD HH:mm:ss UTC"
+
+**Example**: "2025-10-17 14:30:00 UTC"
+
+### Step 3: Determine Status Emoji
+
+Map status to appropriate emoji.
+
+**Status Mapping**:
+- `success`: ✅
+- `partial`: ⚠️
+- `failed`: ❌
+- `in_progress`: 🔄
+
+### Step 4: Generate Header
+
+Create formatted markdown header.
+
+**Expected Output**:
+```markdown
+# {ReportType} Report: {Version}
+
+**Generated**: {Timestamp}
+**Status**: {StatusEmoji} {Status}
+**Version**: {Version}
+**Duration**: {Duration} (if provided)
+**Workflow**: {Workflow} (if provided)
+**Phase**: {Phase} (if provided)
+
+---
+
+## Executive Summary
+```
+
+**Standard Metrics** (include when available):
+- Timestamp (ISO-8601)
+- Duration (human-readable)
+- Workflow (domain: bugs, security, dead-code, dependencies)
+- Phase (detection, fixing, verification)
+- Validation Status (✅ PASSED, ⛔ FAILED, ⚠️ PARTIAL)
+
+### Step 5: Add Optional Metadata
+
+Include additional metadata fields if provided.
+
+**Optional Fields**:
+- Agent name
+- Duration
+- File count
+- Issue count
+- Any custom fields
+
+## Error Handling
+
+- **Missing Report Type**: Return error requesting report type
+- **Invalid Status**: Return error listing valid statuses
+- **Invalid Timestamp**: Use current time and warn
+
+## Examples
+
+### Example 1: Bug Hunting Report
+
+**Input**:
+```json
+{
+  "reportType": "Bug Hunting",
+  "version": "2025-10-17",
+  "status": "success",
+  "additionalMetadata": {
+    "agent": "bug-hunter",
+    "filesScanned": 147,
+    "bugsFound": 23
+  }
+}
+```
+
+**Output**:
+```markdown
+# Bug Hunting Report: 2025-10-17
+
+**Generated**: 2025-10-17 14:30:00 UTC
+**Status**: ✅ success
+**Version**: 2025-10-17
+**Agent**: bug-hunter
+**Files Scanned**: 147
+**Bugs Found**: 23
+
+---
+
+## Executive Summary
+```
+
+### Example 2: Version Update Report
+
+**Input**:
+```json
+{
+  "reportType": "Version Update",
+  "version": "0.7.0 → 0.8.0",
+  "status": "success"
+}
+```
+
+**Output**:
+```markdown
+# Version Update Report: 0.7.0 → 0.8.0
+
+**Generated**: 2025-10-17 14:30:00 UTC
+**Status**: ✅ success
+**Version**: 0.7.0 → 0.8.0
+
+---
+
+## Executive Summary
+```
+
+### Example 3: Security Audit (Partial)
+
+**Input**:
+```json
+{
+  "reportType": "Security Audit",
+  "version": "final",
+  "status": "partial",
+  "timestamp": "2025-10-17T14:30:00Z",
+  "additionalMetadata": {
+    "criticalIssues": 2,
+    "highIssues": 5,
+    "fixedIssues": 5
+  }
+}
+```
+
+**Output**:
+```markdown
+# Security Audit Report: final
+
+**Generated**: 2025-10-17 14:30:00 UTC
+**Status**: ⚠️ partial
+**Version**: final
+**Critical Issues**: 2
+**High Issues**: 5
+**Fixed Issues**: 5
+
+---
+
+## Executive Summary
+```
+
+### Example 4: Failed Dependency Update
+
+**Input**:
+```json
+{
+  "reportType": "Dependency Update",
+  "version": "2025-10-17",
+  "status": "failed",
+  "additionalMetadata": {
+    "error": "npm install failed",
+    "failedPackages": ["package-a", "package-b"]
+  }
+}
+```
+
+**Output**:
+```markdown
+# Dependency Update Report: 2025-10-17
+
+**Generated**: 2025-10-17 14:30:00 UTC
+**Status**: ❌ failed
+**Version**: 2025-10-17
+**Error**: npm install failed
+**Failed Packages**: package-a, package-b
+
+---
+
+## Executive Summary
+```
+
+## Validation
+
+- [ ] Generates header with all required fields
+- [ ] Formats timestamp correctly
+- [ ] Maps status to correct emoji
+- [ ] Includes additional metadata when provided
+- [ ] Validates status values
+- [ ] Uses current time if timestamp missing
+
+## Supporting Files
+
+- `template.md`: Report header template (see Supporting Files section)

package/.claude/skills/generate-report-header/template.md

@@ -0,0 +1,66 @@
+# Report Header Template
+
+## Standard Format
+
+```markdown
+# {ReportType} Report: {Version}
+
+**Generated**: {Timestamp}
+**Status**: {Emoji} {Status}
+**Version**: {Version}
+
+---
+
+## Executive Summary
+```
+
+## Status Values
+
+- **success** (✅): Operation completed successfully
+- **partial** (⚠️): Operation completed with warnings or partial failures
+- **failed** (❌): Operation failed critically
+- **in_progress** (🔄): Operation is currently running
+
+## Timestamp Format
+
+ISO-8601 or human-readable: "YYYY-MM-DD HH:mm:ss UTC"
+
+## Optional Metadata Fields
+
+Common additional fields:
+- **Agent**: Worker agent name
+- **Duration**: Execution time
+- **Files Processed**: Number of files
+- **Issues Found**: Count of issues
+- **Error**: Error message (for failed status)
+
+## Report Types
+
+- Bug Hunting Report
+- Security Audit Report
+- Dead Code Report
+- Dependency Audit Report
+- Version Update Report
+- Code Health Report
+- Verification Report
+
+## Example Complete Header
+
+```markdown
+# Bug Hunting Report: 2025-10-17
+
+**Generated**: 2025-10-17 14:30:00 UTC
+**Status**: ✅ success
+**Version**: 2025-10-17
+**Agent**: bug-hunter
+**Duration**: 3m 45s
+**Files Scanned**: 147
+**Bugs Found**: 23
+
+---
+
+## Executive Summary
+
+This report documents the results of automated bug detection across the codebase.
+Critical: 3 | High: 8 | Medium: 12
+```

package/.claude/skills/parse-error-logs/SKILL.md

@@ -0,0 +1,286 @@
+---
+name: parse-error-logs
+description: Parse build errors, test failures, type-check output, and validation logs into structured data. Use when processing npm/pnpm output, TypeScript errors, Jest failures, or any validation command results for quality gates.
+allowed-tools: Read
+---
+
+# Parse Error Logs
+
+Parse error and validation output from various tools into structured, actionable data.
+
+## When to Use
+
+- Quality gate validation (type-check, build, tests)
+- Parse TypeScript compiler errors
+- Extract test failure information
+- Process npm/pnpm command output
+- Summarize validation results
+- Feed error data to bug-fixer or other workers
+
+## Instructions
+
+### Step 1: Receive Raw Output
+
+Accept raw command output as input.
+
+**Expected Input**:
+- `output`: String (raw stdout/stderr from command)
+- `type`: String (typescript|jest|npm|build|generic)
+
+### Step 2: Identify Error Patterns
+
+Detect error patterns based on type.
+
+**TypeScript Patterns**:
+```
+error TS2322: Type 'string' is not assignable to type 'number'.
+src/file.ts(10,5): error TS2322
+```
+
+**Jest Patterns**:
+```
+FAIL src/test.spec.ts
+● Test Suite › test name
+  Expected: 5
+  Received: 3
+```
+
+**npm/pnpm Patterns**:
+```
+ERR! code ENOENT
+ERR! syscall open
+ERR! path /path/to/file
+```
+
+**Build Patterns**:
+```
+ERROR in ./src/file.ts
+Module not found: Error: Can't resolve 'module'
+```
+
+### Step 3: Extract Error Details
+
+Parse each error into structured format.
+
+**For Each Error Extract**:
+- `file`: File path (if available)
+- `line`: Line number (if available)
+- `column`: Column number (if available)
+- `code`: Error code (e.g., "TS2322", "ENOENT")
+- `message`: Error message
+- `severity`: error|warning|info
+- `type`: Classification (type-error, test-failure, dependency, etc.)
+
+### Step 4: Categorize and Count
+
+Group errors by type and count occurrences.
+
+**Categories**:
+- Type errors
+- Test failures
+- Dependency issues
+- Build errors
+- Linting errors
+- Runtime errors
+
+### Step 5: Return Structured Data
+
+Return complete error analysis.
+
+**Expected Output**:
+```json
+{
+  "success": false,
+  "totalErrors": 15,
+  "totalWarnings": 3,
+  "summary": {
+    "typeErrors": 8,
+    "testFailures": 5,
+    "buildErrors": 2
+  },
+  "errors": [
+    {
+      "file": "src/utils.ts",
+      "line": 42,
+      "column": 10,
+      "code": "TS2322",
+      "message": "Type 'string' is not assignable to type 'number'",
+      "severity": "error",
+      "type": "type-error"
+    }
+  ],
+  "warnings": [
+    {
+      "file": "src/deprecated.ts",
+      "line": 15,
+      "code": "TS6133",
+      "message": "'oldFunction' is declared but never used",
+      "severity": "warning",
+      "type": "unused-variable"
+    }
+  ]
+}
+```
+
+## Error Handling
+
+- **Empty Output**: Return success with zero errors
+- **Unrecognized Format**: Return generic parse with raw message
+- **Partial Parse**: Include what was parsed, note unparsable lines
+- **Invalid Type**: Warn and default to "generic" parsing
+
+## Examples
+
+### Example 1: TypeScript Errors
+
+**Input**:
+```json
+{
+  "output": "src/app.ts(10,5): error TS2322: Type 'string' is not assignable to type 'number'.\nsrc/utils.ts(25,12): error TS2304: Cannot find name 'undefined'.",
+  "type": "typescript"
+}
+```
+
+**Output**:
+```json
+{
+  "success": false,
+  "totalErrors": 2,
+  "totalWarnings": 0,
+  "summary": {
+    "typeErrors": 2
+  },
+  "errors": [
+    {
+      "file": "src/app.ts",
+      "line": 10,
+      "column": 5,
+      "code": "TS2322",
+      "message": "Type 'string' is not assignable to type 'number'",
+      "severity": "error",
+      "type": "type-error"
+    },
+    {
+      "file": "src/utils.ts",
+      "line": 25,
+      "column": 12,
+      "code": "TS2304",
+      "message": "Cannot find name 'undefined'",
+      "severity": "error",
+      "type": "type-error"
+    }
+  ],
+  "warnings": []
+}
+```
+
+### Example 2: Jest Test Failures
+
+**Input**:
+```json
+{
+  "output": "FAIL src/utils.test.ts\n  ● Math › addition\n    expect(received).toBe(expected)\n    Expected: 5\n    Received: 3\n      at Object.<anonymous> (src/utils.test.ts:10:15)",
+  "type": "jest"
+}
+```
+
+**Output**:
+```json
+{
+  "success": false,
+  "totalErrors": 1,
+  "totalWarnings": 0,
+  "summary": {
+    "testFailures": 1
+  },
+  "errors": [
+    {
+      "file": "src/utils.test.ts",
+      "line": 10,
+      "column": 15,
+      "code": null,
+      "message": "expect(received).toBe(expected) - Expected: 5, Received: 3",
+      "severity": "error",
+      "type": "test-failure",
+      "testName": "Math › addition"
+    }
+  ],
+  "warnings": []
+}
+```
+
+### Example 3: Successful Build
+
+**Input**:
+```json
+{
+  "output": "✓ Built successfully\nCompleted in 2.3s",
+  "type": "build"
+}
+```
+
+**Output**:
+```json
+{
+  "success": true,
+  "totalErrors": 0,
+  "totalWarnings": 0,
+  "summary": {},
+  "errors": [],
+  "warnings": []
+}
+```
+
+### Example 4: Mixed Errors and Warnings
+
+**Input**:
+```json
+{
+  "output": "Warning: React Hook useEffect has a missing dependency\nerror TS2339: Property 'foo' does not exist on type 'Bar'",
+  "type": "typescript"
+}
+```
+
+**Output**:
+```json
+{
+  "success": false,
+  "totalErrors": 1,
+  "totalWarnings": 1,
+  "summary": {
+    "typeErrors": 1,
+    "lintWarnings": 1
+  },
+  "errors": [
+    {
+      "code": "TS2339",
+      "message": "Property 'foo' does not exist on type 'Bar'",
+      "severity": "error",
+      "type": "type-error"
+    }
+  ],
+  "warnings": [
+    {
+      "message": "React Hook useEffect has a missing dependency",
+      "severity": "warning",
+      "type": "lint-warning"
+    }
+  ]
+}
+```
+
+## Validation
+
+- [ ] Parses TypeScript errors correctly
+- [ ] Parses Jest test failures
+- [ ] Parses npm/pnpm errors
+- [ ] Parses build errors
+- [ ] Extracts file, line, column when available
+- [ ] Categorizes errors by type
+- [ ] Returns summary counts
+- [ ] Handles successful output (zero errors)
+- [ ] Handles mixed errors and warnings
+
+## Supporting Files
+
+- `patterns.json`: Regex patterns for common error formats

package/.claude/skills/parse-error-logs/patterns.json

@@ -0,0 +1,26 @@
+{
+  "typescript": {
+    "error": "^(.+?)\\((\\d+),(\\d+)\\):\\s*(error|warning)\\s+(TS\\d+):\\s*(.+)$",
+    "simple": "^(error|warning)\\s+(TS\\d+):\\s*(.+)$"
+  },
+  "jest": {
+    "fail": "^FAIL\\s+(.+)$",
+    "testName": "^\\s*●\\s+(.+)$",
+    "expected": "Expected:\\s*(.+)",
+    "received": "Received:\\s*(.+)",
+    "location": "at\\s+.+?\\((.+?):(\\d+):(\\d+)\\)"
+  },
+  "npm": {
+    "error": "^npm\\s+ERR!\\s+(.+)$",
+    "code": "^npm\\s+ERR!\\s+code\\s+(.+)$",
+    "path": "^npm\\s+ERR!\\s+path\\s+(.+)$"
+  },
+  "build": {
+    "error": "^ERROR\\s+in\\s+(.+)$",
+    "moduleNotFound": "Module not found:\\s*Error:\\s*(.+)"
+  },
+  "generic": {
+    "error": "^(error|ERROR)[:s]+(.+)$",
+    "warning": "^(warning|WARNING|WARN)[:s]+(.+)$"
+  }
+}