create-claude-context 1.0.0 → 1.2.0

package/templates/base/config/environments/development.json

@@ -1,13 +1,13 @@
-{
-  "$comment": "Development environment overrides",
-  "logging": {
-    "level": "debug"
-  },
-  "validation": {
-    "on_commit": false,
-    "line_accuracy_threshold": 50
-  },
-  "rpi_workflow": {
-    "require_human_approval": false
-  }
-}
+{
+  "$comment": "Development environment overrides",
+  "logging": {
+    "level": "debug"
+  },
+  "validation": {
+    "on_commit": false,
+    "line_accuracy_threshold": 50
+  },
+  "rpi_workflow": {
+    "require_human_approval": false
+  }
+}

package/templates/base/config/environments/production.json

@@ -1,17 +1,17 @@
-{
-  "$comment": "Production environment overrides",
-  "logging": {
-    "level": "warn"
-  },
-  "validation": {
-    "on_commit": true,
-    "line_accuracy_threshold": 70,
-    "link_check_external": true
-  },
-  "rpi_workflow": {
-    "require_human_approval": true
-  },
-  "documentation": {
-    "auto_commit_docs": false
-  }
-}
+{
+  "$comment": "Production environment overrides",
+  "logging": {
+    "level": "warn"
+  },
+  "validation": {
+    "on_commit": true,
+    "line_accuracy_threshold": 70,
+    "link_check_external": true
+  },
+  "rpi_workflow": {
+    "require_human_approval": true
+  },
+  "documentation": {
+    "auto_commit_docs": false
+  }
+}

package/templates/base/config/environments/staging.json

@@ -1,13 +1,13 @@
-{
-  "$comment": "Staging environment overrides",
-  "logging": {
-    "level": "info"
-  },
-  "validation": {
-    "on_commit": true,
-    "line_accuracy_threshold": 60
-  },
-  "rpi_workflow": {
-    "require_human_approval": true
-  }
-}
+{
+  "$comment": "Staging environment overrides",
+  "logging": {
+    "level": "info"
+  },
+  "validation": {
+    "on_commit": true,
+    "line_accuracy_threshold": 60
+  },
+  "rpi_workflow": {
+    "require_human_approval": true
+  }
+}

package/templates/base/config/local.json.example

@@ -1,21 +1,21 @@
-{
-  "$comment": "Local overrides - copy to local.json (gitignored)",
-  "$instructions": "This file is an example. Copy to local.json and customize.",
-
-  "logging": {
-    "level": "debug",
-    "file": ".claude/logs/claude-local.log"
-  },
-
-  "validation": {
-    "on_commit": false
-  },
-
-  "rpi_workflow": {
-    "require_human_approval": false
-  },
-
-  "telemetry": {
-    "enabled": false
-  }
-}
+{
+  "$comment": "Local overrides - copy to local.json (gitignored)",
+  "$instructions": "This file is an example. Copy to local.json and customize.",
+
+  "logging": {
+    "level": "debug",
+    "file": ".claude/logs/claude-local.log"
+  },
+
+  "validation": {
+    "on_commit": false
+  },
+
+  "rpi_workflow": {
+    "require_human_approval": false
+  },
+
+  "telemetry": {
+    "enabled": false
+  }
+}

package/templates/base/context/.meta/generated-at.json

@@ -0,0 +1,18 @@
+{
+  "CODE_TO_WORKFLOW_MAP.md": {
+    "generatedAt": null,
+    "filesScanned": 0,
+    "referencesFound": 0,
+    "status": "pending"
+  },
+  "WORKFLOW_CATEGORY_INDEX": {
+    "generatedAt": null,
+    "itemCount": 0,
+    "status": "pending"
+  },
+  "AGENT_CATEGORY_INDEX": {
+    "generatedAt": null,
+    "itemCount": 0,
+    "status": "pending"
+  }
+}

package/templates/base/context/ARCHITECTURE_SNAPSHOT.md

