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,123 +1,123 @@
1
- # ADR-NNNN: Title
2
-
3
- ## Metadata
4
-
5
- | Field | Value |
6
- |-------|-------|
7
- | **Status** | proposed / accepted / deprecated / rejected |
8
- | **Created** | YYYY-MM-DD |
9
- | **Updated** | YYYY-MM-DD |
10
- | **Author** | {{AUTHOR_NAME}} |
11
- | **Reviewers** | {{REVIEWER_NAMES}} |
12
- | **Supersedes** | ADR-XXXX (if applicable) |
13
- | **Superseded by** | ADR-XXXX (if applicable) |
14
-
15
- ## Context
16
-
17
- Describe the context and problem statement. What is the issue that we're seeing that is motivating this decision or change?
18
-
19
- ### Background
20
-
21
- - Relevant technical background
22
- - Business requirements driving this decision
23
- - Constraints we must work within
24
-
25
- ### Current State
26
-
27
- Describe the current situation, if applicable.
28
-
29
- ## Decision
30
-
31
- Describe the change that we're proposing or have made.
32
-
33
- ### Key Points
34
-
35
- 1. Point 1
36
- 2. Point 2
37
- 3. Point 3
38
-
39
- ## Alternatives Considered
40
-
41
- ### Alternative 1: [Name]
42
-
43
- **Description:** Brief description
44
-
45
- **Pros:**
46
- - Pro 1
47
- - Pro 2
48
-
49
- **Cons:**
50
- - Con 1
51
- - Con 2
52
-
53
- **Why not chosen:** Explanation
54
-
55
- ### Alternative 2: [Name]
56
-
57
- **Description:** Brief description
58
-
59
- **Pros:**
60
- - Pro 1
61
- - Pro 2
62
-
63
- **Cons:**
64
- - Con 1
65
- - Con 2
66
-
67
- **Why not chosen:** Explanation
68
-
69
- ## Consequences
70
-
71
- ### Positive
72
-
73
- - Positive consequence 1
74
- - Positive consequence 2
75
-
76
- ### Negative
77
-
78
- - Negative consequence 1
79
- - Negative consequence 2
80
-
81
- ### Risks
82
-
83
- - Risk 1 and mitigation
84
- - Risk 2 and mitigation
85
-
86
- ## Implementation
87
-
88
- ### Steps
89
-
90
- 1. Step 1
91
- 2. Step 2
92
- 3. Step 3
93
-
94
- ### Affected Components
95
-
96
- - Component 1: How it's affected
97
- - Component 2: How it's affected
98
-
99
- ### Migration Plan
100
-
101
- Describe any migration required, if applicable.
102
-
103
- ## Verification
104
-
105
- How will we verify this decision is successful?
106
-
107
- - [ ] Verification criteria 1
108
- - [ ] Verification criteria 2
109
- - [ ] Verification criteria 3
110
-
111
- ## References
112
-
113
- - [Link to relevant documentation]()
114
- - [Link to related issue/PR]()
115
- - [Link to external resources]()
116
-
117
- ---
118
-
119
- ## Revision History
120
-
121
- | Date | Author | Changes |
122
- |------|--------|---------|
123
- | YYYY-MM-DD | Name | Initial draft |
1
+ # ADR-NNNN: Title
2
+
3
+ ## Metadata
4
+
5
+ | Field | Value |
6
+ |-------|-------|
7
+ | **Status** | proposed / accepted / deprecated / rejected |
8
+ | **Created** | YYYY-MM-DD |
9
+ | **Updated** | YYYY-MM-DD |
10
+ | **Author** | {{AUTHOR_NAME}} |
11
+ | **Reviewers** | {{REVIEWER_NAMES}} |
12
+ | **Supersedes** | ADR-XXXX (if applicable) |
13
+ | **Superseded by** | ADR-XXXX (if applicable) |
14
+
15
+ ## Context
16
+
17
+ Describe the context and problem statement. What is the issue that we're seeing that is motivating this decision or change?
18
+
19
+ ### Background
20
+
21
+ - Relevant technical background
22
+ - Business requirements driving this decision
23
+ - Constraints we must work within
24
+
25
+ ### Current State
26
+
27
+ Describe the current situation, if applicable.
28
+
29
+ ## Decision
30
+
31
+ Describe the change that we're proposing or have made.
32
+
33
+ ### Key Points
34
+
35
+ 1. Point 1
36
+ 2. Point 2
37
+ 3. Point 3
38
+
39
+ ## Alternatives Considered
40
+
41
+ ### Alternative 1: [Name]
42
+
43
+ **Description:** Brief description
44
+
45
+ **Pros:**
46
+ - Pro 1
47
+ - Pro 2
48
+
49
+ **Cons:**
50
+ - Con 1
51
+ - Con 2
52
+
53
+ **Why not chosen:** Explanation
54
+
55
+ ### Alternative 2: [Name]
56
+
57
+ **Description:** Brief description
58
+
59
+ **Pros:**
60
+ - Pro 1
61
+ - Pro 2
62
+
63
+ **Cons:**
64
+ - Con 1
65
+ - Con 2
66
+
67
+ **Why not chosen:** Explanation
68
+
69
+ ## Consequences
70
+
71
+ ### Positive
72
+
73
+ - Positive consequence 1
74
+ - Positive consequence 2
75
+
76
+ ### Negative
77
+
78
+ - Negative consequence 1
79
+ - Negative consequence 2
80
+
81
+ ### Risks
82
+
83
+ - Risk 1 and mitigation
84
+ - Risk 2 and mitigation
85
+
86
+ ## Implementation
87
+
88
+ ### Steps
89
+
90
+ 1. Step 1
91
+ 2. Step 2
92
+ 3. Step 3
93
+
94
+ ### Affected Components
95
+
96
+ - Component 1: How it's affected
97
+ - Component 2: How it's affected
98
+
99
+ ### Migration Plan
100
+
101
+ Describe any migration required, if applicable.
102
+
103
+ ## Verification
104
+
105
+ How will we verify this decision is successful?
106
+
107
+ - [ ] Verification criteria 1
108
+ - [ ] Verification criteria 2
109
+ - [ ] Verification criteria 3
110
+
111
+ ## References
112
+
113
+ - [Link to relevant documentation]()
114
+ - [Link to related issue/PR]()
115
+ - [Link to external resources]()
116
+
117
+ ---
118
+
119
+ ## Revision History
120
+
121
+ | Date | Author | Changes |
122
+ |------|--------|---------|
123
+ | YYYY-MM-DD | Name | Initial draft |
@@ -1,62 +1,62 @@
1
- # Reusable Patterns
2
-
3
- This directory contains proven solutions to common problems encountered in the codebase.
4
-
5
- ## Categories
6
-
7
- | Category | Description |
8
- |----------|-------------|
9
- | `api/` | API design and implementation patterns |
10
- | `data/` | Data handling, validation, transformation |
11
- | `ui/` | User interface components and interactions |
12
- | `testing/` | Testing strategies and patterns |
13
- | `security/` | Security implementation patterns |
14
- | `performance/` | Performance optimization patterns |
15
-
16
- ## Pattern Template
17
-
18
- Each pattern document should include:
19
-
20
- ```markdown
21
- # Pattern Name
22
-
23
- ## Problem
24
- What problem does this pattern solve?
25
-
26
- ## Context
27
- When should this pattern be applied?
28
-
29
- ## Solution
30
- How does the pattern work?
31
-
32
- ## Code Example
33
- Concrete implementation example.
34
-
35
- ## Consequences
36
- Trade-offs and considerations.
37
-
38
- ## Related Patterns
39
- Links to related patterns.
40
- ```
41
-
42
- ## Adding a Pattern
43
-
44
- 1. Identify a recurring problem with a proven solution
45
- 2. Create document in appropriate category
46
- 3. Follow the template structure
47
- 4. Include working code examples
48
- 5. Reference actual codebase usage
49
-
50
- ## Using Patterns
51
-
52
- 1. Identify the problem you're solving
53
- 2. Check relevant category for existing patterns
54
- 3. Adapt the pattern to your specific context
55
- 4. Reference the pattern in your implementation
56
-
57
- ## Pattern Quality Criteria
58
-
59
- - **Proven**: Used successfully in production
60
- - **Documented**: Clear explanation and examples
61
- - **Maintained**: Updated when implementation changes
62
- - **Reviewed**: Approved by team lead or senior developer
1
+ # Reusable Patterns
2
+
3
+ This directory contains proven solutions to common problems encountered in the codebase.
4
+
5
+ ## Categories
6
+
7
+ | Category | Description |
8
+ |----------|-------------|
9
+ | `api/` | API design and implementation patterns |
10
+ | `data/` | Data handling, validation, transformation |
11
+ | `ui/` | User interface components and interactions |
12
+ | `testing/` | Testing strategies and patterns |
13
+ | `security/` | Security implementation patterns |
14
+ | `performance/` | Performance optimization patterns |
15
+
16
+ ## Pattern Template
17
+
18
+ Each pattern document should include:
19
+
20
+ ```markdown
21
+ # Pattern Name
22
+
23
+ ## Problem
24
+ What problem does this pattern solve?
25
+
26
+ ## Context
27
+ When should this pattern be applied?
28
+
29
+ ## Solution
30
+ How does the pattern work?
31
+
32
+ ## Code Example
33
+ Concrete implementation example.
34
+
35
+ ## Consequences
36
+ Trade-offs and considerations.
37
+
38
+ ## Related Patterns
39
+ Links to related patterns.
40
+ ```
41
+
42
+ ## Adding a Pattern
43
+
44
+ 1. Identify a recurring problem with a proven solution
45
+ 2. Create document in appropriate category
46
+ 3. Follow the template structure
47
+ 4. Include working code examples
48
+ 5. Reference actual codebase usage
49
+
50
+ ## Using Patterns
51
+
52
+ 1. Identify the problem you're solving
53
+ 2. Check relevant category for existing patterns
54
+ 3. Adapt the pattern to your specific context
55
+ 4. Reference the pattern in your implementation
56
+
57
+ ## Pattern Quality Criteria
58
+
59
+ - **Proven**: Used successfully in production
60
+ - **Documented**: Clear explanation and examples
61
+ - **Maintained**: Updated when implementation changes
62
+ - **Reviewed**: Approved by team lead or senior developer
@@ -1,120 +1,120 @@
1
- # Pattern: [Pattern Name]
2
-
3
- ## Metadata
4
-
5
- | Field | Value |
6
- |-------|-------|
7
- | **Category** | api / data / ui / testing / security / performance |
8
- | **Created** | YYYY-MM-DD |
9
- | **Updated** | YYYY-MM-DD |
10
- | **Author** | {{AUTHOR_NAME}} |
11
- | **Status** | draft / approved / deprecated |
12
-
13
- ## Problem
14
-
15
- Describe the problem this pattern solves.
16
-
17
- - What symptoms indicate this problem?
18
- - What are the consequences of not addressing it?
19
-
20
- ## Context
21
-
22
- When should this pattern be applied?
23
-
24
- ### Use When
25
-
26
- - Condition 1
27
- - Condition 2
28
- - Condition 3
29
-
30
- ### Don't Use When
31
-
32
- - Condition 1
33
- - Condition 2
34
-
35
- ## Solution
36
-
37
- ### Overview
38
-
39
- Brief description of how the pattern works.
40
-
41
- ### Structure
42
-
43
- ```
44
- [Diagram or structure description]
45
- ```
46
-
47
- ### Implementation Steps
48
-
49
- 1. Step 1
50
- 2. Step 2
51
- 3. Step 3
52
-
53
- ## Code Example
54
-
55
- ### Basic Usage
56
-
57
- ```{{LANGUAGE}}
58
- // Example code demonstrating the pattern
59
- ```
60
-
61
- ### Advanced Usage
62
-
63
- ```{{LANGUAGE}}
64
- // More complex example with edge cases
65
- ```
66
-
67
- ### Anti-Pattern (What NOT to Do)
68
-
69
- ```{{LANGUAGE}}
70
- // Example of incorrect implementation
71
- // Explain why this is wrong
72
- ```
73
-
74
- ## Codebase References
75
-
76
- Where this pattern is used in our codebase:
77
-
78
- | Location | Description |
79
- |----------|-------------|
80
- | `path/to/file.ext:123` | Brief description |
81
- | `path/to/other.ext:456` | Brief description |
82
-
83
- ## Consequences
84
-
85
- ### Benefits
86
-
87
- - Benefit 1
88
- - Benefit 2
89
- - Benefit 3
90
-
91
- ### Trade-offs
92
-
93
- - Trade-off 1
94
- - Trade-off 2
95
-
96
- ### Risks
97
-
98
- - Risk 1 and mitigation
99
- - Risk 2 and mitigation
100
-
101
- ## Related Patterns
102
-
103
- | Pattern | Relationship |
104
- |---------|--------------|
105
- | [Pattern Name](./path.md) | How they relate |
106
- | [Pattern Name](./path.md) | How they relate |
107
-
108
- ## References
109
-
110
- - [External resource]()
111
- - [Documentation]()
112
- - [Original source]()
113
-
114
- ---
115
-
116
- ## Revision History
117
-
118
- | Date | Author | Changes |
119
- |------|--------|---------|
120
- | YYYY-MM-DD | Name | Initial version |
1
+ # Pattern: [Pattern Name]
2
+
3
+ ## Metadata
4
+
5
+ | Field | Value |
6
+ |-------|-------|
7
+ | **Category** | api / data / ui / testing / security / performance |
8
+ | **Created** | YYYY-MM-DD |
9
+ | **Updated** | YYYY-MM-DD |
10
+ | **Author** | {{AUTHOR_NAME}} |
11
+ | **Status** | draft / approved / deprecated |
12
+
13
+ ## Problem
14
+
15
+ Describe the problem this pattern solves.
16
+
17
+ - What symptoms indicate this problem?
18
+ - What are the consequences of not addressing it?
19
+
20
+ ## Context
21
+
22
+ When should this pattern be applied?
23
+
24
+ ### Use When
25
+
26
+ - Condition 1
27
+ - Condition 2
28
+ - Condition 3
29
+
30
+ ### Don't Use When
31
+
32
+ - Condition 1
33
+ - Condition 2
34
+
35
+ ## Solution
36
+
37
+ ### Overview
38
+
39
+ Brief description of how the pattern works.
40
+
41
+ ### Structure
42
+
43
+ ```
44
+ [Diagram or structure description]
45
+ ```
46
+
47
+ ### Implementation Steps
48
+
49
+ 1. Step 1
50
+ 2. Step 2
51
+ 3. Step 3
52
+
53
+ ## Code Example
54
+
55
+ ### Basic Usage
56
+
57
+ ```{{LANGUAGE}}
58
+ // Example code demonstrating the pattern
59
+ ```
60
+
61
+ ### Advanced Usage
62
+
63
+ ```{{LANGUAGE}}
64
+ // More complex example with edge cases
65
+ ```
66
+
67
+ ### Anti-Pattern (What NOT to Do)
68
+
69
+ ```{{LANGUAGE}}
70
+ // Example of incorrect implementation
71
+ // Explain why this is wrong
72
+ ```
73
+
74
+ ## Codebase References
75
+
76
+ Where this pattern is used in our codebase:
77
+
78
+ | Location | Description |
79
+ |----------|-------------|
80
+ | `path/to/file.ext:123` | Brief description |
81
+ | `path/to/other.ext:456` | Brief description |
82
+
83
+ ## Consequences
84
+
85
+ ### Benefits
86
+
87
+ - Benefit 1
88
+ - Benefit 2
89
+ - Benefit 3
90
+
91
+ ### Trade-offs
92
+
93
+ - Trade-off 1
94
+ - Trade-off 2
95
+
96
+ ### Risks
97
+
98
+ - Risk 1 and mitigation
99
+ - Risk 2 and mitigation
100
+
101
+ ## Related Patterns
102
+
103
+ | Pattern | Relationship |
104
+ |---------|--------------|
105
+ | [Pattern Name](./path.md) | How they relate |
106
+ | [Pattern Name](./path.md) | How they relate |
107
+
108
+ ## References
109
+
110
+ - [External resource]()
111
+ - [Documentation]()
112
+ - [Original source]()
113
+
114
+ ---
115
+
116
+ ## Revision History
117
+
118
+ | Date | Author | Changes |
119
+ |------|--------|---------|
120
+ | YYYY-MM-DD | Name | Initial version |