create-claude-context 1.0.0 → 1.2.1

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 |
+| `.claude/` | {{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*

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}}

package/templates/base/context/TESTING_MAP.md

@@ -0,0 +1,95 @@
+# Testing Map
+
+> Maps source files to their corresponding tests.
+> **Last Updated:** {{LAST_UPDATED}}
+
+---
+
+## Overview
+
+This document provides a mapping between source files and their test coverage, helping developers find and update tests when modifying code.
+
+---
+
+## Test Structure
+
+```
+tests/
+├── unit/           # Unit tests
+├── integration/    # Integration tests
+├── e2e/            # End-to-end tests
+└── fixtures/       # Test data and mocks
+```
+
+---
+
+## Coverage Summary
+
+| Category | Files | Covered | Coverage |
+|----------|-------|---------|----------|
+| Unit | {{UNIT_COUNT}} | {{UNIT_COVERED}} | {{UNIT_PCT}}% |
+| Integration | {{INT_COUNT}} | {{INT_COVERED}} | {{INT_PCT}}% |
+| E2E | {{E2E_COUNT}} | {{E2E_COVERED}} | {{E2E_PCT}}% |
+
+---
+
+## File-to-Test Mapping
+
+### Core Application
+
+| Source File | Test File | Coverage |
+|-------------|-----------|----------|
+| `src/{{file}}.{{ext}}` | `tests/unit/{{file}}.test.{{ext}}` | {{PCT}}% |
+
+### Services
+
+| Source File | Test File | Coverage |
+|-------------|-----------|----------|
+| `src/services/{{service}}.{{ext}}` | `tests/unit/services/{{service}}.test.{{ext}}` | {{PCT}}% |
+
+### Utilities
+
+| Source File | Test File | Coverage |
+|-------------|-----------|----------|
+| `src/utils/{{util}}.{{ext}}` | `tests/unit/utils/{{util}}.test.{{ext}}` | {{PCT}}% |
+
+---
+
+## Critical Paths
+
+These files require comprehensive test coverage:
+
+| Path | Reason | Minimum Coverage |
+|------|--------|------------------|
+| `src/auth/` | Security-critical | 90% |
+| `src/payment/` | Financial transactions | 95% |
+| `src/api/` | Public interface | 85% |
+
+---
+
+## Test Commands
+
+```bash
+# Run all tests
+{{TEST_COMMAND}}
+
+# Run with coverage
+{{COVERAGE_COMMAND}}
+
+# Run specific test
+{{SPECIFIC_TEST_COMMAND}}
+```
+
+---
+
+## Maintenance
+
+Update this file when:
+- New source files are added
+- New test files are created
+- Coverage thresholds change
+- Test structure changes
+
+---
+
+*Template file - populate with actual test coverage data*