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,129 +1,129 @@
1
- # Workflow Index - {{PROJECT_NAME}}
2
-
3
- **Purpose:** Master catalog of all documented workflows
4
- **Load First:** Always load this file before debugging/implementing
5
- **Size:** ~15k tokens (7.5% of 200k context budget)
6
- **Last Updated:** {{DATE}}
7
-
8
- ---
9
-
10
- ## Quick Navigation
11
-
12
- | # | Workflow | Complexity | Entry Point | Use When |
13
- |---|----------|------------|-------------|----------|
14
- | 1 | {{WORKFLOW_1}} | HIGH/MED/LOW | [file:line] | [Scenario] |
15
- | 2 | {{WORKFLOW_2}} | HIGH/MED/LOW | [file:line] | [Scenario] |
16
- | 3 | {{WORKFLOW_3}} | HIGH/MED/LOW | [file:line] | [Scenario] |
17
-
18
- ---
19
-
20
- ## Workflow Categories
21
-
22
- ### Category 1: {{CATEGORY_1_NAME}}
23
-
24
- **Workflows:** X
25
- **Total Lines:** ~XXX lines
26
- **Primary Agent:** {{AGENT_NAME}}
27
-
28
- | Workflow | Lines | Purpose |
29
- |----------|-------|---------|
30
- | [workflow_1.md](./workflows/workflow_1.md) | XXX | [Description] |
31
-
32
- **Use This Category For:**
33
- - [Scenario 1]
34
- - [Scenario 2]
35
-
36
- ---
37
-
38
- ### Category 2: {{CATEGORY_2_NAME}}
39
-
40
- [Same structure...]
41
-
42
- ---
43
-
44
- ## Cross-Reference Tables
45
-
46
- ### External APIs × Workflows
47
-
48
- | API | Used By Workflows |
49
- |-----|-------------------|
50
- | {{API_1}} | workflow_1, workflow_2 |
51
- | {{API_2}} | workflow_3 |
52
-
53
- ### Database Tables × Workflows
54
-
55
- | Table | Used By Workflows |
56
- |-------|-------------------|
57
- | {{TABLE_1}} | workflow_1, workflow_4 |
58
- | {{TABLE_2}} | workflow_2, workflow_3 |
59
-
60
- ### Test Files × Workflows
61
-
62
- | Test File | Covers Workflows |
63
- |-----------|------------------|
64
- | `test_workflow_1.ext` | workflow_1 |
65
- | `test_e2e.ext` | workflow_1, workflow_2 |
66
-
67
- ---
68
-
69
- ## Issue Triage Quick Reference
70
-
71
- | Symptom | Check Workflow | Key File:Line |
72
- |---------|---------------|---------------|
73
- | [Issue type 1] | workflow_1 | file.ext:XXX |
74
- | [Issue type 2] | workflow_2 | file.ext:YYY |
75
- | [Issue type 3] | workflow_3 | file.ext:ZZZ |
76
-
77
- ---
78
-
79
- ## Context Engineering Usage
80
-
81
- ### Loading Strategy
82
-
83
- ```
84
- Step 1: Load this file (~15k tokens)
85
- Step 2: Identify relevant workflow(s)
86
- Step 3: Load specific workflow file (~20-50k tokens)
87
- Step 4: Read specific code sections as needed
88
-
89
- Total: ~50-80k tokens (25-40% of budget)
90
- ```
91
-
92
- ### When to Load Full Workflow
93
-
94
- - **Debugging:** Load the affected workflow immediately
95
- - **Feature:** Load 2-3 related workflows
96
- - **Refactoring:** Load primary + dependent workflows
97
-
98
- ### When NOT to Load Full Workflow
99
-
100
- - **Simple fix:** Use this index + grep
101
- - **Configuration change:** Direct file edit
102
- - **Documentation update:** Direct doc edit
103
-
104
- ---
105
-
106
- ## Maintenance Schedule
107
-
108
- | Task | Frequency | Time Required |
109
- |------|-----------|---------------|
110
- | Spot-check 5 line numbers | Monthly | 15 minutes |
111
- | Re-run 3 discovery agents | Quarterly | 2 hours |
112
- | Full documentation audit | Annually | 4-6 hours |
113
-
114
- **Last Verification:** {{DATE}}
115
- **Next Verification:** {{NEXT_DATE}}
116
-
117
- ---
118
-
119
- ## See Also
120
-
121
- - **Detailed workflows:** [./workflows/](./workflows/)
122
- - **Code organization:** [../indexes/code/CATEGORY_INDEX.md](../indexes/code/CATEGORY_INDEX.md)
123
- - **Agent selection:** [../indexes/agents/CATEGORY_INDEX.md](../indexes/agents/CATEGORY_INDEX.md)
124
- - **Reverse lookup:** [./CODE_TO_WORKFLOW_MAP.md](./CODE_TO_WORKFLOW_MAP.md)
125
-
126
- ---
127
-
128
- **Version:** 1.0
129
- **Total Workflows:** {{WORKFLOWS_COUNT}}
1
+ # Workflow Index - {{PROJECT_NAME}}
2
+
3
+ **Purpose:** Master catalog of all documented workflows
4
+ **Load First:** Always load this file before debugging/implementing
5
+ **Size:** ~15k tokens (7.5% of 200k context budget)
6
+ **Last Updated:** {{DATE}}
7
+
8
+ ---
9
+
10
+ ## Quick Navigation
11
+
12
+ | # | Workflow | Complexity | Entry Point | Use When |
13
+ |---|----------|------------|-------------|----------|
14
+ | 1 | {{WORKFLOW_1}} | HIGH/MED/LOW | [file:line] | [Scenario] |
15
+ | 2 | {{WORKFLOW_2}} | HIGH/MED/LOW | [file:line] | [Scenario] |
16
+ | 3 | {{WORKFLOW_3}} | HIGH/MED/LOW | [file:line] | [Scenario] |
17
+
18
+ ---
19
+
20
+ ## Workflow Categories
21
+
22
+ ### Category 1: {{CATEGORY_1_NAME}}
23
+
24
+ **Workflows:** X
25
+ **Total Lines:** ~XXX lines
26
+ **Primary Agent:** {{AGENT_NAME}}
27
+
28
+ | Workflow | Lines | Purpose |
29
+ |----------|-------|---------|
30
+ | [workflow_1.md](./workflows/workflow_1.md) | XXX | [Description] |
31
+
32
+ **Use This Category For:**
33
+ - [Scenario 1]
34
+ - [Scenario 2]
35
+
36
+ ---
37
+
38
+ ### Category 2: {{CATEGORY_2_NAME}}
39
+
40
+ [Same structure...]
41
+
42
+ ---
43
+
44
+ ## Cross-Reference Tables
45
+
46
+ ### External APIs × Workflows
47
+
48
+ | API | Used By Workflows |
49
+ |-----|-------------------|
50
+ | {{API_1}} | workflow_1, workflow_2 |
51
+ | {{API_2}} | workflow_3 |
52
+
53
+ ### Database Tables × Workflows
54
+
55
+ | Table | Used By Workflows |
56
+ |-------|-------------------|
57
+ | {{TABLE_1}} | workflow_1, workflow_4 |
58
+ | {{TABLE_2}} | workflow_2, workflow_3 |
59
+
60
+ ### Test Files × Workflows
61
+
62
+ | Test File | Covers Workflows |
63
+ |-----------|------------------|
64
+ | `test_workflow_1.ext` | workflow_1 |
65
+ | `test_e2e.ext` | workflow_1, workflow_2 |
66
+
67
+ ---
68
+
69
+ ## Issue Triage Quick Reference
70
+
71
+ | Symptom | Check Workflow | Key File:Line |
72
+ |---------|---------------|---------------|
73
+ | [Issue type 1] | workflow_1 | file.ext:XXX |
74
+ | [Issue type 2] | workflow_2 | file.ext:YYY |
75
+ | [Issue type 3] | workflow_3 | file.ext:ZZZ |
76
+
77
+ ---
78
+
79
+ ## Context Engineering Usage
80
+
81
+ ### Loading Strategy
82
+
83
+ ```
84
+ Step 1: Load this file (~15k tokens)
85
+ Step 2: Identify relevant workflow(s)
86
+ Step 3: Load specific workflow file (~20-50k tokens)
87
+ Step 4: Read specific code sections as needed
88
+
89
+ Total: ~50-80k tokens (25-40% of budget)
90
+ ```
91
+
92
+ ### When to Load Full Workflow
93
+
94
+ - **Debugging:** Load the affected workflow immediately
95
+ - **Feature:** Load 2-3 related workflows
96
+ - **Refactoring:** Load primary + dependent workflows
97
+
98
+ ### When NOT to Load Full Workflow
99
+
100
+ - **Simple fix:** Use this index + grep
101
+ - **Configuration change:** Direct file edit
102
+ - **Documentation update:** Direct doc edit
103
+
104
+ ---
105
+
106
+ ## Maintenance Schedule
107
+
108
+ | Task | Frequency | Time Required |
109
+ |------|-----------|---------------|
110
+ | Spot-check 5 line numbers | Monthly | 15 minutes |
111
+ | Re-run 3 discovery agents | Quarterly | 2 hours |
112
+ | Full documentation audit | Annually | 4-6 hours |
113
+
114
+ **Last Verification:** {{DATE}}
115
+ **Next Verification:** {{NEXT_DATE}}
116
+
117
+ ---
118
+
119
+ ## See Also
120
+
121
+ - **Detailed workflows:** [./workflows/](./workflows/)
122
+ - **Code organization:** [../indexes/code/CATEGORY_INDEX.md](../indexes/code/CATEGORY_INDEX.md)
123
+ - **Agent selection:** [../indexes/agents/CATEGORY_INDEX.md](../indexes/agents/CATEGORY_INDEX.md)
124
+ - **Reverse lookup:** [./CODE_TO_WORKFLOW_MAP.md](./CODE_TO_WORKFLOW_MAP.md)
125
+
126
+ ---
127
+
128
+ **Version:** 1.0
129
+ **Total Workflows:** {{WORKFLOWS_COUNT}}