create-claude-context 1.0.0 → 1.2.1

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 (117) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +169 -146
  3. package/bin/create-claude-context.js +75 -61
  4. package/lib/ai-orchestrator.js +423 -0
  5. package/lib/call-tracer.js +444 -0
  6. package/lib/detector.js +456 -373
  7. package/lib/environment-detector.js +239 -0
  8. package/lib/index.js +271 -170
  9. package/lib/installer.js +371 -362
  10. package/lib/placeholder.js +269 -208
  11. package/lib/prompts.js +287 -287
  12. package/lib/spinner.js +60 -60
  13. package/lib/static-analyzer.js +729 -0
  14. package/lib/template-populator.js +835 -0
  15. package/lib/validate.js +147 -147
  16. package/package.json +59 -59
  17. package/templates/CLAUDE.md.template +235 -235
  18. package/templates/base/README.md +257 -257
  19. package/templates/base/RPI_WORKFLOW_PLAN.md +320 -320
  20. package/templates/base/agents/api-developer.md +76 -76
  21. package/templates/base/agents/context-engineer.md +525 -525
  22. package/templates/base/agents/core-architect.md +76 -76
  23. package/templates/base/agents/database-ops.md +76 -76
  24. package/templates/base/agents/deployment-ops.md +76 -76
  25. package/templates/base/agents/integration-hub.md +76 -76
  26. package/templates/base/analytics/README.md +114 -114
  27. package/templates/base/automation/config.json +58 -0
  28. package/templates/base/automation/generators/code-mapper.js +308 -0
  29. package/templates/base/automation/generators/index-builder.js +321 -0
  30. package/templates/base/automation/hooks/post-commit.sh +83 -0
  31. package/templates/base/automation/hooks/pre-commit.sh +103 -0
  32. package/templates/base/ci-templates/README.md +108 -108
  33. package/templates/base/ci-templates/github-actions/context-check.yml +144 -144
  34. package/templates/base/ci-templates/github-actions/validate-docs.yml +105 -105
  35. package/templates/base/commands/analytics.md +238 -238
  36. package/templates/base/commands/auto-sync.md +172 -0
  37. package/templates/base/commands/collab.md +194 -194
  38. package/templates/base/commands/help.md +450 -450
  39. package/templates/base/commands/rpi-implement.md +115 -115
  40. package/templates/base/commands/rpi-plan.md +93 -93
  41. package/templates/base/commands/rpi-research.md +88 -88
  42. package/templates/base/commands/session-resume.md +144 -0
  43. package/templates/base/commands/session-save.md +112 -0
  44. package/templates/base/commands/validate-all.md +77 -77
  45. package/templates/base/commands/verify-docs-current.md +86 -86
  46. package/templates/base/config/base.json +57 -57
  47. package/templates/base/config/environments/development.json +13 -13
  48. package/templates/base/config/environments/production.json +17 -17
  49. package/templates/base/config/environments/staging.json +13 -13
  50. package/templates/base/config/local.json.example +21 -21
  51. package/templates/base/context/.meta/generated-at.json +18 -0
  52. package/templates/base/context/ARCHITECTURE_SNAPSHOT.md +156 -156
  53. package/templates/base/context/CODE_TO_WORKFLOW_MAP.md +94 -94
  54. package/templates/base/context/FILE_OWNERSHIP.md +57 -0
  55. package/templates/base/context/INTEGRATION_POINTS.md +92 -0
  56. package/templates/base/context/KNOWN_GOTCHAS.md +195 -195
  57. package/templates/base/context/TESTING_MAP.md +95 -0
  58. package/templates/base/context/WORKFLOW_INDEX.md +129 -129
  59. package/templates/base/context/workflows/WORKFLOW_TEMPLATE.md +294 -294
  60. package/templates/base/indexes/agents/CAPABILITY_MATRIX.md +255 -255
  61. package/templates/base/indexes/agents/CATEGORY_INDEX.md +44 -44
  62. package/templates/base/indexes/code/CATEGORY_INDEX.md +38 -38
  63. package/templates/base/indexes/routing/CATEGORY_INDEX.md +39 -39
  64. package/templates/base/indexes/search/CATEGORY_INDEX.md +39 -39
  65. package/templates/base/indexes/workflows/CATEGORY_INDEX.md +38 -38
  66. package/templates/base/knowledge/README.md +98 -98
  67. package/templates/base/knowledge/sessions/README.md +88 -88
  68. package/templates/base/knowledge/sessions/TEMPLATE.md +150 -150
  69. package/templates/base/knowledge/shared/decisions/0001-adopt-context-engineering.md +144 -144
  70. package/templates/base/knowledge/shared/decisions/README.md +49 -49
  71. package/templates/base/knowledge/shared/decisions/TEMPLATE.md +123 -123
  72. package/templates/base/knowledge/shared/patterns/README.md +62 -62
  73. package/templates/base/knowledge/shared/patterns/TEMPLATE.md +120 -120
  74. package/templates/base/plans/PLAN_TEMPLATE.md +250 -250
  75. package/templates/base/research/RESEARCH_TEMPLATE.md +153 -153
  76. package/templates/base/schemas/agent.schema.json +141 -141
  77. package/templates/base/schemas/anchors.schema.json +54 -0
  78. package/templates/base/schemas/automation.schema.json +93 -0
  79. package/templates/base/schemas/command.schema.json +134 -134
  80. package/templates/base/schemas/hashes.schema.json +40 -0
  81. package/templates/base/schemas/manifest.schema.json +117 -117
  82. package/templates/base/schemas/plan.schema.json +136 -136
  83. package/templates/base/schemas/research.schema.json +115 -115
  84. package/templates/base/schemas/roles.schema.json +34 -0
  85. package/templates/base/schemas/session.schema.json +77 -0
  86. package/templates/base/schemas/settings.schema.json +244 -244
  87. package/templates/base/schemas/staleness.schema.json +53 -0
  88. package/templates/base/schemas/team-config.schema.json +42 -0
  89. package/templates/base/schemas/workflow.schema.json +126 -126
  90. package/templates/base/session/checkpoints/.gitkeep +2 -0
  91. package/templates/base/session/current/state.json +20 -0
  92. package/templates/base/session/history/.gitkeep +2 -0
  93. package/templates/base/settings.json +3 -57
  94. package/templates/base/standards/COMPATIBILITY.md +219 -219
  95. package/templates/base/standards/EXTENSION_GUIDELINES.md +280 -280
  96. package/templates/base/standards/QUALITY_CHECKLIST.md +211 -211
  97. package/templates/base/standards/README.md +66 -66
  98. package/templates/base/sync/anchors.json +6 -0
  99. package/templates/base/sync/hashes.json +6 -0
  100. package/templates/base/sync/staleness.json +10 -0
  101. package/templates/base/team/README.md +168 -168
  102. package/templates/base/team/config.json +79 -79
  103. package/templates/base/team/roles.json +145 -145
  104. package/templates/base/tools/bin/claude-context.js +151 -151
  105. package/templates/base/tools/lib/anchor-resolver.js +276 -0
  106. package/templates/base/tools/lib/config-loader.js +363 -363
  107. package/templates/base/tools/lib/detector.js +350 -350
  108. package/templates/base/tools/lib/diagnose.js +206 -206
  109. package/templates/base/tools/lib/drift-detector.js +373 -0
  110. package/templates/base/tools/lib/errors.js +199 -199
  111. package/templates/base/tools/lib/index.js +36 -24
  112. package/templates/base/tools/lib/init.js +192 -192
  113. package/templates/base/tools/lib/logger.js +230 -230
  114. package/templates/base/tools/lib/placeholder.js +201 -201
  115. package/templates/base/tools/lib/session-manager.js +354 -0
  116. package/templates/base/tools/lib/validate.js +521 -521
  117. package/templates/base/tools/package.json +49 -49
@@ -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 `.claude/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 `.claude/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
+ }