create-universal-ai-context 2.0.0

package/templates/base/config/base.json

@@ -0,0 +1,57 @@
+{
+  "$schema": "../schemas/settings.schema.json",
+  "version": "1.1.0",
+  "context_engineering": {
+    "enabled": true,
+    "max_context_tokens": 200000,
+    "max_output_tokens": 30000,
+    "target_utilization": 0.40,
+    "compact_trigger": 0.35
+  },
+  "rpi_workflow": {
+    "enabled": true,
+    "phases": ["research", "plan", "implement"],
+    "require_human_approval": true,
+    "auto_doc_update": true,
+    "research_timeout_minutes": 30,
+    "plan_timeout_minutes": 20
+  },
+  "documentation": {
+    "self_maintaining": true,
+    "verify_after_changes": true,
+    "line_number_tolerance": 10,
+    "auto_commit_docs": false
+  },
+  "agents": {
+    "default": "context-engineer",
+    "auto_select": true,
+    "fallback": "core-architect"
+  },
+  "commands": {
+    "rpi_commands": ["/rpi-research", "/rpi-plan", "/rpi-implement"],
+    "validation_commands": ["/verify-docs-current", "/validate-all"]
+  },
+  "validation": {
+    "on_commit": true,
+    "line_accuracy_threshold": 60,
+    "link_check_external": false
+  },
+  "logging": {
+    "level": "info",
+    "file": ".ai-context/logs/claude.log",
+    "max_size_mb": 10
+  },
+  "telemetry": {
+    "enabled": false,
+    "events": {
+      "command_usage": true,
+      "agent_usage": true,
+      "context_metrics": true,
+      "error_reports": true
+    },
+    "privacy": {
+      "anonymize_paths": true,
+      "exclude_content": true
+    }
+  }
+}

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

@@ -0,0 +1,13 @@
+{
+  "$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

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

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

@@ -0,0 +1,13 @@
+{
+  "$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

@@ -0,0 +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": ".ai-context/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

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

package/templates/base/context/CODE_TO_WORKFLOW_MAP.md

@@ -0,0 +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)
+- AI_CONTEXT.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" .ai-context/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}}

package/templates/base/context/FILE_OWNERSHIP.md

@@ -0,0 +1,57 @@
+# File Ownership Map
+
+> Maps source files to their primary owners/maintainers.
+> **Last Updated:** {{LAST_UPDATED}}
+
+---
+
+## Overview
+
+This document tracks file ownership for the codebase. When modifying files, check with the owner for context on design decisions and constraints.
+
+---
+
+## Ownership Categories
+
+### Core Files
+
+| File/Directory | Owner | Notes |
+|----------------|-------|-------|
+| `src/` | {{OWNER}} | Main application code |
+| `tests/` | {{OWNER}} | Test suites |
+| `docs/` | {{OWNER}} | Documentation |
+
+### Configuration
+
+| File | Owner | Notes |
+|------|-------|-------|
+| `package.json` | {{OWNER}} | Dependencies and scripts |
+| `.ai-context/` | {{OWNER}} | Claude Code configuration |
+
+### Infrastructure
+
+| File/Directory | Owner | Notes |
+|----------------|-------|-------|
+| `.github/` | {{OWNER}} | CI/CD workflows |
+| `Dockerfile` | {{OWNER}} | Container configuration |
+
+---
+
+## How to Use
+
+1. **Before major changes**: Contact the file owner
+2. **Adding new files**: Update this map
+3. **Transferring ownership**: Document the handoff
+
+---
+
+## Maintenance
+
+Update this file when:
+- New files/directories are added
+- Ownership changes
+- Team members join/leave
+
+---
+
+*Template file - populate with actual ownership data*

package/templates/base/context/INTEGRATION_POINTS.md

@@ -0,0 +1,92 @@
+# Integration Points
+
+> Documents external systems, APIs, and integration boundaries.
+> **Last Updated:** {{LAST_UPDATED}}
+
+---
+
+## Overview
+
+This document maps all integration points where our system connects with external services, APIs, or systems.
+
+---
+
+## External APIs
+
+### {{API_NAME}}
+
+| Property | Value |
+|----------|-------|
+| **Base URL** | `{{API_URL}}` |
+| **Authentication** | {{AUTH_METHOD}} |
+| **Rate Limits** | {{RATE_LIMITS}} |
+| **Documentation** | {{DOCS_URL}} |
+
+**Used By:**
+- `src/services/{{service}}.{{ext}}`
+
+**Gotchas:**
+- {{GOTCHA_1}}
+
+---
+
+## Databases
+
+### {{DATABASE_NAME}}
+
+| Property | Value |
+|----------|-------|
+| **Type** | {{DB_TYPE}} |
+| **Connection** | {{CONNECTION_STRING}} |
+| **Migrations** | `{{MIGRATIONS_PATH}}` |
+
+---
+
+## Message Queues
+
+### {{QUEUE_NAME}}
+
+| Property | Value |
+|----------|-------|
+| **Type** | {{QUEUE_TYPE}} |
+| **Topics** | {{TOPICS}} |
+
+---
+
+## Third-Party Services
+
+| Service | Purpose | Config Location |
+|---------|---------|-----------------|
+| {{SERVICE}} | {{PURPOSE}} | `{{CONFIG_PATH}}` |
+
+---
+
+## Internal Boundaries
+
+### Microservice Communication
+
+| Service A | Service B | Protocol | Notes |
+|-----------|-----------|----------|-------|
+| {{SVC_A}} | {{SVC_B}} | {{PROTOCOL}} | {{NOTES}} |
+
+---
+
+## Authentication Flows
+
+```
+{{AUTH_FLOW_DIAGRAM}}
+```
+
+---
+
+## Maintenance
+
+Update this file when:
+- New integrations are added
+- API endpoints change
+- Authentication methods update
+- New services are introduced
+
+---
+
+*Template file - populate with actual integration data*