@@ -1,156 +1,156 @@
-# Architecture Snapshot - {{PROJECT_NAME}}
-
-**Purpose:** High-level system map for rapid orientation
-**Load:** When starting a new session or onboarding
-**Size:** ~10k tokens (5% of 200k budget)
-**Last Updated:** {{DATE}}
-
----
-
-## System Overview
-
-{{SYSTEM_OVERVIEW_DIAGRAM}}
-
----
-
-## Technology Stack
-
-| Layer | Technology | Purpose |
-|-------|------------|---------|
-| **Frontend** | {{FRONTEND_TECH}} | {{FRONTEND_PURPOSE}} |
-| **Backend** | {{BACKEND_TECH}} | {{BACKEND_PURPOSE}} |
-| **Database** | {{DATABASE_TECH}} | {{DATABASE_PURPOSE}} |
-| **Cache** | {{CACHE_TECH}} | {{CACHE_PURPOSE}} |
-| **Queue** | {{QUEUE_TECH}} | {{QUEUE_PURPOSE}} |
-
----
-
-## Core Components
-
-### Component 1: {{COMPONENT_1_NAME}}
-
-**Purpose:** {{COMPONENT_1_PURPOSE}}
-**Key Files:**
-- `{{FILE_1}}` - {{FILE_1_PURPOSE}}
-- `{{FILE_2}}` - {{FILE_2_PURPOSE}}
-
-**Related Workflows:**
-- [workflow_1.md](./workflows/workflow_1.md)
-
----
-
-### Component 2: {{COMPONENT_2_NAME}}
-
-[Same structure...]
-
----
-
-## Data Flow
-
-```
-{{DATA_FLOW_DIAGRAM}}
-```
-
----
-
-## Database Schema Summary
-
-**Total Tables:** {{TABLE_COUNT}}
-
-| Table | Purpose | Key Relationships |
-|-------|---------|-------------------|
-| `{{TABLE_1}}` | {{TABLE_1_PURPOSE}} | FK to {{RELATED_TABLE}} |
-| `{{TABLE_2}}` | {{TABLE_2_PURPOSE}} | FK to {{RELATED_TABLE}} |
-
-**Schema Details:** {{MODELS_FILE}}
-
----
-
-## External Integrations
-
-| Integration | Type | Purpose | Docs |
-|-------------|------|---------|------|
-| {{INTEGRATION_1}} | API | {{PURPOSE_1}} | {{DOCS_LINK}} |
-| {{INTEGRATION_2}} | API | {{PURPOSE_2}} | {{DOCS_LINK}} |
-
----
-
-## Key Architectural Decisions
-
-### Decision 1: {{DECISION_1_TITLE}}
-
-**Choice:** {{WHAT_WAS_CHOSEN}}
-**Why:** {{RATIONALE}}
-**Trade-offs:** {{TRADE_OFFS}}
-
----
-
-### Decision 2: {{DECISION_2_TITLE}}
-
-[Same structure...]
-
----
-
-## Directory Structure
-
-```
-{{PROJECT_ROOT}}/
-├── {{DIR_1}}/              # {{DIR_1_PURPOSE}}
-│   ├── {{SUBDIR_1}}/       # {{SUBDIR_1_PURPOSE}}
-│   └── {{SUBDIR_2}}/       # {{SUBDIR_2_PURPOSE}}
-├── {{DIR_2}}/              # {{DIR_2_PURPOSE}}
-├── {{DIR_3}}/              # {{DIR_3_PURPOSE}}
-└── {{DIR_4}}/              # {{DIR_4_PURPOSE}}
-```
-
----
-
-## Security Model
-
-### Authentication
-{{AUTHENTICATION_DESCRIPTION}}
-
-### Authorization
-{{AUTHORIZATION_DESCRIPTION}}
-
-### Data Protection
-{{DATA_PROTECTION_DESCRIPTION}}
-
----
-
-## Performance Characteristics
-
-| Metric | Target | Current |
-|--------|--------|---------|
-| API Response Time | {{TARGET_1}} | {{CURRENT_1}} |
-| Throughput | {{TARGET_2}} | {{CURRENT_2}} |
-| Availability | {{TARGET_3}} | {{CURRENT_3}} |
-
----
-
-## Deployment Architecture
-
-```
-{{DEPLOYMENT_DIAGRAM}}
-```
-
-**Environments:**
-| Environment | URL | Purpose |
-|-------------|-----|---------|
-| Development | {{DEV_URL}} | Local development |
-| Staging | {{STAGING_URL}} | Pre-production testing |
-| Production | {{PROD_URL}} | Live system |
-
----
-
-## See Also
-
-- **Detailed workflows:** [WORKFLOW_INDEX.md](./WORKFLOW_INDEX.md)
-- **File responsibilities:** [FILE_OWNERSHIP.md](./FILE_OWNERSHIP.md)
-- **External APIs:** [INTEGRATION_POINTS.md](./INTEGRATION_POINTS.md)
-- **Lessons learned:** [KNOWN_GOTCHAS.md](./KNOWN_GOTCHAS.md)
-
----
-
-**Version:** 1.0
-**Verified Against Commit:** {{COMMIT_HASH}}
+# Architecture Snapshot - {{PROJECT_NAME}}
+
+**Purpose:** High-level system map for rapid orientation
+**Load:** When starting a new session or onboarding
+**Size:** ~10k tokens (5% of 200k budget)
+**Last Updated:** {{DATE}}
+
+---
+
+## System Overview
+
+{{SYSTEM_OVERVIEW_DIAGRAM}}
+
+---
+
+## Technology Stack
+
+| Layer | Technology | Purpose |
+|-------|------------|---------|
+| **Frontend** | {{FRONTEND_TECH}} | {{FRONTEND_PURPOSE}} |
+| **Backend** | {{BACKEND_TECH}} | {{BACKEND_PURPOSE}} |
+| **Database** | {{DATABASE_TECH}} | {{DATABASE_PURPOSE}} |
+| **Cache** | {{CACHE_TECH}} | {{CACHE_PURPOSE}} |
+| **Queue** | {{QUEUE_TECH}} | {{QUEUE_PURPOSE}} |
+
+---
+
+## Core Components
+
+### Component 1: {{COMPONENT_1_NAME}}
+
+**Purpose:** {{COMPONENT_1_PURPOSE}}
+**Key Files:**
+- `{{FILE_1}}` - {{FILE_1_PURPOSE}}
+- `{{FILE_2}}` - {{FILE_2_PURPOSE}}
+
+**Related Workflows:**
+- [workflow_1.md](./workflows/workflow_1.md)
+
+---
+
+### Component 2: {{COMPONENT_2_NAME}}
+
+[Same structure...]
+
+---
+
+## Data Flow
+
+```
+{{DATA_FLOW_DIAGRAM}}
+```
+
+---
+
+## Database Schema Summary
+
+**Total Tables:** {{TABLE_COUNT}}
+
+| Table | Purpose | Key Relationships |
+|-------|---------|-------------------|
+| `{{TABLE_1}}` | {{TABLE_1_PURPOSE}} | FK to {{RELATED_TABLE}} |
+| `{{TABLE_2}}` | {{TABLE_2_PURPOSE}} | FK to {{RELATED_TABLE}} |
+
+**Schema Details:** {{MODELS_FILE}}
+
+---
+
+## External Integrations
+
+| Integration | Type | Purpose | Docs |
+|-------------|------|---------|------|
+| {{INTEGRATION_1}} | API | {{PURPOSE_1}} | {{DOCS_LINK}} |
+| {{INTEGRATION_2}} | API | {{PURPOSE_2}} | {{DOCS_LINK}} |
+
+---
+
+## Key Architectural Decisions
+
+### Decision 1: {{DECISION_1_TITLE}}
+
+**Choice:** {{WHAT_WAS_CHOSEN}}
+**Why:** {{RATIONALE}}
+**Trade-offs:** {{TRADE_OFFS}}
+
+---
+
+### Decision 2: {{DECISION_2_TITLE}}
+
+[Same structure...]
+
+---
+
+## Directory Structure
+
+```
+{{PROJECT_ROOT}}/
+├── {{DIR_1}}/              # {{DIR_1_PURPOSE}}
+│   ├── {{SUBDIR_1}}/       # {{SUBDIR_1_PURPOSE}}
+│   └── {{SUBDIR_2}}/       # {{SUBDIR_2_PURPOSE}}
+├── {{DIR_2}}/              # {{DIR_2_PURPOSE}}
+├── {{DIR_3}}/              # {{DIR_3_PURPOSE}}
+└── {{DIR_4}}/              # {{DIR_4_PURPOSE}}
+```
+
+---
+
+## Security Model
+
+### Authentication
+{{AUTHENTICATION_DESCRIPTION}}
+
+### Authorization
+{{AUTHORIZATION_DESCRIPTION}}
+
+### Data Protection
+{{DATA_PROTECTION_DESCRIPTION}}
+
+---
+
+## Performance Characteristics
+
+| Metric | Target | Current |
+|--------|--------|---------|
+| API Response Time | {{TARGET_1}} | {{CURRENT_1}} |
+| Throughput | {{TARGET_2}} | {{CURRENT_2}} |
+| Availability | {{TARGET_3}} | {{CURRENT_3}} |
+
+---
+
+## Deployment Architecture
+
+```
+{{DEPLOYMENT_DIAGRAM}}
+```
+
+**Environments:**
+| Environment | URL | Purpose |
+|-------------|-----|---------|
+| Development | {{DEV_URL}} | Local development |
+| Staging | {{STAGING_URL}} | Pre-production testing |
+| Production | {{PROD_URL}} | Live system |
+
+---
+
+## See Also
+
+- **Detailed workflows:** [WORKFLOW_INDEX.md](./WORKFLOW_INDEX.md)
+- **File responsibilities:** [FILE_OWNERSHIP.md](./FILE_OWNERSHIP.md)
+- **External APIs:** [INTEGRATION_POINTS.md](./INTEGRATION_POINTS.md)
+- **Lessons learned:** [KNOWN_GOTCHAS.md](./KNOWN_GOTCHAS.md)
+
+---
+
+**Version:** 1.0
+**Verified Against Commit:** {{COMMIT_HASH}}

