create-claude-context 1.0.0 → 1.2.0

package/templates/base/research/RESEARCH_TEMPLATE.md

@@ -1,153 +1,153 @@
-# Research: [Feature/Bug Name]
-
-**Date:** YYYY-MM-DD
-**Researcher:** Claude Code
-**Status:** IN_PROGRESS | COMPLETE | BLOCKED
-**Context Budget Used:** X% of 200k
-
----
-
-## Objective
-
-[Clear statement of what we're trying to understand - 1-2 sentences]
-
----
-
-## Relevant Files Explored
-
-| File | Lines | Key Findings |
-|------|-------|--------------|
-| `path/to/file.ext` | XXX-YYY | [What this file does for the feature] |
-| `path/to/other.ext` | XXX-YYY | [What this file does for the feature] |
-
----
-
-## Code Flow Analysis
-
-**Entry Point → Exit Point Trace:**
-
-```
-entry_function() [file.ext:XXX]
-├─ step_one() [file.ext:YYY]
-│  └─ helper_function() [helper.ext:ZZZ]
-├─ step_two() [file.ext:AAA]
-│  ├─ database_query() [crud.ext:BBB]
-│  └─ external_api_call() [client.ext:CCC]
-└─ return_result() [file.ext:DDD]
-```
-
-**Decision Points:**
-- Line XXX: Condition check (if/else)
-- Line YYY: Type routing (switch/match)
-- Line ZZZ: Error handling (try/except)
-
----
-
-## Dependencies Identified
-
-### External Dependencies
-| Dependency | Type | Purpose |
-|------------|------|---------|
-| [API Name] | HTTP API | [What it does] |
-| [Library] | Package | [What it provides] |
-
-### Internal Dependencies
-| File | Purpose |
-|------|---------|
-| `service.ext` | [What it provides to this feature] |
-| `utils.ext` | [What utilities are used] |
-
----
-
-## Database Schema Involved
-
-| Table | Operations | Purpose |
-|-------|------------|---------|
-| `table_name` | READ/WRITE/UPDATE | [What data] |
-
----
-
-## Test Files & Coverage
-
-### Existing Tests
-| Test File | Coverage Area |
-|-----------|---------------|
-| `tests/test_feature.ext` | [What scenarios] |
-
-### Coverage Gaps
-- ❌ [Missing test scenario 1]
-- ❌ [Missing test scenario 2]
-- ⚠️ [Edge case not covered]
-
----
-
-## Known Gotchas
-
-Check `.claude/context/KNOWN_GOTCHAS.md` for:
-- [ ] Similar past issues
-- [ ] Related workarounds
-- [ ] Anti-patterns to avoid
-
-**Found Gotchas:**
-1. [Gotcha 1 if applicable]
-2. [Gotcha 2 if applicable]
-
----
-
-## Open Questions
-
-### Technical Questions
-- [ ] [Question about implementation detail]
-- [ ] [Question about architecture choice]
-
-### Business Logic Questions
-- [ ] [Question about requirements]
-- [ ] [Question about edge cases]
-
----
-
-## Summary (for Plan Phase)
-
-**Word Count Target: 150 words max**
-
-[Feature/Bug Name] is implemented across [X] files in [system area].
-
-**Entry Points:**
-- [Primary entry point with file:line]
-- [Secondary entry point if applicable]
-
-**Core Logic:**
-[1-2 sentences describing what the feature does]
-
-**Key Files:**
-1. [file_path] - [role in feature]
-2. [file_path] - [role in feature]
-3. [file_path] - [role in feature]
-
-**Dependencies:**
-- External: [API names]
-- Internal: [Service names]
-
-**Test Coverage:** [Good/Partial/Missing]
-
-**Recommended Approach:**
-[1 sentence on how to implement/fix]
-
-**Known Risks:**
-[1 sentence on primary risk]
-
----
-
-## Next Steps
-
-After research completes:
-1. ✅ Research document saved in `.claude/research/active/`
-2. ⏳ Run `/rpi-plan [feature-name]` to create implementation plan
-3. ⏳ Human reviews plan before `/rpi-implement`
-
----
-
-**Context Usage Report:**
-- Files read: X
-- Tokens used: ~Xk (X% of 200k)
-- Compaction needed: Yes/No
+# Research: [Feature/Bug Name]
+
+**Date:** YYYY-MM-DD
+**Researcher:** Claude Code
+**Status:** IN_PROGRESS | COMPLETE | BLOCKED
+**Context Budget Used:** X% of 200k
+
+---
+
+## Objective
+
+[Clear statement of what we're trying to understand - 1-2 sentences]
+
+---
+
+## Relevant Files Explored
+
+| File | Lines | Key Findings |
+|------|-------|--------------|
+| `path/to/file.ext` | XXX-YYY | [What this file does for the feature] |
+| `path/to/other.ext` | XXX-YYY | [What this file does for the feature] |
+
+---
+
+## Code Flow Analysis
+
+**Entry Point → Exit Point Trace:**
+
+```
+entry_function() [file.ext:XXX]
+├─ step_one() [file.ext:YYY]
+│  └─ helper_function() [helper.ext:ZZZ]
+├─ step_two() [file.ext:AAA]
+│  ├─ database_query() [crud.ext:BBB]
+│  └─ external_api_call() [client.ext:CCC]
+└─ return_result() [file.ext:DDD]
+```
+
+**Decision Points:**
+- Line XXX: Condition check (if/else)
+- Line YYY: Type routing (switch/match)
+- Line ZZZ: Error handling (try/except)
+
+---
+
+## Dependencies Identified
+
+### External Dependencies
+| Dependency | Type | Purpose |
+|------------|------|---------|
+| [API Name] | HTTP API | [What it does] |
+| [Library] | Package | [What it provides] |
+
+### Internal Dependencies
+| File | Purpose |
+|------|---------|
+| `service.ext` | [What it provides to this feature] |
+| `utils.ext` | [What utilities are used] |
+
+---
+
+## Database Schema Involved
+
+| Table | Operations | Purpose |
+|-------|------------|---------|
+| `table_name` | READ/WRITE/UPDATE | [What data] |
+
+---
+
+## Test Files & Coverage
+
+### Existing Tests
+| Test File | Coverage Area |
+|-----------|---------------|
+| `tests/test_feature.ext` | [What scenarios] |
+
+### Coverage Gaps
+- ❌ [Missing test scenario 1]
+- ❌ [Missing test scenario 2]
+- ⚠️ [Edge case not covered]
+
+---
+
+## Known Gotchas
+
+Check `.claude/context/KNOWN_GOTCHAS.md` for:
+- [ ] Similar past issues
+- [ ] Related workarounds
+- [ ] Anti-patterns to avoid
+
+**Found Gotchas:**
+1. [Gotcha 1 if applicable]
+2. [Gotcha 2 if applicable]
+
+---
+
+## Open Questions
+
+### Technical Questions
+- [ ] [Question about implementation detail]
+- [ ] [Question about architecture choice]
+
+### Business Logic Questions
+- [ ] [Question about requirements]
+- [ ] [Question about edge cases]
+
+---
+
+## Summary (for Plan Phase)
+
+**Word Count Target: 150 words max**
+
+[Feature/Bug Name] is implemented across [X] files in [system area].
+
+**Entry Points:**
+- [Primary entry point with file:line]
+- [Secondary entry point if applicable]
+
+**Core Logic:**
+[1-2 sentences describing what the feature does]
+
+**Key Files:**
+1. [file_path] - [role in feature]
+2. [file_path] - [role in feature]
+3. [file_path] - [role in feature]
+
+**Dependencies:**
+- External: [API names]
+- Internal: [Service names]
+
+**Test Coverage:** [Good/Partial/Missing]
+
+**Recommended Approach:**
+[1 sentence on how to implement/fix]
+
+**Known Risks:**
+[1 sentence on primary risk]
+
+---
+
+## Next Steps
+
+After research completes:
+1. ✅ Research document saved in `.claude/research/active/`
+2. ⏳ Run `/rpi-plan [feature-name]` to create implementation plan
+3. ⏳ Human reviews plan before `/rpi-implement`
+
+---
+
+**Context Usage Report:**
+- Files read: X
+- Tokens used: ~Xk (X% of 200k)
+- Compaction needed: Yes/No

package/templates/base/schemas/agent.schema.json

@@ -1,141 +1,141 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://claude-context.dev/schemas/agent.schema.json",
-  "title": "Claude Context Agent",
-  "description": "Schema for agent manifest files",
-  "type": "object",
-  "required": ["name", "version", "description"],
-  "properties": {
-    "$schema": {
-      "type": "string",
-      "description": "JSON Schema reference"
-    },
-    "name": {
-      "type": "string",
-      "pattern": "^[a-z0-9-]+$",
-      "minLength": 1,
-      "maxLength": 50,
-      "description": "Agent identifier (lowercase, hyphens allowed)"
-    },
-    "version": {
-      "type": "string",
-      "pattern": "^\\d+\\.\\d+\\.\\d+$",
-      "description": "Agent version (semver)"
-    },
-    "displayName": {
-      "type": "string",
-      "maxLength": 100,
-      "description": "Human-readable agent name"
-    },
-    "description": {
-      "type": "string",
-      "maxLength": 500,
-      "description": "Brief description of agent capabilities"
-    },
-    "author": {
-      "type": "string",
-      "description": "Agent author"
-    },
-    "license": {
-      "type": "string",
-      "description": "SPDX license identifier"
-    },
-    "keywords": {
-      "type": "array",
-      "items": { "type": "string" },
-      "maxItems": 10,
-      "description": "Keywords for agent discovery"
-    },
-    "category": {
-      "type": "string",
-      "enum": [
-        "initialization",
-        "architecture",
-        "database",
-        "api",
-        "integration",
-        "deployment",
-        "testing",
-        "documentation",
-        "custom"
-      ],
-      "description": "Agent category"
-    },
-    "complexity": {
-      "type": "string",
-      "enum": ["low", "medium", "high", "very-high"],
-      "description": "Task complexity this agent handles"
-    },
-    "capabilities": {
-      "type": "array",
-      "items": { "type": "string" },
-      "description": "List of capabilities (e.g., diagram-generation, dependency-analysis)"
-    },
-    "workflows": {
-      "type": "array",
-      "items": { "type": "string" },
-      "description": "Workflows this agent specializes in"
-    },
-    "commands": {
-      "type": "array",
-      "items": { "type": "string" },
-      "description": "Commands this agent can invoke"
-    },
-    "dependencies": {
-      "type": "object",
-      "properties": {
-        "agents": {
-          "type": "array",
-          "items": { "type": "string" },
-          "description": "Required agents"
-        },
-        "commands": {
-          "type": "array",
-          "items": { "type": "string" },
-          "description": "Required commands"
-        }
-      }
-    },
-    "config": {
-      "type": "object",
-      "properties": {
-        "context_budget": {
-          "type": "string",
-          "description": "Typical context usage (e.g., '~50k tokens')"
-        },
-        "timeout_minutes": {
-          "type": "integer",
-          "minimum": 1,
-          "maximum": 120,
-          "description": "Execution timeout in minutes"
-        }
-      }
-    },
-    "hooks": {
-      "type": "object",
-      "properties": {
-        "pre_invoke": {
-          "type": ["string", "null"],
-          "description": "Command to run before agent invocation"
-        },
-        "post_invoke": {
-          "type": ["string", "null"],
-          "description": "Command to run after agent completion"
-        }
-      }
-    },
-    "examples": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "properties": {
-          "invocation": { "type": "string" },
-          "description": { "type": "string" }
-        },
-        "required": ["invocation", "description"]
-      },
-      "description": "Example invocations"
-    }
-  },
-  "additionalProperties": false
-}
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://claude-context.dev/schemas/agent.schema.json",
+  "title": "Claude Context Agent",
+  "description": "Schema for agent manifest files",
+  "type": "object",
+  "required": ["name", "version", "description"],
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "JSON Schema reference"
+    },
+    "name": {
+      "type": "string",
+      "pattern": "^[a-z0-9-]+$",
+      "minLength": 1,
+      "maxLength": 50,
+      "description": "Agent identifier (lowercase, hyphens allowed)"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$",
+      "description": "Agent version (semver)"
+    },
+    "displayName": {
+      "type": "string",
+      "maxLength": 100,
+      "description": "Human-readable agent name"
+    },
+    "description": {
+      "type": "string",
+      "maxLength": 500,
+      "description": "Brief description of agent capabilities"
+    },
+    "author": {
+      "type": "string",
+      "description": "Agent author"
+    },
+    "license": {
+      "type": "string",
+      "description": "SPDX license identifier"
+    },
+    "keywords": {
+      "type": "array",
+      "items": { "type": "string" },
+      "maxItems": 10,
+      "description": "Keywords for agent discovery"
+    },
+    "category": {
+      "type": "string",
+      "enum": [
+        "initialization",
+        "architecture",
+        "database",
+        "api",
+        "integration",
+        "deployment",
+        "testing",
+        "documentation",
+        "custom"
+      ],
+      "description": "Agent category"
+    },
+    "complexity": {
+      "type": "string",
+      "enum": ["low", "medium", "high", "very-high"],
+      "description": "Task complexity this agent handles"
+    },
+    "capabilities": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "List of capabilities (e.g., diagram-generation, dependency-analysis)"
+    },
+    "workflows": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Workflows this agent specializes in"
+    },
+    "commands": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Commands this agent can invoke"
+    },
+    "dependencies": {
+      "type": "object",
+      "properties": {
+        "agents": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Required agents"
+        },
+        "commands": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Required commands"
+        }
+      }
+    },
+    "config": {
+      "type": "object",
+      "properties": {
+        "context_budget": {
+          "type": "string",
+          "description": "Typical context usage (e.g., '~50k tokens')"
+        },
+        "timeout_minutes": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 120,
+          "description": "Execution timeout in minutes"
+        }
+      }
+    },
+    "hooks": {
+      "type": "object",
+      "properties": {
+        "pre_invoke": {
+          "type": ["string", "null"],
+          "description": "Command to run before agent invocation"
+        },
+        "post_invoke": {
+          "type": ["string", "null"],
+          "description": "Command to run after agent completion"
+        }
+      }
+    },
+    "examples": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "invocation": { "type": "string" },
+          "description": { "type": "string" }
+        },
+        "required": ["invocation", "description"]
+      },
+      "description": "Example invocations"
+    }
+  },
+  "additionalProperties": false
+}

package/templates/base/schemas/anchors.schema.json

@@ -0,0 +1,54 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://claude-context.dev/schemas/anchors.schema.json",
+  "title": "Claude Context Semantic Anchors",
+  "description": "Schema for sync/anchors.json - maps function signatures to workflow references",
+  "type": "object",
+  "required": ["version"],
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "JSON Schema reference"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$"
+    },
+    "description": {
+      "type": "string"
+    },
+    "generatedAt": {
+      "type": ["string", "null"],
+      "format": "date-time"
+    },
+    "files": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "properties": {
+          "anchors": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "object",
+              "properties": {
+                "line": { "type": "integer" },
+                "type": { "type": "string" },
+                "signature": { "type": "string" },
+                "hash": { "type": "string" },
+                "workflows": {
+                  "type": "array",
+                  "items": { "type": "string" }
+                }
+              }
+            }
+          },
+          "updatedAt": {
+            "type": "string",
+            "format": "date-time"
+          }
+        }
+      }
+    }
+  },
+  "additionalProperties": false
+}