create-universal-ai-context 2.5.0 → 2.6.0-final

package/templates/base/context/FILE_OWNERSHIP.md

@@ -1,57 +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*
+# 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

@@ -1,92 +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*
+# 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*

package/templates/base/context/KNOWN_GOTCHAS.md

@@ -1,195 +1,195 @@
-# Known Gotchas - {{PROJECT_NAME}}
-
-**Purpose:** Document lessons learned, common pitfalls, and their solutions
-**Use:** Before implementing features or debugging issues
-**Size:** ~15k tokens (grows over time)
-**Last Updated:** {{DATE}}
-
----
-
-## How to Use This File
-
-1. **Before implementing:** Search for related gotchas
-2. **After fixing bugs:** Add new gotchas
-3. **During code review:** Reference relevant gotchas
-4. **Quarterly:** Review and archive resolved gotchas
-
----
-
-## Gotcha Categories
-
-1. [Database](#database-gotchas)
-2. [API](#api-gotchas)
-3. [Authentication](#authentication-gotchas)
-4. [External Services](#external-services-gotchas)
-5. [Testing](#testing-gotchas)
-6. [Deployment](#deployment-gotchas)
-
----
-
-## Database Gotchas
-
-### GOTCHA-DB-001: {{GOTCHA_TITLE}}
-
-**Severity:** CRITICAL / HIGH / MEDIUM / LOW
-**Discovered:** {{DATE}}
-**Workflow Impact:** [workflow_1.md](./workflows/workflow_1.md)
-
-**Symptom:**
-{{WHAT_GOES_WRONG}}
-
-**Root Cause:**
-{{WHY_IT_HAPPENS}}
-
-**Fix:**
-```
-{{CODE_OR_STEPS_TO_FIX}}
-```
-
-**Prevention:**
-- {{HOW_TO_AVOID_IN_FUTURE}}
-
----
-
-### GOTCHA-DB-002: {{GOTCHA_TITLE}}
-
-[Same structure...]
-
----
-
-## API Gotchas
-
-### GOTCHA-API-001: {{GOTCHA_TITLE}}
-
-**Severity:** CRITICAL / HIGH / MEDIUM / LOW
-**Discovered:** {{DATE}}
-**Workflow Impact:** [workflow_2.md](./workflows/workflow_2.md)
-
-**Symptom:**
-{{WHAT_GOES_WRONG}}
-
-**Root Cause:**
-{{WHY_IT_HAPPENS}}
-
-**Fix:**
-```
-{{CODE_OR_STEPS_TO_FIX}}
-```
-
-**Prevention:**
-- {{HOW_TO_AVOID_IN_FUTURE}}
-
----
-
-## Authentication Gotchas
-
-### GOTCHA-AUTH-001: {{GOTCHA_TITLE}}
-
-[Same structure...]
-
----
-
-## External Services Gotchas
-
-### GOTCHA-EXT-001: {{GOTCHA_TITLE}}
-
-[Same structure...]
-
----
-
-## Testing Gotchas
-
-### GOTCHA-TEST-001: {{GOTCHA_TITLE}}
-
-[Same structure...]
-
----
-
-## Deployment Gotchas
-
-### GOTCHA-DEPLOY-001: {{GOTCHA_TITLE}}
-
-[Same structure...]
-
----
-
-## Quick Reference Table
-
-| ID | Title | Severity | Workflow |
-|----|-------|----------|----------|
-| DB-001 | {{TITLE}} | {{SEVERITY}} | workflow_1 |
-| API-001 | {{TITLE}} | {{SEVERITY}} | workflow_2 |
-| AUTH-001 | {{TITLE}} | {{SEVERITY}} | workflow_3 |
-
----
-
-## Adding New Gotchas
-
-### Template
-
-```markdown
-### GOTCHA-[CATEGORY]-[NUMBER]: [Title]
-
-**Severity:** CRITICAL / HIGH / MEDIUM / LOW
-**Discovered:** YYYY-MM-DD
-**Workflow Impact:** [workflow_name.md](./workflows/workflow_name.md)
-
-**Symptom:**
-[What the user/developer observes going wrong]
-
-**Root Cause:**
-[Technical explanation of why it happens]
-
-**Fix:**
-```
-[Code or steps to fix]
-```
-
-**Prevention:**
-- [How to avoid this in future code]
-- [What patterns to use instead]
-```
-
-### Categories
-
-- **DB**: Database, migrations, queries
-- **API**: REST endpoints, request/response
-- **AUTH**: Authentication, authorization, sessions
-- **EXT**: External services, APIs, integrations
-- **TEST**: Testing, mocking, fixtures
-- **DEPLOY**: Deployment, CI/CD, infrastructure
-
-### Severity Levels
-
-| Level | Definition |
-|-------|------------|
-| CRITICAL | Production down, data loss possible |
-| HIGH | Feature broken, workaround difficult |
-| MEDIUM | Feature degraded, workaround exists |
-| LOW | Minor inconvenience, edge case |
-
----
-
-## Archived Gotchas
-
-Gotchas that are fully resolved and no longer relevant:
-
-| ID | Title | Resolved Date | Resolution |
-|----|-------|---------------|------------|
-| - | - | - | - |
-
----
-
-## Statistics
-
-- **Total Active Gotchas:** {{TOTAL_COUNT}}
-- **Critical:** {{CRITICAL_COUNT}}
-- **High:** {{HIGH_COUNT}}
-- **Medium:** {{MEDIUM_COUNT}}
-- **Low:** {{LOW_COUNT}}
-- **Last Added:** {{LAST_ADDED_DATE}}
-
----
-
-**Version:** 1.0
-**Maintainer:** {{MAINTAINER}}
+# Known Gotchas - {{PROJECT_NAME}}
+
+**Purpose:** Document lessons learned, common pitfalls, and their solutions
+**Use:** Before implementing features or debugging issues
+**Size:** ~15k tokens (grows over time)
+**Last Updated:** {{DATE}}
+
+---
+
+## How to Use This File
+
+1. **Before implementing:** Search for related gotchas
+2. **After fixing bugs:** Add new gotchas
+3. **During code review:** Reference relevant gotchas
+4. **Quarterly:** Review and archive resolved gotchas
+
+---
+
+## Gotcha Categories
+
+1. [Database](#database-gotchas)
+2. [API](#api-gotchas)
+3. [Authentication](#authentication-gotchas)
+4. [External Services](#external-services-gotchas)
+5. [Testing](#testing-gotchas)
+6. [Deployment](#deployment-gotchas)
+
+---
+
+## Database Gotchas
+
+### GOTCHA-DB-001: {{GOTCHA_TITLE}}
+
+**Severity:** CRITICAL / HIGH / MEDIUM / LOW
+**Discovered:** {{DATE}}
+**Workflow Impact:** [workflow_1.md](./workflows/workflow_1.md)
+
+**Symptom:**
+{{WHAT_GOES_WRONG}}
+
+**Root Cause:**
+{{WHY_IT_HAPPENS}}
+
+**Fix:**
+```
+{{CODE_OR_STEPS_TO_FIX}}
+```
+
+**Prevention:**
+- {{HOW_TO_AVOID_IN_FUTURE}}
+
+---
+
+### GOTCHA-DB-002: {{GOTCHA_TITLE}}
+
+[Same structure...]
+
+---
+
+## API Gotchas
+
+### GOTCHA-API-001: {{GOTCHA_TITLE}}
+
+**Severity:** CRITICAL / HIGH / MEDIUM / LOW
+**Discovered:** {{DATE}}
+**Workflow Impact:** [workflow_2.md](./workflows/workflow_2.md)
+
+**Symptom:**
+{{WHAT_GOES_WRONG}}
+
+**Root Cause:**
+{{WHY_IT_HAPPENS}}
+
+**Fix:**
+```
+{{CODE_OR_STEPS_TO_FIX}}
+```
+
+**Prevention:**
+- {{HOW_TO_AVOID_IN_FUTURE}}
+
+---
+
+## Authentication Gotchas
+
+### GOTCHA-AUTH-001: {{GOTCHA_TITLE}}
+
+[Same structure...]
+
+---
+
+## External Services Gotchas
+
+### GOTCHA-EXT-001: {{GOTCHA_TITLE}}
+
+[Same structure...]
+
+---
+
+## Testing Gotchas
+
+### GOTCHA-TEST-001: {{GOTCHA_TITLE}}
+
+[Same structure...]
+
+---
+
+## Deployment Gotchas
+
+### GOTCHA-DEPLOY-001: {{GOTCHA_TITLE}}
+
+[Same structure...]
+
+---
+
+## Quick Reference Table
+
+| ID | Title | Severity | Workflow |
+|----|-------|----------|----------|
+| DB-001 | {{TITLE}} | {{SEVERITY}} | workflow_1 |
+| API-001 | {{TITLE}} | {{SEVERITY}} | workflow_2 |
+| AUTH-001 | {{TITLE}} | {{SEVERITY}} | workflow_3 |
+
+---
+
+## Adding New Gotchas
+
+### Template
+
+```markdown
+### GOTCHA-[CATEGORY]-[NUMBER]: [Title]
+
+**Severity:** CRITICAL / HIGH / MEDIUM / LOW
+**Discovered:** YYYY-MM-DD
+**Workflow Impact:** [workflow_name.md](./workflows/workflow_name.md)
+
+**Symptom:**
+[What the user/developer observes going wrong]
+
+**Root Cause:**
+[Technical explanation of why it happens]
+
+**Fix:**
+```
+[Code or steps to fix]
+```
+
+**Prevention:**
+- [How to avoid this in future code]
+- [What patterns to use instead]
+```
+
+### Categories
+
+- **DB**: Database, migrations, queries
+- **API**: REST endpoints, request/response
+- **AUTH**: Authentication, authorization, sessions
+- **EXT**: External services, APIs, integrations
+- **TEST**: Testing, mocking, fixtures
+- **DEPLOY**: Deployment, CI/CD, infrastructure
+
+### Severity Levels
+
+| Level | Definition |
+|-------|------------|
+| CRITICAL | Production down, data loss possible |
+| HIGH | Feature broken, workaround difficult |
+| MEDIUM | Feature degraded, workaround exists |
+| LOW | Minor inconvenience, edge case |
+
+---
+
+## Archived Gotchas
+
+Gotchas that are fully resolved and no longer relevant:
+
+| ID | Title | Resolved Date | Resolution |
+|----|-------|---------------|------------|
+| - | - | - | - |
+
+---
+
+## Statistics
+
+- **Total Active Gotchas:** {{TOTAL_COUNT}}
+- **Critical:** {{CRITICAL_COUNT}}
+- **High:** {{HIGH_COUNT}}
+- **Medium:** {{MEDIUM_COUNT}}
+- **Low:** {{LOW_COUNT}}
+- **Last Added:** {{LAST_ADDED_DATE}}
+
+---
+
+**Version:** 1.0
+**Maintainer:** {{MAINTAINER}}