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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (153) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +331 -294
  3. package/bin/create-ai-context.js +1507 -775
  4. package/lib/adapters/aider.js +131 -131
  5. package/lib/adapters/antigravity.js +205 -205
  6. package/lib/adapters/claude.js +397 -397
  7. package/lib/adapters/cline.js +125 -125
  8. package/lib/adapters/continue.js +138 -138
  9. package/lib/adapters/copilot.js +131 -131
  10. package/lib/adapters/index.js +78 -78
  11. package/lib/adapters/windsurf.js +138 -138
  12. package/lib/ai-context-generator.js +234 -234
  13. package/lib/ai-orchestrator.js +432 -432
  14. package/lib/call-tracer.js +444 -444
  15. package/lib/content-preservation.js +243 -243
  16. package/lib/cross-tool-sync/file-watcher.js +274 -274
  17. package/lib/cross-tool-sync/index.js +41 -40
  18. package/lib/cross-tool-sync/sync-manager.js +540 -512
  19. package/lib/cross-tool-sync/sync-service.js +297 -297
  20. package/lib/detector.js +726 -726
  21. package/lib/doc-discovery.js +741 -741
  22. package/lib/drift-checker.js +920 -920
  23. package/lib/environment-detector.js +239 -239
  24. package/lib/index.js +399 -399
  25. package/lib/install-hooks.js +82 -82
  26. package/lib/installer.js +419 -419
  27. package/lib/migrate.js +328 -328
  28. package/lib/placeholder.js +632 -632
  29. package/lib/prompts.js +341 -341
  30. package/lib/smart-merge.js +540 -540
  31. package/lib/spinner.js +60 -60
  32. package/lib/static-analyzer.js +729 -729
  33. package/lib/template-coordination.js +148 -148
  34. package/lib/template-populator.js +843 -843
  35. package/lib/template-renderer.js +392 -392
  36. package/lib/utils/fs-wrapper.js +79 -79
  37. package/lib/utils/path-utils.js +60 -60
  38. package/lib/validate.js +155 -155
  39. package/package.json +1 -1
  40. package/templates/AI_CONTEXT.md.template +245 -245
  41. package/templates/base/README.md +260 -257
  42. package/templates/base/RPI_WORKFLOW_PLAN.md +325 -320
  43. package/templates/base/agents/api-developer.md +76 -76
  44. package/templates/base/agents/context-engineer.md +525 -525
  45. package/templates/base/agents/core-architect.md +76 -76
  46. package/templates/base/agents/database-ops.md +76 -76
  47. package/templates/base/agents/deployment-ops.md +76 -76
  48. package/templates/base/agents/integration-hub.md +76 -76
  49. package/templates/base/analytics/README.md +114 -114
  50. package/templates/base/automation/config.json +58 -58
  51. package/templates/base/automation/generators/code-mapper.js +308 -308
  52. package/templates/base/automation/generators/index-builder.js +321 -321
  53. package/templates/base/automation/hooks/post-commit.sh +83 -83
  54. package/templates/base/automation/hooks/pre-commit.sh +103 -103
  55. package/templates/base/ci-templates/README.md +108 -108
  56. package/templates/base/ci-templates/github-actions/context-check.yml +144 -144
  57. package/templates/base/ci-templates/github-actions/validate-docs.yml +105 -105
  58. package/templates/base/commands/analytics.md +238 -238
  59. package/templates/base/commands/auto-sync.md +172 -172
  60. package/templates/base/commands/collab.md +194 -194
  61. package/templates/base/commands/context-optimize.md +226 -0
  62. package/templates/base/commands/help.md +485 -450
  63. package/templates/base/commands/rpi-implement.md +164 -115
  64. package/templates/base/commands/rpi-plan.md +147 -93
  65. package/templates/base/commands/rpi-research.md +145 -88
  66. package/templates/base/commands/session-resume.md +144 -144
  67. package/templates/base/commands/session-save.md +112 -112
  68. package/templates/base/commands/validate-all.md +77 -77
  69. package/templates/base/commands/verify-docs-current.md +86 -86
  70. package/templates/base/config/base.json +57 -57
  71. package/templates/base/config/environments/development.json +13 -13
  72. package/templates/base/config/environments/production.json +17 -17
  73. package/templates/base/config/environments/staging.json +13 -13
  74. package/templates/base/config/local.json.example +21 -21
  75. package/templates/base/context/.meta/generated-at.json +18 -18
  76. package/templates/base/context/ARCHITECTURE_SNAPSHOT.md +156 -156
  77. package/templates/base/context/CODE_TO_WORKFLOW_MAP.md +94 -94
  78. package/templates/base/context/FILE_OWNERSHIP.md +57 -57
  79. package/templates/base/context/INTEGRATION_POINTS.md +92 -92
  80. package/templates/base/context/KNOWN_GOTCHAS.md +195 -195
  81. package/templates/base/context/TESTING_MAP.md +95 -95
  82. package/templates/base/context/WORKFLOW_INDEX.md +129 -129
  83. package/templates/base/context/workflows/WORKFLOW_TEMPLATE.md +294 -294
  84. package/templates/base/indexes/agents/CAPABILITY_MATRIX.md +255 -255
  85. package/templates/base/indexes/agents/CATEGORY_INDEX.md +44 -44
  86. package/templates/base/indexes/code/CATEGORY_INDEX.md +38 -38
  87. package/templates/base/indexes/routing/CATEGORY_INDEX.md +39 -39
  88. package/templates/base/indexes/search/CATEGORY_INDEX.md +39 -39
  89. package/templates/base/indexes/workflows/CATEGORY_INDEX.md +38 -38
  90. package/templates/base/knowledge/README.md +98 -98
  91. package/templates/base/knowledge/sessions/README.md +88 -88
  92. package/templates/base/knowledge/sessions/TEMPLATE.md +150 -150
  93. package/templates/base/knowledge/shared/decisions/0001-adopt-context-engineering.md +144 -144
  94. package/templates/base/knowledge/shared/decisions/README.md +49 -49
  95. package/templates/base/knowledge/shared/decisions/TEMPLATE.md +123 -123
  96. package/templates/base/knowledge/shared/patterns/README.md +62 -62
  97. package/templates/base/knowledge/shared/patterns/TEMPLATE.md +120 -120
  98. package/templates/base/plans/PLAN_TEMPLATE.md +316 -250
  99. package/templates/base/research/RESEARCH_TEMPLATE.md +245 -153
  100. package/templates/base/schemas/agent.schema.json +141 -141
  101. package/templates/base/schemas/anchors.schema.json +54 -54
  102. package/templates/base/schemas/automation.schema.json +93 -93
  103. package/templates/base/schemas/command.schema.json +134 -134
  104. package/templates/base/schemas/hashes.schema.json +40 -40
  105. package/templates/base/schemas/manifest.schema.json +117 -117
  106. package/templates/base/schemas/plan.schema.json +136 -136
  107. package/templates/base/schemas/research.schema.json +115 -115
  108. package/templates/base/schemas/roles.schema.json +34 -34
  109. package/templates/base/schemas/session.schema.json +77 -77
  110. package/templates/base/schemas/settings.schema.json +244 -244
  111. package/templates/base/schemas/staleness.schema.json +53 -53
  112. package/templates/base/schemas/team-config.schema.json +42 -42
  113. package/templates/base/schemas/workflow.schema.json +126 -126
  114. package/templates/base/session/checkpoints/.gitkeep +2 -2
  115. package/templates/base/session/current/state.json +20 -20
  116. package/templates/base/session/history/.gitkeep +2 -2
  117. package/templates/base/settings.json +3 -3
  118. package/templates/base/standards/COMPATIBILITY.md +219 -219
  119. package/templates/base/standards/EXTENSION_GUIDELINES.md +280 -280
  120. package/templates/base/standards/QUALITY_CHECKLIST.md +211 -211
  121. package/templates/base/standards/README.md +66 -66
  122. package/templates/base/sync/anchors.json +6 -6
  123. package/templates/base/sync/hashes.json +6 -6
  124. package/templates/base/sync/staleness.json +10 -10
  125. package/templates/base/team/README.md +168 -168
  126. package/templates/base/team/config.json +79 -79
  127. package/templates/base/team/roles.json +145 -145
  128. package/templates/base/tools/bin/claude-context.js +151 -151
  129. package/templates/base/tools/lib/anchor-resolver.js +276 -276
  130. package/templates/base/tools/lib/config-loader.js +363 -363
  131. package/templates/base/tools/lib/detector.js +350 -350
  132. package/templates/base/tools/lib/diagnose.js +206 -206
  133. package/templates/base/tools/lib/drift-detector.js +373 -373
  134. package/templates/base/tools/lib/errors.js +199 -199
  135. package/templates/base/tools/lib/index.js +36 -36
  136. package/templates/base/tools/lib/init.js +192 -192
  137. package/templates/base/tools/lib/logger.js +230 -230
  138. package/templates/base/tools/lib/placeholder.js +201 -201
  139. package/templates/base/tools/lib/session-manager.js +354 -354
  140. package/templates/base/tools/lib/validate.js +521 -521
  141. package/templates/base/tools/package.json +49 -49
  142. package/templates/handlebars/aider-config.hbs +146 -80
  143. package/templates/handlebars/antigravity.hbs +377 -377
  144. package/templates/handlebars/claude.hbs +183 -183
  145. package/templates/handlebars/cline.hbs +62 -62
  146. package/templates/handlebars/continue-config.hbs +116 -116
  147. package/templates/handlebars/copilot.hbs +130 -130
  148. package/templates/handlebars/partials/gotcha-list.hbs +11 -11
  149. package/templates/handlebars/partials/header.hbs +3 -3
  150. package/templates/handlebars/partials/workflow-summary.hbs +16 -16
  151. package/templates/handlebars/windsurf-rules.hbs +69 -69
  152. package/templates/hooks/post-commit.hbs +28 -29
  153. package/templates/hooks/pre-commit.hbs +46 -46
