create-claude-context 1.0.0 → 1.2.0

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