package/templates/base/context/CODE_TO_WORKFLOW_MAP.md

@@ -1,94 +1,94 @@
-# Code to Workflow Map
-
-**Purpose:** Reverse index - Given a code file, find which workflows document it
-**Use:** After modifying any file, look up what documentation needs updating
-**Last Updated:** {{DATE}}
-
----
-
-## How to Use This File
-
-1. **Modified a file?** Search for it below
-2. **Find "Documented In" section** for affected workflows
-3. **Check "Update After Changing" section** for required updates
-4. **Run `/verify-docs-current [file]`** to validate
-
----
-
-## File → Workflow Mapping
-
-### {{DIRECTORY_1}}/
-
-#### `{{FILE_1}}` [XXX lines]
-
-**Documented In:**
-- [workflows/workflow_1.md](./workflows/workflow_1.md) - Section 2
-- [workflows/workflow_2.md](./workflows/workflow_2.md) - Section 4
-
-**Update After Changing:**
-- Workflow: workflow_1.md (if [specific thing] changes)
-- Agent: agent_name.md (if [capability] changes)
-- CLAUDE.md (if [architecture] changes)
-
----
-
-#### `{{FILE_2}}` [XXX lines]
-
-**Documented In:**
-- [workflows/workflow_3.md](./workflows/workflow_3.md) - Complete file
-
-**Update After Changing:**
-- Workflow: workflow_3.md (always)
-
----
-
-### {{DIRECTORY_2}}/
-
-[Same structure for each directory...]
-
----
-
-## Files NOT Currently Documented
-
-These files exist but are not yet in any workflow:
-
-| File | Reason | Priority |
-|------|--------|----------|
-| `path/file.ext` | [Why not documented] | LOW/MED/HIGH |
-
----
-
-## Documentation Update Checklist
-
-After ANY code change:
-
-1. [ ] Find modified file in this map
-2. [ ] Check all "Documented In" workflows
-3. [ ] Update line numbers if code moved
-4. [ ] Update function signatures if changed
-5. [ ] Update business logic descriptions if changed
-6. [ ] Run `/verify-docs-current [file]`
-7. [ ] Commit documentation updates with code
-
----
-
-## Automation
-
-### Quick Lookup Command
-
-```bash
-# Find what documents a specific file
-grep -l "path/to/file" .claude/context/workflows/*.md
-```
-
-### Validation Command
-
-```bash
-/verify-docs-current path/to/modified/file.ext
-```
-
----
-
-**Version:** 1.0
-**Files Tracked:** {{FILES_COUNT}}
-**Workflows Linked:** {{WORKFLOWS_COUNT}}
+# Code to Workflow Map
+
+**Purpose:** Reverse index - Given a code file, find which workflows document it
+**Use:** After modifying any file, look up what documentation needs updating
+**Last Updated:** {{DATE}}
+
+---
+
+## How to Use This File
+
+1. **Modified a file?** Search for it below
+2. **Find "Documented In" section** for affected workflows
+3. **Check "Update After Changing" section** for required updates
+4. **Run `/verify-docs-current [file]`** to validate
+
+---
+
+## File → Workflow Mapping
+
+### {{DIRECTORY_1}}/
+
+#### `{{FILE_1}}` [XXX lines]
+
+**Documented In:**
+- [workflows/workflow_1.md](./workflows/workflow_1.md) - Section 2
+- [workflows/workflow_2.md](./workflows/workflow_2.md) - Section 4
+
+**Update After Changing:**
+- Workflow: workflow_1.md (if [specific thing] changes)
+- Agent: agent_name.md (if [capability] changes)
+- CLAUDE.md (if [architecture] changes)
+
+---
+
+#### `{{FILE_2}}` [XXX lines]
+
+**Documented In:**
+- [workflows/workflow_3.md](./workflows/workflow_3.md) - Complete file
+
+**Update After Changing:**
+- Workflow: workflow_3.md (always)
+
+---
+
+### {{DIRECTORY_2}}/
+
+[Same structure for each directory...]
+
+---
+
+## Files NOT Currently Documented
+
+These files exist but are not yet in any workflow:
+
+| File | Reason | Priority |
+|------|--------|----------|
+| `path/file.ext` | [Why not documented] | LOW/MED/HIGH |
+
+---
+
+## Documentation Update Checklist
+
+After ANY code change:
+
+1. [ ] Find modified file in this map
+2. [ ] Check all "Documented In" workflows
+3. [ ] Update line numbers if code moved
+4. [ ] Update function signatures if changed
+5. [ ] Update business logic descriptions if changed
+6. [ ] Run `/verify-docs-current [file]`
+7. [ ] Commit documentation updates with code
+
+---
+
+## Automation
+
+### Quick Lookup Command
+
+```bash
+# Find what documents a specific file
+grep -l "path/to/file" .claude/context/workflows/*.md
+```
+
+### Validation Command
+
+```bash
+/verify-docs-current path/to/modified/file.ext
+```
+
+---
+
+**Version:** 1.0
+**Files Tracked:** {{FILES_COUNT}}
+**Workflows Linked:** {{WORKFLOWS_COUNT}}