@@ -1,168 +1,168 @@
1
- # Team Collaboration
2
-
3
- Configuration and setup for team-based Claude Code collaboration.
4
-
5
- ## Overview
6
-
7
- This directory contains team configuration that enables:
8
- - Multi-user collaboration on Claude Code sessions
9
- - Role-based access control
10
- - Session handoffs between team members
11
- - Shared knowledge synchronization
12
- - Team notifications and integrations
13
-
14
- ## Quick Setup
15
-
16
- ### 1. Configure Team
17
-
18
- Edit `config.json` and replace placeholders:
19
-
20
- ```json
21
- {
22
- "team": {
23
- "name": "Your Team Name",
24
- "organization": "Your Organization"
25
- }
26
- }
27
- ```
28
-
29
- ### 2. Add Team Members
30
-
31
- Add members to the `members` array in `config.json`:
32
-
33
- ```json
34
- {
35
- "members": [
36
- {
37
- "id": "unique-id",
38
- "name": "Developer Name",
39
- "role": "developer",
40
- "email": "dev@example.com",
41
- "permissions": ["read", "write", "execute"],
42
- "active": true
43
- }
44
- ]
45
- }
46
- ```
47
-
48
- ### 3. Assign Roles
49
-
50
- Available roles (defined in `roles.json`):
51
-
52
- | Role | Description | Key Permissions |
53
- |------|-------------|-----------------|
54
- | `team-lead` | Full access, manages team | All permissions |
55
- | `senior-developer` | Development + approvals | read, write, execute, approve |
56
- | `developer` | Standard development | read, write, execute |
57
- | `reviewer` | Code review focus | read, approve |
58
- | `observer` | Read-only access | read |
59
-
60
- ### 4. Configure Integrations (Optional)
61
-
62
- #### Slack Notifications
63
-
64
- ```json
65
- {
66
- "notifications": {
67
- "enabled": true,
68
- "channels": {
69
- "slack": {
70
- "webhook_url": "https://hooks.slack.com/...",
71
- "channel": "#claude-notifications"
72
- }
73
- }
74
- }
75
- }
76
- ```
77
-
78
- #### Jira Integration
79
-
80
- ```json
81
- {
82
- "integrations": {
83
- "jira": {
84
- "enabled": true,
85
- "project_key": "PROJ",
86
- "api_url": "https://your-domain.atlassian.net"
87
- }
88
- }
89
- }
90
- ```
91
-
92
- ## Files
93
-
94
- | File | Purpose |
95
- |------|---------|
96
- | `config.json` | Team settings, members, integrations |
97
- | `roles.json` | Role definitions and permissions |
98
-
99
- ## Usage
100
-
101
- ### Session Handoffs
102
-
103
- When ending a session, create a handoff document:
104
-
105
- ```
106
- /collab handoff
107
- ```
108
-
109
- This generates a session summary in `.ai-context/knowledge/sessions/` for the next team member.
110
-
111
- ### Sync Shared Knowledge
112
-
113
- Synchronize team knowledge base:
114
-
115
- ```
116
- /collab sync
117
- ```
118
-
119
- ### Check Team Status
120
-
121
- View team configuration and active sessions:
122
-
123
- ```
124
- /collab status
125
- ```
126
-
127
- ## Policies
128
-
129
- Configure team policies in `config.json`:
130
-
131
- ```json
132
- {
133
- "policies": {
134
- "code_review_required": true,
135
- "documentation_update_required": true,
136
- "test_coverage_minimum": 80,
137
- "max_file_changes_per_session": 50
138
- }
139
- }
140
- ```
141
-
142
- ## Security Notes
143
-
144
- - `config.json` may contain sensitive webhooks - consider gitignoring
145
- - Use environment variables for API tokens
146
- - Review member permissions regularly
147
- - Session handoffs may contain context - handle appropriately
148
-
149
- ## Troubleshooting
150
-
151
- ### Member not recognized
152
-
153
- Ensure the member entry in `config.json` has:
154
- - Unique `id`
155
- - Valid `role` matching `roles.json`
156
- - `active: true`
157
-
158
- ### Notifications not sending
159
-
160
- 1. Verify webhook URL is correct
161
- 2. Check `notifications.enabled` is `true`
162
- 3. Ensure event type is enabled in `notifications.events`
163
-
164
- ### Permission denied
165
-
166
- 1. Check member's role in `config.json`
167
- 2. Verify role has required permission in `roles.json`
168
- 3. Ensure member is `active: true`
1
+ # Team Collaboration
2
+
3
+ Configuration and setup for team-based Claude Code collaboration.
4
+
5
+ ## Overview
6
+
7
+ This directory contains team configuration that enables:
8
+ - Multi-user collaboration on Claude Code sessions
9
+ - Role-based access control
10
+ - Session handoffs between team members
11
+ - Shared knowledge synchronization
12
+ - Team notifications and integrations
13
+
14
+ ## Quick Setup
15
+
16
+ ### 1. Configure Team
17
+
18
+ Edit `config.json` and replace placeholders:
19
+
20
+ ```json
21
+ {
22
+ "team": {
23
+ "name": "Your Team Name",
24
+ "organization": "Your Organization"
25
+ }
26
+ }
27
+ ```
28
+
29
+ ### 2. Add Team Members
30
+
31
+ Add members to the `members` array in `config.json`:
32
+
33
+ ```json
34
+ {
35
+ "members": [
36
+ {
37
+ "id": "unique-id",
38
+ "name": "Developer Name",
39
+ "role": "developer",
40
+ "email": "dev@example.com",
41
+ "permissions": ["read", "write", "execute"],
42
+ "active": true
43
+ }
44
+ ]
45
+ }
46
+ ```
47
+
48
+ ### 3. Assign Roles
49
+
50
+ Available roles (defined in `roles.json`):
51
+
52
+ | Role | Description | Key Permissions |
53
+ |------|-------------|-----------------|
54
+ | `team-lead` | Full access, manages team | All permissions |
55
+ | `senior-developer` | Development + approvals | read, write, execute, approve |
56
+ | `developer` | Standard development | read, write, execute |
57
+ | `reviewer` | Code review focus | read, approve |
58
+ | `observer` | Read-only access | read |
59
+
60
+ ### 4. Configure Integrations (Optional)
61
+
62
+ #### Slack Notifications
63
+
64
+ ```json
65
+ {
66
+ "notifications": {
67
+ "enabled": true,
68
+ "channels": {
69
+ "slack": {
70
+ "webhook_url": "https://hooks.slack.com/...",
71
+ "channel": "#claude-notifications"
72
+ }
73
+ }
74
+ }
75
+ }
76
+ ```
77
+
78
+ #### Jira Integration
79
+
80
+ ```json
81
+ {
82
+ "integrations": {
83
+ "jira": {
84
+ "enabled": true,
85
+ "project_key": "PROJ",
86
+ "api_url": "https://your-domain.atlassian.net"
87
+ }
88
+ }
89
+ }
90
+ ```
91
+
92
+ ## Files
93
+
94
+ | File | Purpose |
95
+ |------|---------|
96
+ | `config.json` | Team settings, members, integrations |
97
+ | `roles.json` | Role definitions and permissions |
98
+
99
+ ## Usage
100
+
101
+ ### Session Handoffs
102
+
103
+ When ending a session, create a handoff document:
104
+
105
+ ```
106
+ /collab handoff
107
+ ```
108
+
109
+ This generates a session summary in `.ai-context/knowledge/sessions/` for the next team member.
110
+
111
+ ### Sync Shared Knowledge
112
+
113
+ Synchronize team knowledge base:
114
+
115
+ ```
116
+ /collab sync
117
+ ```
118
+
119
+ ### Check Team Status
120
+
121
+ View team configuration and active sessions:
122
+
123
+ ```
124
+ /collab status
125
+ ```
126
+
127
+ ## Policies
128
+
129
+ Configure team policies in `config.json`:
130
+
131
+ ```json
132
+ {
133
+ "policies": {
134
+ "code_review_required": true,
135
+ "documentation_update_required": true,
136
+ "test_coverage_minimum": 80,
137
+ "max_file_changes_per_session": 50
138
+ }
139
+ }
140
+ ```
141
+
142
+ ## Security Notes
143
+
144
+ - `config.json` may contain sensitive webhooks - consider gitignoring
145
+ - Use environment variables for API tokens
146
+ - Review member permissions regularly
147
+ - Session handoffs may contain context - handle appropriately
148
+
149
+ ## Troubleshooting
150
+
151
+ ### Member not recognized
152
+
153
+ Ensure the member entry in `config.json` has:
154
+ - Unique `id`
155
+ - Valid `role` matching `roles.json`
156
+ - `active: true`
157
+
158
+ ### Notifications not sending
159
+
160
+ 1. Verify webhook URL is correct
161
+ 2. Check `notifications.enabled` is `true`
162
+ 3. Ensure event type is enabled in `notifications.events`
163
+
164
+ ### Permission denied
165
+
166
+ 1. Check member's role in `config.json`
167
+ 2. Verify role has required permission in `roles.json`
168
+ 3. Ensure member is `active: true`
@@ -1,79 +1,79 @@
1
- {
2
- "$schema": "../schemas/team-config.schema.json",
3
- "$comment": "Team configuration for collaborative Claude Code sessions",
4
-
5
- "team": {
6
- "name": "{{TEAM_NAME}}",
7
- "organization": "{{ORGANIZATION_NAME}}",
8
- "created": "{{DATE}}",
9
- "version": "1.0.0"
10
- },
11
-
12
- "members": [
13
- {
14
- "id": "lead-1",
15
- "name": "{{TEAM_LEAD_NAME}}",
16
- "role": "team-lead",
17
- "email": "{{TEAM_LEAD_EMAIL}}",
18
- "permissions": ["all"],
19
- "active": true
20
- },
21
- {
22
- "id": "dev-1",
23
- "name": "{{DEVELOPER_1_NAME}}",
24
- "role": "developer",
25
- "email": "{{DEVELOPER_1_EMAIL}}",
26
- "permissions": ["read", "write", "execute"],
27
- "active": true
28
- }
29
- ],
30
-
31
- "settings": {
32
- "require_handoff_on_session_end": true,
33
- "auto_sync_knowledge": true,
34
- "shared_context_enabled": true,
35
- "session_timeout_minutes": 480,
36
- "max_concurrent_sessions": 5
37
- },
38
-
39
- "notifications": {
40
- "enabled": false,
41
- "channels": {
42
- "slack": {
43
- "webhook_url": "{{SLACK_WEBHOOK_URL}}",
44
- "channel": "#claude-notifications"
45
- },
46
- "email": {
47
- "smtp_configured": false
48
- }
49
- },
50
- "events": {
51
- "session_handoff": true,
52
- "knowledge_update": true,
53
- "error_critical": true
54
- }
55
- },
56
-
57
- "integrations": {
58
- "git": {
59
- "auto_attribute_commits": true,
60
- "co_author_format": "Co-Authored-By: {{MEMBER_NAME}} <{{MEMBER_EMAIL}}>"
61
- },
62
- "jira": {
63
- "enabled": false,
64
- "project_key": "{{JIRA_PROJECT_KEY}}",
65
- "api_url": "{{JIRA_API_URL}}"
66
- },
67
- "confluence": {
68
- "enabled": false,
69
- "space_key": "{{CONFLUENCE_SPACE_KEY}}"
70
- }
71
- },
72
-
73
- "policies": {
74
- "code_review_required": true,
75
- "documentation_update_required": true,
76
- "test_coverage_minimum": 80,
77
- "max_file_changes_per_session": 50
78
- }
79
- }
1
+ {
2
+ "$schema": "../schemas/team-config.schema.json",
3
+ "$comment": "Team configuration for collaborative Claude Code sessions",
4
+
5
+ "team": {
6
+ "name": "{{TEAM_NAME}}",
7
+ "organization": "{{ORGANIZATION_NAME}}",
8
+ "created": "{{DATE}}",
9
+ "version": "1.0.0"
10
+ },
11
+
12
+ "members": [
13
+ {
14
+ "id": "lead-1",
15
+ "name": "{{TEAM_LEAD_NAME}}",
16
+ "role": "team-lead",
17
+ "email": "{{TEAM_LEAD_EMAIL}}",
18
+ "permissions": ["all"],
19
+ "active": true
20
+ },
21
+ {
22
+ "id": "dev-1",
23
+ "name": "{{DEVELOPER_1_NAME}}",
24
+ "role": "developer",
25
+ "email": "{{DEVELOPER_1_EMAIL}}",
26
+ "permissions": ["read", "write", "execute"],
27
+ "active": true
28
+ }
29
+ ],
30
+
31
+ "settings": {
32
+ "require_handoff_on_session_end": true,
33
+ "auto_sync_knowledge": true,
34
+ "shared_context_enabled": true,
35
+ "session_timeout_minutes": 480,
36
+ "max_concurrent_sessions": 5
37
+ },
38
+
39
+ "notifications": {
40
+ "enabled": false,
41
+ "channels": {
42
+ "slack": {
43
+ "webhook_url": "{{SLACK_WEBHOOK_URL}}",
44
+ "channel": "#claude-notifications"
45
+ },
46
+ "email": {
47
+ "smtp_configured": false
48
+ }
49
+ },
50
+ "events": {
51
+ "session_handoff": true,
52
+ "knowledge_update": true,
53
+ "error_critical": true
54
+ }
55
+ },
56
+
57
+ "integrations": {
58
+ "git": {
59
+ "auto_attribute_commits": true,
60
+ "co_author_format": "Co-Authored-By: {{MEMBER_NAME}} <{{MEMBER_EMAIL}}>"
61
+ },
62
+ "jira": {
63
+ "enabled": false,
64
+ "project_key": "{{JIRA_PROJECT_KEY}}",
65
+ "api_url": "{{JIRA_API_URL}}"
66
+ },
67
+ "confluence": {
68
+ "enabled": false,
69
+ "space_key": "{{CONFLUENCE_SPACE_KEY}}"
70
+ }
71
+ },
72
+
73
+ "policies": {
74
+ "code_review_required": true,
75
+ "documentation_update_required": true,
76
+ "test_coverage_minimum": 80,
77
+ "max_file_changes_per_session": 50
78
+ }
79
+ }