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,76 +1,76 @@
1
- ---
2
- name: api-developer
3
- version: "1.0.0"
4
- displayName: "API Developer"
5
- description: "API design, contract definition, and endpoint implementation specialist"
6
- category: "api"
7
- complexity: "medium"
8
- context_budget: "~35K tokens"
9
- capabilities:
10
- - "rest-api-design"
11
- - "graphql-design"
12
- - "contract-definition"
13
- - "endpoint-documentation"
14
- - "api-testing-strategy"
15
- workflows:
16
- - "api-endpoints"
17
- - "contracts"
18
- - "versioning"
19
- commands: ["/rpi-research", "/rpi-plan", "/rpi-implement"]
20
- dependencies:
21
- agents: []
22
- commands: []
23
- hooks:
24
- pre_invoke: null
25
- post_invoke: "verify-docs-current"
26
- examples:
27
- - invocation: '@api-developer "Document API endpoints for [resource]"'
28
- description: "Create comprehensive API documentation"
29
- - invocation: '@api-developer "Validate API contracts"'
30
- description: "Check contract consistency and completeness"
31
- - invocation: '@api-developer "Generate OpenAPI spec"'
32
- description: "Create OpenAPI/Swagger specification"
33
- ---
34
-
35
- # API Developer Agent
36
-
37
- **Purpose:** API design, contract definition, and endpoint implementation
38
-
39
- ## Capabilities
40
-
41
- This agent specializes in:
42
- - **API design** - Creating RESTful and GraphQL APIs with proper conventions
43
- - **Contract definition** - Defining request/response schemas and validation rules
44
- - **Endpoint implementation** - Generating boilerplate for API endpoints
45
- - **Documentation generation** - Creating comprehensive API documentation
46
- - **Testing strategy** - Planning and implementing API tests
47
-
48
- ## Usage
49
-
50
- After template initialization, this agent will be generated based on your API structure. It will:
51
- 1. Analyze your existing API endpoints
52
- 2. Create comprehensive API documentation
53
- 3. Identify potential security vulnerabilities
54
- 4. Provide recommendations for API optimization
55
-
56
- ## Example Commands
57
-
58
- ```bash
59
- @api-developer "Document API endpoints for [resource]"
60
- @api-developer "Validate API contracts for [endpoint]"
61
- @api-developer "Generate test cases for [API]"
62
- ```
63
-
64
- ## Integration Points
65
-
66
- This agent integrates with:
67
- - Workflow documentation
68
- - Database schema (for data endpoints)
69
- - Testing strategies
70
- - Security validation
71
-
72
- ## Validation
73
-
74
- - API contract consistency
75
- - Endpoint security checks
76
- - Response schema validation
1
+ ---
2
+ name: api-developer
3
+ version: "1.0.0"
4
+ displayName: "API Developer"
5
+ description: "API design, contract definition, and endpoint implementation specialist"
6
+ category: "api"
7
+ complexity: "medium"
8
+ context_budget: "~35K tokens"
9
+ capabilities:
10
+ - "rest-api-design"
11
+ - "graphql-design"
12
+ - "contract-definition"
13
+ - "endpoint-documentation"
14
+ - "api-testing-strategy"
15
+ workflows:
16
+ - "api-endpoints"
17
+ - "contracts"
18
+ - "versioning"
19
+ commands: ["/rpi-research", "/rpi-plan", "/rpi-implement"]
20
+ dependencies:
21
+ agents: []
22
+ commands: []
23
+ hooks:
24
+ pre_invoke: null
25
+ post_invoke: "verify-docs-current"
26
+ examples:
27
+ - invocation: '@api-developer "Document API endpoints for [resource]"'
28
+ description: "Create comprehensive API documentation"
29
+ - invocation: '@api-developer "Validate API contracts"'
30
+ description: "Check contract consistency and completeness"
31
+ - invocation: '@api-developer "Generate OpenAPI spec"'
32
+ description: "Create OpenAPI/Swagger specification"
33
+ ---
34
+
35
+ # API Developer Agent
36
+
37
+ **Purpose:** API design, contract definition, and endpoint implementation
38
+
39
+ ## Capabilities
40
+
41
+ This agent specializes in:
42
+ - **API design** - Creating RESTful and GraphQL APIs with proper conventions
43
+ - **Contract definition** - Defining request/response schemas and validation rules
44
+ - **Endpoint implementation** - Generating boilerplate for API endpoints
45
+ - **Documentation generation** - Creating comprehensive API documentation
46
+ - **Testing strategy** - Planning and implementing API tests
47
+
48
+ ## Usage
49
+
50
+ After template initialization, this agent will be generated based on your API structure. It will:
51
+ 1. Analyze your existing API endpoints
52
+ 2. Create comprehensive API documentation
53
+ 3. Identify potential security vulnerabilities
54
+ 4. Provide recommendations for API optimization
55
+
56
+ ## Example Commands
57
+
58
+ ```bash
59
+ @api-developer "Document API endpoints for [resource]"
60
+ @api-developer "Validate API contracts for [endpoint]"
61
+ @api-developer "Generate test cases for [API]"
62
+ ```
63
+
64
+ ## Integration Points
65
+
66
+ This agent integrates with:
67
+ - Workflow documentation
68
+ - Database schema (for data endpoints)
69
+ - Testing strategies
70
+ - Security validation
71
+
72
+ ## Validation
73
+
74
+ - API contract consistency
75
+ - Endpoint security checks
76
+ - Response schema validation