xtrm-tools 2.0.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 (447) hide show
  1. package/CHANGELOG.md +496 -0
  2. package/README.md +762 -0
  3. package/cli/dist/index.cjs +55245 -0
  4. package/cli/dist/index.cjs.map +1 -0
  5. package/cli/dist/index.d.cts +2 -0
  6. package/cli/package.json +43 -0
  7. package/config/.env.example +40 -0
  8. package/config/hooks.json +36 -0
  9. package/config/mcp_servers.json +46 -0
  10. package/config/mcp_servers_optional.json +53 -0
  11. package/config/settings.json +70 -0
  12. package/hooks/README.md +156 -0
  13. package/hooks/__pycache__/agent_context.cpython-314.pyc +0 -0
  14. package/hooks/agent_context.py +105 -0
  15. package/hooks/gitnexus/gitnexus-hook.cjs +133 -0
  16. package/hooks/serena-workflow-reminder.py +74 -0
  17. package/hooks/skill-discovery.py +90 -0
  18. package/hooks/skill-suggestion.py +112 -0
  19. package/hooks/test_agent_context.py +112 -0
  20. package/hooks/type-safety-enforcement.py +107 -0
  21. package/package.json +48 -0
  22. package/project-skills/main-guard/.claude/hooks/main-guard.cjs +188 -0
  23. package/project-skills/main-guard/.claude/settings.json +16 -0
  24. package/project-skills/main-guard/.claude/skills/using-main-guard/SKILL.md +135 -0
  25. package/project-skills/main-guard/README.md +163 -0
  26. package/project-skills/py-quality-gate/.claude/hooks/quality-check.py +311 -0
  27. package/project-skills/py-quality-gate/.claude/settings.json +16 -0
  28. package/project-skills/py-quality-gate/.claude/skills/using-py-quality-gate/SKILL.md +112 -0
  29. package/project-skills/py-quality-gate/README.md +147 -0
  30. package/project-skills/service-skills-set/.claude/git-hooks/__pycache__/doc_reminder.cpython-314.pyc +0 -0
  31. package/project-skills/service-skills-set/.claude/git-hooks/__pycache__/skill_staleness.cpython-314.pyc +0 -0
  32. package/project-skills/service-skills-set/.claude/git-hooks/doc_reminder.py +67 -0
  33. package/project-skills/service-skills-set/.claude/git-hooks/skill_staleness.py +194 -0
  34. package/project-skills/service-skills-set/.claude/service-registry.json +4 -0
  35. package/project-skills/service-skills-set/.claude/settings.json +37 -0
  36. package/project-skills/service-skills-set/.claude/skills/creating-service-skills/SKILL.md +433 -0
  37. package/project-skills/service-skills-set/.claude/skills/creating-service-skills/references/script_quality_standards.md +412 -0
  38. package/project-skills/service-skills-set/.claude/skills/creating-service-skills/references/service_skill_system_guide.md +264 -0
  39. package/project-skills/service-skills-set/.claude/skills/creating-service-skills/scripts/bootstrap.py +308 -0
  40. package/project-skills/service-skills-set/.claude/skills/creating-service-skills/scripts/deep_dive.py +304 -0
  41. package/project-skills/service-skills-set/.claude/skills/creating-service-skills/scripts/scaffolder.py +482 -0
  42. package/project-skills/service-skills-set/.claude/skills/scoping-service-skills/SKILL.md +231 -0
  43. package/project-skills/service-skills-set/.claude/skills/scoping-service-skills/scripts/scope.py +74 -0
  44. package/project-skills/service-skills-set/.claude/skills/updating-service-skills/SKILL.md +136 -0
  45. package/project-skills/service-skills-set/.claude/skills/updating-service-skills/scripts/__pycache__/drift_detector.cpython-314.pyc +0 -0
  46. package/project-skills/service-skills-set/.claude/skills/updating-service-skills/scripts/drift_detector.py +222 -0
  47. package/project-skills/service-skills-set/.claude/skills/using-service-skills/SKILL.md +108 -0
  48. package/project-skills/service-skills-set/.claude/skills/using-service-skills/scripts/__pycache__/cataloger.cpython-314.pyc +0 -0
  49. package/project-skills/service-skills-set/.claude/skills/using-service-skills/scripts/__pycache__/skill_activator.cpython-314.pyc +0 -0
  50. package/project-skills/service-skills-set/.claude/skills/using-service-skills/scripts/cataloger.py +74 -0
  51. package/project-skills/service-skills-set/.claude/skills/using-service-skills/scripts/skill_activator.py +152 -0
  52. package/project-skills/service-skills-set/README.md +93 -0
  53. package/project-skills/service-skills-set/__pycache__/install-service-skills.cpython-314.pyc +0 -0
  54. package/project-skills/service-skills-set/install-service-skills.py +163 -0
  55. package/project-skills/service-skills-set/service-skills-readme.md +236 -0
  56. package/project-skills/tdd-guard/.claude/settings.json +38 -0
  57. package/project-skills/tdd-guard/.claude/skills/using-tdd-guard/SKILL.md +74 -0
  58. package/project-skills/tdd-guard/CLAUDE.md +98 -0
  59. package/project-skills/tdd-guard/CONTRIBUTING.md +38 -0
  60. package/project-skills/tdd-guard/DEVELOPMENT.md +127 -0
  61. package/project-skills/tdd-guard/LICENSE +21 -0
  62. package/project-skills/tdd-guard/README.md +396 -0
  63. package/project-skills/tdd-guard/docs/adr/001-claude-session-subdirectory.md +52 -0
  64. package/project-skills/tdd-guard/docs/adr/002-secure-claude-binary-path.md +56 -0
  65. package/project-skills/tdd-guard/docs/adr/003-remove-configurable-data-directory.md +56 -0
  66. package/project-skills/tdd-guard/docs/adr/004-monorepo-architecture.md +64 -0
  67. package/project-skills/tdd-guard/docs/adr/005-claude-project-dir-support.md +55 -0
  68. package/project-skills/tdd-guard/docs/adr/006-phpunit-separate-repository.md +93 -0
  69. package/project-skills/tdd-guard/docs/adr/007-golangci-lint-path-support.md +83 -0
  70. package/project-skills/tdd-guard/docs/adr/008-storybook-reporter-design.md +182 -0
  71. package/project-skills/tdd-guard/docs/assets/tdd-guard-demo-screenshot.gif +0 -0
  72. package/project-skills/tdd-guard/docs/config-migration.md +143 -0
  73. package/project-skills/tdd-guard/docs/configuration.md +137 -0
  74. package/project-skills/tdd-guard/docs/custom-instructions.md +43 -0
  75. package/project-skills/tdd-guard/docs/enforcement.md +46 -0
  76. package/project-skills/tdd-guard/docs/ignore-patterns.md +81 -0
  77. package/project-skills/tdd-guard/docs/linting.md +109 -0
  78. package/project-skills/tdd-guard/docs/quick-commands.md +52 -0
  79. package/project-skills/tdd-guard/docs/session-management.md +75 -0
  80. package/project-skills/tdd-guard/docs/storybook-vitest-addon.md +120 -0
  81. package/project-skills/tdd-guard/docs/validation-model.md +63 -0
  82. package/project-skills/tdd-guard/eslint.config.mjs +140 -0
  83. package/project-skills/tdd-guard/package-lock.json +16937 -0
  84. package/project-skills/tdd-guard/package.json +102 -0
  85. package/project-skills/tdd-guard/reporters/go/README.md +67 -0
  86. package/project-skills/tdd-guard/reporters/go/cmd/tdd-guard-go/main.go +127 -0
  87. package/project-skills/tdd-guard/reporters/go/cmd/tdd-guard-go/main_test.go +280 -0
  88. package/project-skills/tdd-guard/reporters/go/go.mod +3 -0
  89. package/project-skills/tdd-guard/reporters/go/go.sum +0 -0
  90. package/project-skills/tdd-guard/reporters/go/internal/formatter/formatter.go +126 -0
  91. package/project-skills/tdd-guard/reporters/go/internal/formatter/formatter_test.go +264 -0
  92. package/project-skills/tdd-guard/reporters/go/internal/io/tee_reader.go +26 -0
  93. package/project-skills/tdd-guard/reporters/go/internal/io/tee_reader_test.go +37 -0
  94. package/project-skills/tdd-guard/reporters/go/internal/parser/mixed_reader.go +94 -0
  95. package/project-skills/tdd-guard/reporters/go/internal/parser/mixed_reader_test.go +198 -0
  96. package/project-skills/tdd-guard/reporters/go/internal/parser/parser.go +245 -0
  97. package/project-skills/tdd-guard/reporters/go/internal/parser/parser_test.go +547 -0
  98. package/project-skills/tdd-guard/reporters/go/internal/storage/storage.go +35 -0
  99. package/project-skills/tdd-guard/reporters/go/internal/storage/storage_test.go +113 -0
  100. package/project-skills/tdd-guard/reporters/go/internal/transformer/transformer.go +103 -0
  101. package/project-skills/tdd-guard/reporters/go/internal/transformer/transformer_test.go +303 -0
  102. package/project-skills/tdd-guard/reporters/jest/README.md +102 -0
  103. package/project-skills/tdd-guard/reporters/jest/package.json +38 -0
  104. package/project-skills/tdd-guard/reporters/phpunit/.php-cs-fixer.php +28 -0
  105. package/project-skills/tdd-guard/reporters/phpunit/README.md +97 -0
  106. package/project-skills/tdd-guard/reporters/phpunit/SYNC_README.md +29 -0
  107. package/project-skills/tdd-guard/reporters/phpunit/composer.json +55 -0
  108. package/project-skills/tdd-guard/reporters/phpunit/phpunit.xml.dist +19 -0
  109. package/project-skills/tdd-guard/reporters/phpunit/psalm.xml +44 -0
  110. package/project-skills/tdd-guard/reporters/phpunit/src/Event/ErroredTestSubscriber.php +28 -0
  111. package/project-skills/tdd-guard/reporters/phpunit/src/Event/FailedTestSubscriber.php +28 -0
  112. package/project-skills/tdd-guard/reporters/phpunit/src/Event/IncompleteTestSubscriber.php +28 -0
  113. package/project-skills/tdd-guard/reporters/phpunit/src/Event/PassedTestSubscriber.php +27 -0
  114. package/project-skills/tdd-guard/reporters/phpunit/src/Event/SkippedTestSubscriber.php +28 -0
  115. package/project-skills/tdd-guard/reporters/phpunit/src/Event/TestRunnerFinishedSubscriber.php +24 -0
  116. package/project-skills/tdd-guard/reporters/phpunit/src/PathValidator.php +88 -0
  117. package/project-skills/tdd-guard/reporters/phpunit/src/Storage.php +26 -0
  118. package/project-skills/tdd-guard/reporters/phpunit/src/TddGuardExtension.php +33 -0
  119. package/project-skills/tdd-guard/reporters/phpunit/src/TddGuardListener.php +158 -0
  120. package/project-skills/tdd-guard/reporters/phpunit/src/TddGuardSubscriber.php +35 -0
  121. package/project-skills/tdd-guard/reporters/phpunit/src/TestResultCollector.php +105 -0
  122. package/project-skills/tdd-guard/reporters/phpunit/tests/PathValidatorTest.php +74 -0
  123. package/project-skills/tdd-guard/reporters/phpunit/tests/TddGuardExtensionFailedTest.php +241 -0
  124. package/project-skills/tdd-guard/reporters/phpunit/tests/TddGuardExtensionTest.php +84 -0
  125. package/project-skills/tdd-guard/reporters/phpunit/tests/TddGuardStorageLocationTest.php +71 -0
  126. package/project-skills/tdd-guard/reporters/pytest/README.md +77 -0
  127. package/project-skills/tdd-guard/reporters/pytest/pyproject.toml +43 -0
  128. package/project-skills/tdd-guard/reporters/pytest/pytest.ini.example +7 -0
  129. package/project-skills/tdd-guard/reporters/pytest/tdd_guard_pytest/__init__.py +1 -0
  130. package/project-skills/tdd-guard/reporters/pytest/tdd_guard_pytest/pytest_reporter.py +134 -0
  131. package/project-skills/tdd-guard/reporters/pytest/tests/__init__.py +1 -0
  132. package/project-skills/tdd-guard/reporters/pytest/tests/conftest.py +3 -0
  133. package/project-skills/tdd-guard/reporters/pytest/tests/helpers.py +293 -0
  134. package/project-skills/tdd-guard/reporters/pytest/tests/test_config_option.py +38 -0
  135. package/project-skills/tdd-guard/reporters/pytest/tests/test_path_validation.py +59 -0
  136. package/project-skills/tdd-guard/reporters/pytest/tests/test_plugin_config.py +32 -0
  137. package/project-skills/tdd-guard/reporters/pytest/tests/test_project_root.py +296 -0
  138. package/project-skills/tdd-guard/reporters/pytest/tests/test_pytest_reporter.py +137 -0
  139. package/project-skills/tdd-guard/reporters/rspec/Gemfile +3 -0
  140. package/project-skills/tdd-guard/reporters/rust/Cargo.lock +458 -0
  141. package/project-skills/tdd-guard/reporters/rust/Cargo.toml +33 -0
  142. package/project-skills/tdd-guard/reporters/rust/Makefile.example +95 -0
  143. package/project-skills/tdd-guard/reporters/rust/README.md +88 -0
  144. package/project-skills/tdd-guard/reporters/rust/src/error_parser.rs +309 -0
  145. package/project-skills/tdd-guard/reporters/rust/src/main.rs +464 -0
  146. package/project-skills/tdd-guard/reporters/rust/src/parser.rs +225 -0
  147. package/project-skills/tdd-guard/reporters/rust/src/transformer.rs +409 -0
  148. package/project-skills/tdd-guard/reporters/storybook/README.md +108 -0
  149. package/project-skills/tdd-guard/reporters/storybook/package-lock.json +9482 -0
  150. package/project-skills/tdd-guard/reporters/storybook/package.json +43 -0
  151. package/project-skills/tdd-guard/reporters/storybook/src/StorybookReporter.test-data.ts +22 -0
  152. package/project-skills/tdd-guard/reporters/storybook/src/StorybookReporter.test.ts +190 -0
  153. package/project-skills/tdd-guard/reporters/storybook/src/StorybookReporter.ts +88 -0
  154. package/project-skills/tdd-guard/reporters/storybook/src/index.ts +12 -0
  155. package/project-skills/tdd-guard/reporters/storybook/src/types.ts +37 -0
  156. package/project-skills/tdd-guard/reporters/storybook/tsconfig.json +11 -0
  157. package/project-skills/tdd-guard/reporters/test/artifacts/go/failing/go.mod +3 -0
  158. package/project-skills/tdd-guard/reporters/test/artifacts/go/failing/single_failing_test.go +13 -0
  159. package/project-skills/tdd-guard/reporters/test/artifacts/go/import/go.mod +3 -0
  160. package/project-skills/tdd-guard/reporters/test/artifacts/go/import/single_import_error_test.go +17 -0
  161. package/project-skills/tdd-guard/reporters/test/artifacts/go/passing/go.mod +3 -0
  162. package/project-skills/tdd-guard/reporters/test/artifacts/go/passing/single_passing_test.go +13 -0
  163. package/project-skills/tdd-guard/reporters/test/artifacts/jest/single-failing.test.js +5 -0
  164. package/project-skills/tdd-guard/reporters/test/artifacts/jest/single-import-error.test.js +8 -0
  165. package/project-skills/tdd-guard/reporters/test/artifacts/jest/single-passing.test.js +5 -0
  166. package/project-skills/tdd-guard/reporters/test/artifacts/phpunit/SingleFailingTest.php +11 -0
  167. package/project-skills/tdd-guard/reporters/test/artifacts/phpunit/SingleImportErrorTest.php +14 -0
  168. package/project-skills/tdd-guard/reporters/test/artifacts/phpunit/SinglePassingTest.php +11 -0
  169. package/project-skills/tdd-guard/reporters/test/artifacts/pytest/test_single_failing.py +3 -0
  170. package/project-skills/tdd-guard/reporters/test/artifacts/pytest/test_single_import_error.py +6 -0
  171. package/project-skills/tdd-guard/reporters/test/artifacts/pytest/test_single_passing.py +3 -0
  172. package/project-skills/tdd-guard/reporters/test/artifacts/rust/failing/Cargo.lock +7 -0
  173. package/project-skills/tdd-guard/reporters/test/artifacts/rust/failing/Cargo.toml +4 -0
  174. package/project-skills/tdd-guard/reporters/test/artifacts/rust/failing/src/lib.rs +14 -0
  175. package/project-skills/tdd-guard/reporters/test/artifacts/rust/import/Cargo.lock +7 -0
  176. package/project-skills/tdd-guard/reporters/test/artifacts/rust/import/Cargo.toml +4 -0
  177. package/project-skills/tdd-guard/reporters/test/artifacts/rust/import/src/lib.rs +13 -0
  178. package/project-skills/tdd-guard/reporters/test/artifacts/rust/passing/Cargo.lock +7 -0
  179. package/project-skills/tdd-guard/reporters/test/artifacts/rust/passing/Cargo.toml +4 -0
  180. package/project-skills/tdd-guard/reporters/test/artifacts/rust/passing/src/lib.rs +14 -0
  181. package/project-skills/tdd-guard/reporters/test/artifacts/storybook/Calculator.js +4 -0
  182. package/project-skills/tdd-guard/reporters/test/artifacts/storybook/single-failing.stories.js +15 -0
  183. package/project-skills/tdd-guard/reporters/test/artifacts/storybook/single-import-error.stories.js +14 -0
  184. package/project-skills/tdd-guard/reporters/test/artifacts/storybook/single-passing.stories.js +15 -0
  185. package/project-skills/tdd-guard/reporters/test/artifacts/vitest/single-failing.test.js +7 -0
  186. package/project-skills/tdd-guard/reporters/test/artifacts/vitest/single-import-error.test.js +9 -0
  187. package/project-skills/tdd-guard/reporters/test/artifacts/vitest/single-passing.test.js +7 -0
  188. package/project-skills/tdd-guard/reporters/test/factories/go.ts +59 -0
  189. package/project-skills/tdd-guard/reporters/test/factories/helpers.ts +48 -0
  190. package/project-skills/tdd-guard/reporters/test/factories/index.ts +7 -0
  191. package/project-skills/tdd-guard/reporters/test/factories/jest.ts +51 -0
  192. package/project-skills/tdd-guard/reporters/test/factories/phpunit.ts +63 -0
  193. package/project-skills/tdd-guard/reporters/test/factories/pytest.ts +41 -0
  194. package/project-skills/tdd-guard/reporters/test/factories/rust.ts +158 -0
  195. package/project-skills/tdd-guard/reporters/test/factories/storybook.ts +198 -0
  196. package/project-skills/tdd-guard/reporters/test/factories/vitest.ts +51 -0
  197. package/project-skills/tdd-guard/reporters/test/reporters.integration.test.ts +735 -0
  198. package/project-skills/tdd-guard/reporters/test/types.ts +28 -0
  199. package/project-skills/tdd-guard/reporters/vitest/README.md +64 -0
  200. package/project-skills/tdd-guard/reporters/vitest/package.json +35 -0
  201. package/project-skills/tdd-guard/src/cli/buildContext.test.ts +200 -0
  202. package/project-skills/tdd-guard/src/cli/buildContext.ts +48 -0
  203. package/project-skills/tdd-guard/src/cli/tdd-guard.test.ts +159 -0
  204. package/project-skills/tdd-guard/src/cli/tdd-guard.ts +48 -0
  205. package/project-skills/tdd-guard/src/config/Config.test.ts +538 -0
  206. package/project-skills/tdd-guard/src/config/Config.ts +172 -0
  207. package/project-skills/tdd-guard/src/contracts/schemas/guardSchemas.test.ts +58 -0
  208. package/project-skills/tdd-guard/src/contracts/schemas/guardSchemas.ts +8 -0
  209. package/project-skills/tdd-guard/src/contracts/schemas/lintSchemas.test.ts +347 -0
  210. package/project-skills/tdd-guard/src/contracts/schemas/lintSchemas.ts +61 -0
  211. package/project-skills/tdd-guard/src/contracts/schemas/pytestSchemas.test.ts +24 -0
  212. package/project-skills/tdd-guard/src/contracts/schemas/pytestSchemas.ts +7 -0
  213. package/project-skills/tdd-guard/src/contracts/schemas/reporterSchemas.test.ts +377 -0
  214. package/project-skills/tdd-guard/src/contracts/schemas/reporterSchemas.ts +75 -0
  215. package/project-skills/tdd-guard/src/contracts/schemas/toolSchemas.test.ts +563 -0
  216. package/project-skills/tdd-guard/src/contracts/schemas/toolSchemas.ts +140 -0
  217. package/project-skills/tdd-guard/src/contracts/types/ClientType.ts +1 -0
  218. package/project-skills/tdd-guard/src/contracts/types/ConfigOptions.ts +12 -0
  219. package/project-skills/tdd-guard/src/contracts/types/Context.ts +16 -0
  220. package/project-skills/tdd-guard/src/contracts/types/ModelClient.ts +3 -0
  221. package/project-skills/tdd-guard/src/contracts/types/ValidationResult.ts +6 -0
  222. package/project-skills/tdd-guard/src/guard/GuardManager.test.ts +336 -0
  223. package/project-skills/tdd-guard/src/guard/GuardManager.ts +83 -0
  224. package/project-skills/tdd-guard/src/hooks/HookEvents.test.ts +107 -0
  225. package/project-skills/tdd-guard/src/hooks/HookEvents.ts +39 -0
  226. package/project-skills/tdd-guard/src/hooks/fileTypeDetection.ts +16 -0
  227. package/project-skills/tdd-guard/src/hooks/postToolLint.test.ts +327 -0
  228. package/project-skills/tdd-guard/src/hooks/postToolLint.ts +165 -0
  229. package/project-skills/tdd-guard/src/hooks/processHookData.test.ts +465 -0
  230. package/project-skills/tdd-guard/src/hooks/processHookData.ts +203 -0
  231. package/project-skills/tdd-guard/src/hooks/sessionHandler.test.ts +136 -0
  232. package/project-skills/tdd-guard/src/hooks/sessionHandler.ts +31 -0
  233. package/project-skills/tdd-guard/src/hooks/userPromptHandler.test.ts +131 -0
  234. package/project-skills/tdd-guard/src/hooks/userPromptHandler.ts +55 -0
  235. package/project-skills/tdd-guard/src/index.ts +19 -0
  236. package/project-skills/tdd-guard/src/linters/Linter.ts +5 -0
  237. package/project-skills/tdd-guard/src/linters/eslint/ESLint.test.ts +183 -0
  238. package/project-skills/tdd-guard/src/linters/eslint/ESLint.ts +82 -0
  239. package/project-skills/tdd-guard/src/linters/golangci/GolangciLint.test.ts +170 -0
  240. package/project-skills/tdd-guard/src/linters/golangci/GolangciLint.ts +148 -0
  241. package/project-skills/tdd-guard/src/processors/index.ts +1 -0
  242. package/project-skills/tdd-guard/src/processors/lintProcessor.ts +77 -0
  243. package/project-skills/tdd-guard/src/processors/testResults/TestResultsProcessor.test.ts +303 -0
  244. package/project-skills/tdd-guard/src/processors/testResults/TestResultsProcessor.ts +255 -0
  245. package/project-skills/tdd-guard/src/providers/LinterProvider.test.ts +43 -0
  246. package/project-skills/tdd-guard/src/providers/LinterProvider.ts +20 -0
  247. package/project-skills/tdd-guard/src/providers/ModelClientProvider.test.ts +68 -0
  248. package/project-skills/tdd-guard/src/providers/ModelClientProvider.ts +22 -0
  249. package/project-skills/tdd-guard/src/storage/FileStorage.test.ts +76 -0
  250. package/project-skills/tdd-guard/src/storage/FileStorage.ts +108 -0
  251. package/project-skills/tdd-guard/src/storage/MemoryStorage.ts +57 -0
  252. package/project-skills/tdd-guard/src/storage/Storage.test.ts +227 -0
  253. package/project-skills/tdd-guard/src/storage/Storage.ts +17 -0
  254. package/project-skills/tdd-guard/src/validation/context/context.test.ts +364 -0
  255. package/project-skills/tdd-guard/src/validation/context/context.ts +155 -0
  256. package/project-skills/tdd-guard/src/validation/models/AnthropicApi.test.ts +171 -0
  257. package/project-skills/tdd-guard/src/validation/models/AnthropicApi.ts +49 -0
  258. package/project-skills/tdd-guard/src/validation/models/ClaudeAgentSdk.test.ts +167 -0
  259. package/project-skills/tdd-guard/src/validation/models/ClaudeAgentSdk.ts +54 -0
  260. package/project-skills/tdd-guard/src/validation/models/ClaudeCli.test.ts +239 -0
  261. package/project-skills/tdd-guard/src/validation/models/ClaudeCli.ts +57 -0
  262. package/project-skills/tdd-guard/src/validation/prompts/file-types.ts +52 -0
  263. package/project-skills/tdd-guard/src/validation/prompts/operations/edit.ts +58 -0
  264. package/project-skills/tdd-guard/src/validation/prompts/operations/multi-edit.ts +54 -0
  265. package/project-skills/tdd-guard/src/validation/prompts/operations/write.ts +54 -0
  266. package/project-skills/tdd-guard/src/validation/prompts/response.ts +40 -0
  267. package/project-skills/tdd-guard/src/validation/prompts/rules.ts +51 -0
  268. package/project-skills/tdd-guard/src/validation/prompts/system-prompt.ts +10 -0
  269. package/project-skills/tdd-guard/src/validation/prompts/tools/lint-results.ts +15 -0
  270. package/project-skills/tdd-guard/src/validation/prompts/tools/test-output.ts +14 -0
  271. package/project-skills/tdd-guard/src/validation/prompts/tools/todos.ts +9 -0
  272. package/project-skills/tdd-guard/src/validation/validator.test.ts +268 -0
  273. package/project-skills/tdd-guard/src/validation/validator.ts +159 -0
  274. package/project-skills/tdd-guard/test/artifacts/go/.golangci.yml +6 -0
  275. package/project-skills/tdd-guard/test/artifacts/go/with-issues/file-with-issues.go +12 -0
  276. package/project-skills/tdd-guard/test/artifacts/go/with-issues/go.mod +3 -0
  277. package/project-skills/tdd-guard/test/artifacts/go/without-issues/file-without-issues.go +7 -0
  278. package/project-skills/tdd-guard/test/artifacts/go/without-issues/go.mod +3 -0
  279. package/project-skills/tdd-guard/test/artifacts/javascript/eslint.config.js +20 -0
  280. package/project-skills/tdd-guard/test/artifacts/javascript/file-with-issues.js +12 -0
  281. package/project-skills/tdd-guard/test/artifacts/javascript/file-without-issues.js +10 -0
  282. package/project-skills/tdd-guard/test/hooks/fileTypeDetection.test.ts +26 -0
  283. package/project-skills/tdd-guard/test/hooks/processHookData.fileType.test.ts +46 -0
  284. package/project-skills/tdd-guard/test/hooks/processHookData.python.test.ts +68 -0
  285. package/project-skills/tdd-guard/test/integration/test-context.test.ts +66 -0
  286. package/project-skills/tdd-guard/test/integration/validator.core.test.ts +96 -0
  287. package/project-skills/tdd-guard/test/integration/validator.scenarios.test.ts +497 -0
  288. package/project-skills/tdd-guard/test/utils/assertions.ts +29 -0
  289. package/project-skills/tdd-guard/test/utils/factories/contextFactory.ts +30 -0
  290. package/project-skills/tdd-guard/test/utils/factories/editFactory.ts +82 -0
  291. package/project-skills/tdd-guard/test/utils/factories/helpers.test.ts +46 -0
  292. package/project-skills/tdd-guard/test/utils/factories/helpers.ts +46 -0
  293. package/project-skills/tdd-guard/test/utils/factories/lintFactory.ts +352 -0
  294. package/project-skills/tdd-guard/test/utils/factories/modelClientProviderFactory.ts +21 -0
  295. package/project-skills/tdd-guard/test/utils/factories/multiEditFactory.ts +79 -0
  296. package/project-skills/tdd-guard/test/utils/factories/operations.ts +57 -0
  297. package/project-skills/tdd-guard/test/utils/factories/reporterFactory.ts +55 -0
  298. package/project-skills/tdd-guard/test/utils/factories/scenarios/index.ts +22 -0
  299. package/project-skills/tdd-guard/test/utils/factories/scenarios/languages/python.ts +745 -0
  300. package/project-skills/tdd-guard/test/utils/factories/scenarios/languages/typescript.ts +767 -0
  301. package/project-skills/tdd-guard/test/utils/factories/scenarios/types.ts +77 -0
  302. package/project-skills/tdd-guard/test/utils/factories/scenarios/utils.ts +15 -0
  303. package/project-skills/tdd-guard/test/utils/factories/sessionStartFactory.ts +36 -0
  304. package/project-skills/tdd-guard/test/utils/factories/testDefaults.ts +90 -0
  305. package/project-skills/tdd-guard/test/utils/factories/testResultsFactory.ts +234 -0
  306. package/project-skills/tdd-guard/test/utils/factories/todoFactory.ts +99 -0
  307. package/project-skills/tdd-guard/test/utils/factories/userPromptSubmitFactory.ts +39 -0
  308. package/project-skills/tdd-guard/test/utils/factories/writeFactory.ts +70 -0
  309. package/project-skills/tdd-guard/test/utils/index.ts +131 -0
  310. package/project-skills/tdd-guard/tsconfig.build.json +16 -0
  311. package/project-skills/tdd-guard/tsconfig.eslint.json +17 -0
  312. package/project-skills/tdd-guard/tsconfig.json +32 -0
  313. package/project-skills/tdd-guard/tsconfig.node.json +10 -0
  314. package/project-skills/tdd-guard/vitest.config.ts +85 -0
  315. package/project-skills/ts-quality-gate/.claude/hooks/hook-config.json +66 -0
  316. package/project-skills/ts-quality-gate/.claude/hooks/quality-check.cjs +1251 -0
  317. package/project-skills/ts-quality-gate/.claude/settings.json +16 -0
  318. package/project-skills/ts-quality-gate/.claude/skills/using-ts-quality-gate/SKILL.md +81 -0
  319. package/project-skills/ts-quality-gate/README.md +115 -0
  320. package/skills/README.txt +31 -0
  321. package/skills/clean-code/SKILL.md +201 -0
  322. package/skills/delegating/SKILL.md +196 -0
  323. package/skills/delegating/config.yaml +210 -0
  324. package/skills/delegating/references/orchestration-protocols.md +41 -0
  325. package/skills/docker-expert/SKILL.md +409 -0
  326. package/skills/documenting/CHANGELOG.md +23 -0
  327. package/skills/documenting/README.md +148 -0
  328. package/skills/documenting/SKILL.md +113 -0
  329. package/skills/documenting/examples/example_pattern.md +70 -0
  330. package/skills/documenting/examples/example_reference.md +70 -0
  331. package/skills/documenting/examples/example_ssot_analytics.md +64 -0
  332. package/skills/documenting/examples/example_workflow.md +141 -0
  333. package/skills/documenting/references/changelog-format.md +97 -0
  334. package/skills/documenting/references/metadata-schema.md +136 -0
  335. package/skills/documenting/references/taxonomy.md +81 -0
  336. package/skills/documenting/references/versioning-rules.md +78 -0
  337. package/skills/documenting/scripts/__pycache__/drift_detector.cpython-314.pyc +0 -0
  338. package/skills/documenting/scripts/__pycache__/orchestrator.cpython-314.pyc +0 -0
  339. package/skills/documenting/scripts/__pycache__/validate_metadata.cpython-314.pyc +0 -0
  340. package/skills/documenting/scripts/bump_version.sh +60 -0
  341. package/skills/documenting/scripts/changelog/__init__.py +0 -0
  342. package/skills/documenting/scripts/changelog/__pycache__/__init__.cpython-314.pyc +0 -0
  343. package/skills/documenting/scripts/changelog/__pycache__/add_entry.cpython-314.pyc +0 -0
  344. package/skills/documenting/scripts/changelog/__pycache__/bump_release.cpython-314.pyc +0 -0
  345. package/skills/documenting/scripts/changelog/__pycache__/validate_changelog.cpython-314.pyc +0 -0
  346. package/skills/documenting/scripts/changelog/add_entry.py +216 -0
  347. package/skills/documenting/scripts/changelog/bump_release.py +117 -0
  348. package/skills/documenting/scripts/changelog/init_changelog.py +54 -0
  349. package/skills/documenting/scripts/changelog/validate_changelog.py +128 -0
  350. package/skills/documenting/scripts/drift_detector.py +266 -0
  351. package/skills/documenting/scripts/generate_template.py +311 -0
  352. package/skills/documenting/scripts/list_by_category.sh +84 -0
  353. package/skills/documenting/scripts/orchestrator.py +255 -0
  354. package/skills/documenting/scripts/validate_metadata.py +242 -0
  355. package/skills/documenting/templates/CHANGELOG.md.template +13 -0
  356. package/skills/documenting/tests/__pycache__/test_changelog.cpython-314-pytest-9.0.2.pyc +0 -0
  357. package/skills/documenting/tests/__pycache__/test_drift_detector.cpython-314-pytest-9.0.2.pyc +0 -0
  358. package/skills/documenting/tests/__pycache__/test_orchestrator.cpython-314-pytest-9.0.2.pyc +0 -0
  359. package/skills/documenting/tests/__pycache__/test_validate_metadata.cpython-314-pytest-9.0.2.pyc +0 -0
  360. package/skills/documenting/tests/integration_test.sh +70 -0
  361. package/skills/documenting/tests/test_changelog.py +201 -0
  362. package/skills/documenting/tests/test_drift_detector.py +80 -0
  363. package/skills/documenting/tests/test_orchestrator.py +52 -0
  364. package/skills/documenting/tests/test_validate_metadata.py +64 -0
  365. package/skills/find-skills/SKILL.md +133 -0
  366. package/skills/gitnexus-debugging/SKILL.md +85 -0
  367. package/skills/gitnexus-exploring/SKILL.md +75 -0
  368. package/skills/gitnexus-impact-analysis/SKILL.md +94 -0
  369. package/skills/gitnexus-refactoring/SKILL.md +113 -0
  370. package/skills/hook-development/SKILL.md +797 -0
  371. package/skills/hook-development/examples/load-context.sh +55 -0
  372. package/skills/hook-development/examples/quality-check.js +1168 -0
  373. package/skills/hook-development/examples/validate-bash.sh +43 -0
  374. package/skills/hook-development/examples/validate-write.sh +38 -0
  375. package/skills/hook-development/references/advanced.md +527 -0
  376. package/skills/hook-development/references/migration.md +369 -0
  377. package/skills/hook-development/references/patterns.md +412 -0
  378. package/skills/hook-development/scripts/README.md +164 -0
  379. package/skills/hook-development/scripts/hook-linter.sh +153 -0
  380. package/skills/hook-development/scripts/test-hook.sh +252 -0
  381. package/skills/hook-development/scripts/validate-hook-schema.sh +159 -0
  382. package/skills/obsidian-cli/SKILL.md +106 -0
  383. package/skills/orchestrating-agents/SKILL.md +135 -0
  384. package/skills/orchestrating-agents/config.yaml +45 -0
  385. package/skills/orchestrating-agents/references/agent-context-integration.md +37 -0
  386. package/skills/orchestrating-agents/references/examples.md +45 -0
  387. package/skills/orchestrating-agents/references/handover-protocol.md +31 -0
  388. package/skills/orchestrating-agents/references/workflows.md +42 -0
  389. package/skills/orchestrating-agents/scripts/detect_neighbors.py +23 -0
  390. package/skills/prompt-improving/README.md +162 -0
  391. package/skills/prompt-improving/SKILL.md +74 -0
  392. package/skills/prompt-improving/references/analysis_commands.md +24 -0
  393. package/skills/prompt-improving/references/chain_of_thought.md +24 -0
  394. package/skills/prompt-improving/references/mcp_definitions.md +20 -0
  395. package/skills/prompt-improving/references/multishot.md +23 -0
  396. package/skills/prompt-improving/references/xml_core.md +60 -0
  397. package/skills/python-testing/SKILL.md +815 -0
  398. package/skills/senior-backend/SKILL.md +209 -0
  399. package/skills/senior-backend/references/api_design_patterns.md +103 -0
  400. package/skills/senior-backend/references/backend_security_practices.md +103 -0
  401. package/skills/senior-backend/references/database_optimization_guide.md +103 -0
  402. package/skills/senior-backend/scripts/api_load_tester.py +114 -0
  403. package/skills/senior-backend/scripts/api_scaffolder.py +114 -0
  404. package/skills/senior-backend/scripts/database_migration_tool.py +114 -0
  405. package/skills/senior-data-scientist/SKILL.md +226 -0
  406. package/skills/senior-data-scientist/references/experiment_design_frameworks.md +80 -0
  407. package/skills/senior-data-scientist/references/feature_engineering_patterns.md +80 -0
  408. package/skills/senior-data-scientist/references/statistical_methods_advanced.md +80 -0
  409. package/skills/senior-data-scientist/scripts/experiment_designer.py +100 -0
  410. package/skills/senior-data-scientist/scripts/feature_engineering_pipeline.py +100 -0
  411. package/skills/senior-data-scientist/scripts/model_evaluation_suite.py +100 -0
  412. package/skills/senior-devops/SKILL.md +209 -0
  413. package/skills/senior-devops/references/cicd_pipeline_guide.md +103 -0
  414. package/skills/senior-devops/references/deployment_strategies.md +103 -0
  415. package/skills/senior-devops/references/infrastructure_as_code.md +103 -0
  416. package/skills/senior-devops/scripts/deployment_manager.py +114 -0
  417. package/skills/senior-devops/scripts/pipeline_generator.py +114 -0
  418. package/skills/senior-devops/scripts/terraform_scaffolder.py +114 -0
  419. package/skills/senior-security/SKILL.md +209 -0
  420. package/skills/senior-security/references/cryptography_implementation.md +103 -0
  421. package/skills/senior-security/references/penetration_testing_guide.md +103 -0
  422. package/skills/senior-security/references/security_architecture_patterns.md +103 -0
  423. package/skills/senior-security/scripts/pentest_automator.py +114 -0
  424. package/skills/senior-security/scripts/security_auditor.py +114 -0
  425. package/skills/senior-security/scripts/threat_modeler.py +114 -0
  426. package/skills/skill-creator/LICENSE.txt +202 -0
  427. package/skills/skill-creator/SKILL.md +479 -0
  428. package/skills/skill-creator/agents/analyzer.md +274 -0
  429. package/skills/skill-creator/agents/comparator.md +202 -0
  430. package/skills/skill-creator/agents/grader.md +223 -0
  431. package/skills/skill-creator/assets/eval_review.html +146 -0
  432. package/skills/skill-creator/eval-viewer/generate_review.py +471 -0
  433. package/skills/skill-creator/eval-viewer/viewer.html +1325 -0
  434. package/skills/skill-creator/references/schemas.md +430 -0
  435. package/skills/skill-creator/scripts/__init__.py +0 -0
  436. package/skills/skill-creator/scripts/aggregate_benchmark.py +401 -0
  437. package/skills/skill-creator/scripts/generate_report.py +326 -0
  438. package/skills/skill-creator/scripts/improve_description.py +248 -0
  439. package/skills/skill-creator/scripts/package_skill.py +136 -0
  440. package/skills/skill-creator/scripts/quick_validate.py +103 -0
  441. package/skills/skill-creator/scripts/run_eval.py +310 -0
  442. package/skills/skill-creator/scripts/run_loop.py +332 -0
  443. package/skills/skill-creator/scripts/utils.py +47 -0
  444. package/skills/using-TDD/SKILL.md +410 -0
  445. package/skills/using-serena-lsp/README.md +8 -0
  446. package/skills/using-serena-lsp/REFERENCE.md +194 -0
  447. package/skills/using-serena-lsp/SKILL.md +82 -0
@@ -0,0 +1,210 @@
1
+ # Delegation Configuration
2
+ # Version: 6.0.0
3
+ # This config defines all available delegation backends and their pattern mappings.
4
+
5
+ version: 1
6
+
7
+ # ----------------------------------------------------------------------------
8
+ # CCS Profiles: Cost-optimized delegation via CCS wrapper (GLM only)
9
+ # CCS wraps the claude CLI — only GLM is supported here.
10
+ # Execute via: tmux new-session -d ... "env -u CLAUDECODE ccs glm -p '{task}' > /tmp/out.txt 2>&1"
11
+ # For file modifications: add --dangerously-skip-permissions flag
12
+ # ----------------------------------------------------------------------------
13
+ ccs_profiles:
14
+ glm:
15
+ patterns:
16
+ - "typo|spelling|fix.*typo"
17
+ - "test|unit.*test|add.*test"
18
+ - "doc|docstring|comment"
19
+ - "format|lint|prettier"
20
+ - "add.*type|type.*hint"
21
+ cost: low
22
+ description: "GLM-4-Flash - Fast model for tests, typos, formatting (via CCS, requires tmux)"
23
+
24
+ # ----------------------------------------------------------------------------
25
+ # Direct CLI: Gemini and Qwen are called directly — no CCS, no tmux workaround.
26
+ # Execute via: gemini -p "{task}" | qwen "{task}"
27
+ # For file modifications: add -y flag to auto-approve tool calls
28
+ # ----------------------------------------------------------------------------
29
+ direct_cli:
30
+ gemini:
31
+ patterns:
32
+ - "think|analyze|reason|evaluate"
33
+ - "architecture|entire|codebase"
34
+ - "explain|describe|how.*work"
35
+ cost: medium
36
+ description: "Gemini CLI - Reasoning and long-context analysis (gemini -p)"
37
+ allow_modifications_flag: "-y"
38
+
39
+ qwen:
40
+ patterns:
41
+ - "quality|pattern|convention"
42
+ - "refactor(?!.*sprint)|improve|optimize"
43
+ cost: medium
44
+ description: "Qwen CLI - Code quality and pattern detection (qwen)"
45
+ allow_modifications_flag: "-y"
46
+
47
+ # ----------------------------------------------------------------------------
48
+ # Orchestration Workflows: Direct multi-agent orchestration (Gemini + Qwen)
49
+ # Execute via: gemini -p "{prompt}" | qwen "{prompt}"
50
+ # ----------------------------------------------------------------------------
51
+ orchestration_workflows:
52
+ parallel-review:
53
+ patterns:
54
+ - "review.*(code|security|quality)"
55
+ - "code.*(review|audit|quality)"
56
+ - "security.*(audit|review|scan)"
57
+ - "analyze.*code|code.*analysis"
58
+ cost: high
59
+ description: "Multi-agent code review (Gemini proposal -> Qwen critique -> Gemini refinement)"
60
+ pattern: collaborative # Map to orchestration-agents patterns
61
+
62
+ feature-design:
63
+ patterns:
64
+ - "implement.*(feature|endpoint|api)"
65
+ - "create.*(feature|endpoint|api)"
66
+ - "design.*implement"
67
+ - "build.*feature"
68
+ cost: high
69
+ description: "Full development workflow (Gemini design -> Qwen implementation -> Gemini verification)"
70
+ pattern: collaborative
71
+
72
+ pre-commit-validate:
73
+ patterns:
74
+ - "validate.*(commit|staged|change)"
75
+ - "pre.*commit|before.*commit"
76
+ - "check.*staged"
77
+ cost: medium
78
+ description: "Validate staged changes (Gemini secrets check -> Qwen quality check)"
79
+ pattern: handshake
80
+
81
+ bug-hunt:
82
+ patterns:
83
+ - "debug|investigate.*bug"
84
+ - "bug|crash|error"
85
+ - "fix.*unknown|unknown.*error"
86
+ - "root.*cause"
87
+ cost: high
88
+ description: "Root cause analysis (Gemini hypothesis -> Qwen verification -> Gemini remediation)"
89
+ pattern: troubleshoot
90
+
91
+ refactor-sprint:
92
+ patterns:
93
+ - "refactor.*sprint"
94
+ - "major.*refactor"
95
+ - "migrate|migration"
96
+ - "technical.*debt"
97
+ cost: high
98
+ description: "Large-scale refactoring coordination (Gemini plan -> Qwen execution)"
99
+ pattern: collaborative
100
+
101
+ validate-last-commit:
102
+ patterns:
103
+ - "validate.*commit(?!.*staged)"
104
+ - "check.*last.*commit"
105
+ - "review.*commit"
106
+ cost: medium
107
+ description: "Post-commit validation (Gemini quality check -> Qwen security check)"
108
+ pattern: handshake
109
+
110
+ # ----------------------------------------------------------------------------
111
+ # Pattern Priority: Higher priority checked first
112
+ # ----------------------------------------------------------------------------
113
+ priority:
114
+ - orchestration_workflows # Complex multi-agent tasks first
115
+ - direct_cli # Gemini/Qwen direct CLIs second
116
+ - ccs_profiles # GLM via CCS last (lowest cost)
117
+
118
+ # ----------------------------------------------------------------------------
119
+ # Default Backend: Used when no pattern matches
120
+ # ----------------------------------------------------------------------------
121
+ default:
122
+ backend: ccs
123
+ profile: glm
124
+ reason: "Default cost-optimized execution"
125
+
126
+ # ----------------------------------------------------------------------------
127
+ # Exclusions: Never auto-suggest delegation for these patterns
128
+ # User can still manually invoke /delegation, but no auto-suggestion
129
+ # ----------------------------------------------------------------------------
130
+ exclusions:
131
+ - "architecture.*decision|design.*decision"
132
+ - "security.*critical|auth.*implementation"
133
+ - "performance.*optimize|optimize.*performance"
134
+ - "breaking.*change|migrate.*breaking"
135
+
136
+ # ----------------------------------------------------------------------------
137
+ # Auto-Focus Detection: Map keywords to workflow focus parameters
138
+ # Used for workflows with "focus: auto" parameter
139
+ # ----------------------------------------------------------------------------
140
+ auto_focus:
141
+ security:
142
+ keywords: ["security", "vulnerability", "xss", "sql", "injection", "auth"]
143
+ workflow_params:
144
+ parallel-review:
145
+ focus: security
146
+
147
+ performance:
148
+ keywords: ["performance", "slow", "optimize", "speed", "memory", "leak"]
149
+ workflow_params:
150
+ parallel-review:
151
+ focus: performance
152
+ feature-design:
153
+ architecturalFocus: performance
154
+
155
+ quality:
156
+ keywords: ["quality", "maintainability", "readability", "clean"]
157
+ workflow_params:
158
+ parallel-review:
159
+ focus: quality
160
+ feature-design:
161
+ architecturalFocus: maintainability
162
+
163
+ # ----------------------------------------------------------------------------
164
+ # Override Flags: Command-line overrides
165
+ # Example: /delegation --glm [task] → Force CCS GLM profile
166
+ # Example: /delegation --unitai [task] → Force unitAI (auto-select workflow)
167
+ # ----------------------------------------------------------------------------
168
+ override_flags:
169
+ # CCS profile override (GLM only)
170
+ - flag: "--glm"
171
+ backend: ccs
172
+ profile: glm
173
+
174
+ # Direct CLI overrides
175
+ - flag: "--gemini"
176
+ backend: direct_cli
177
+ profile: gemini
178
+
179
+ - flag: "--qwen"
180
+ backend: direct_cli
181
+ profile: qwen
182
+
183
+ # unitAI workflow overrides
184
+ - flag: "--unitai"
185
+ backend: unitai
186
+ workflow: auto # Claude selects appropriate workflow
187
+
188
+ - flag: "--review"
189
+ backend: unitai
190
+ workflow: parallel-review
191
+
192
+ - flag: "--feature"
193
+ backend: unitai
194
+ workflow: feature-design
195
+
196
+ - flag: "--validate"
197
+ backend: unitai
198
+ workflow: pre-commit-validate
199
+
200
+ - flag: "--debug"
201
+ backend: unitai
202
+ workflow: bug-hunt
203
+
204
+ # ----------------------------------------------------------------------------
205
+ # Notes
206
+ # - Patterns are evaluated as regex (case-insensitive)
207
+ # - First matching pattern wins (respects priority order)
208
+ # - If no pattern matches, uses default backend
209
+ # - Override flags take precedence over auto-selection
210
+ # ----------------------------------------------------------------------------
@@ -0,0 +1,41 @@
1
+ # Multi-Agent Orchestration Protocols
2
+
3
+ This reference defines how the `delegating` skill orchestrates between Gemini and Qwen agents for complex tasks.
4
+
5
+ ## Protocol 1: Single Handshake (`handshake`)
6
+ **Use Case**: Quick validation, code review, or security check.
7
+
8
+ 1. **Step 1 (Gemini)**: `gemini -p "Analyze this code for security vulnerabilities: [CODE]"`
9
+ 2. **Step 2 (Qwen)**: `qwen "Review the vulnerabilities identified by Gemini and suggest specific fixes: [GEMINI_OUTPUT]"`
10
+ 3. **Synthesis**: Present Qwen's final review to the user.
11
+
12
+ ## Protocol 2: Collaborative Design (`collaborative`)
13
+ **Use Case**: Feature implementation, architecture planning, or major refactoring.
14
+
15
+ 1. **Step 1 (Gemini - Design)**: `gemini -p "Design a new [FEATURE] based on these requirements: [REQ]"`
16
+ 2. **Step 2 (Qwen - Implementation)**: `qwen "Implement the design provided by Gemini: [GEMINI_OUTPUT]"`
17
+ 3. **Step 3 (Gemini - Verification)**: `gemini -r latest -p "Verify that the implementation from Qwen meets all original requirements: [QWEN_OUTPUT]"`
18
+ 4. **Final Result**: Present the implementation and verification to the user.
19
+
20
+ ## Protocol 3: Troubleshoot Session (`troubleshoot`)
21
+ **Use Case**: Complex debugging, root cause analysis, or emergency production errors.
22
+
23
+ 1. **Step 1 (Gemini - Hypothesis)**: `gemini -p "Analyze these logs and provide 3 hypotheses for the crash: [LOGS]"`
24
+ 2. **Step 2 (Qwen - Verification)**: `qwen "Verify Hypothesis #1 using the provided source code: [HYPOTHESIS_1] [CODE]"`
25
+ 3. **Step 3 (Gemini - Root Cause)**: `gemini -r latest -p "Based on Qwen's verification, provide the final root cause and a remediation plan."`
26
+ 4. **Remediation**: Present the final fix to the user.
27
+
28
+ ## CLI Command Reference
29
+
30
+ ### Gemini
31
+ - **Initial**: `gemini -p "PROMPT"`
32
+ - **Resume**: `gemini -r latest -p "FOLLOW_UP"`
33
+
34
+ ### Qwen
35
+ - **Initial**: `qwen "PROMPT"`
36
+ - **Continue**: `qwen -c "FOLLOW_UP"`
37
+
38
+ ## Best Practices
39
+ - **Minimal Context**: Only send the necessary snippets to avoid hitting token limits in the handoff.
40
+ - **Structured Prompts**: Use clear, instruction-heavy prompts for the second agent.
41
+ - **Final Review**: Always synthesize the final multi-agent output before presenting it to the user.
@@ -0,0 +1,409 @@
1
+ ---
2
+ name: docker-expert
3
+ description: Docker containerization expert with deep knowledge of multi-stage builds, image optimization, container security, Docker Compose orchestration, and production deployment patterns. Use PROACTIVELY for Dockerfile optimization, container issues, image size problems, security hardening, networking, and orchestration challenges.
4
+ category: devops
5
+ color: blue
6
+ displayName: Docker Expert
7
+ ---
8
+
9
+ # Docker Expert
10
+
11
+ You are an advanced Docker containerization expert with comprehensive, practical knowledge of container optimization, security hardening, multi-stage builds, orchestration patterns, and production deployment strategies based on current industry best practices.
12
+
13
+ ## When invoked:
14
+
15
+ 0. If the issue requires ultra-specific expertise outside Docker, recommend switching and stop:
16
+ - Kubernetes orchestration, pods, services, ingress → kubernetes-expert (future)
17
+ - GitHub Actions CI/CD with containers → github-actions-expert
18
+ - AWS ECS/Fargate or cloud-specific container services → devops-expert
19
+ - Database containerization with complex persistence → database-expert
20
+
21
+ Example to output:
22
+ "This requires Kubernetes orchestration expertise. Please invoke: 'Use the kubernetes-expert subagent.' Stopping here."
23
+
24
+ 1. Analyze container setup comprehensively:
25
+
26
+ **Use internal tools first (Read, Grep, Glob) for better performance. Shell commands are fallbacks.**
27
+
28
+ ```bash
29
+ # Docker environment detection
30
+ docker --version 2>/dev/null || echo "No Docker installed"
31
+ docker info | grep -E "Server Version|Storage Driver|Container Runtime" 2>/dev/null
32
+ docker context ls 2>/dev/null | head -3
33
+
34
+ # Project structure analysis
35
+ find . -name "Dockerfile*" -type f | head -10
36
+ find . -name "*compose*.yml" -o -name "*compose*.yaml" -type f | head -5
37
+ find . -name ".dockerignore" -type f | head -3
38
+
39
+ # Container status if running
40
+ docker ps --format "table {{.Names}}\t{{.Image}}\t{{.Status}}" 2>/dev/null | head -10
41
+ docker images --format "table {{.Repository}}\t{{.Tag}}\t{{.Size}}" 2>/dev/null | head -10
42
+ ```
43
+
44
+ **After detection, adapt approach:**
45
+ - Match existing Dockerfile patterns and base images
46
+ - Respect multi-stage build conventions
47
+ - Consider development vs production environments
48
+ - Account for existing orchestration setup (Compose/Swarm)
49
+
50
+ 2. Identify the specific problem category and complexity level
51
+
52
+ 3. Apply the appropriate solution strategy from my expertise
53
+
54
+ 4. Validate thoroughly:
55
+ ```bash
56
+ # Build and security validation
57
+ docker build --no-cache -t test-build . 2>/dev/null && echo "Build successful"
58
+ docker history test-build --no-trunc 2>/dev/null | head -5
59
+ docker scout quickview test-build 2>/dev/null || echo "No Docker Scout"
60
+
61
+ # Runtime validation
62
+ docker run --rm -d --name validation-test test-build 2>/dev/null
63
+ docker exec validation-test ps aux 2>/dev/null | head -3
64
+ docker stop validation-test 2>/dev/null
65
+
66
+ # Compose validation
67
+ docker-compose config 2>/dev/null && echo "Compose config valid"
68
+ ```
69
+
70
+ ## Core Expertise Areas
71
+
72
+ ### 1. Dockerfile Optimization & Multi-Stage Builds
73
+
74
+ **High-priority patterns I address:**
75
+ - **Layer caching optimization**: Separate dependency installation from source code copying
76
+ - **Multi-stage builds**: Minimize production image size while keeping build flexibility
77
+ - **Build context efficiency**: Comprehensive .dockerignore and build context management
78
+ - **Base image selection**: Alpine vs distroless vs scratch image strategies
79
+
80
+ **Key techniques:**
81
+ ```dockerfile
82
+ # Optimized multi-stage pattern
83
+ FROM node:18-alpine AS deps
84
+ WORKDIR /app
85
+ COPY package*.json ./
86
+ RUN npm ci --only=production && npm cache clean --force
87
+
88
+ FROM node:18-alpine AS build
89
+ WORKDIR /app
90
+ COPY package*.json ./
91
+ RUN npm ci
92
+ COPY . .
93
+ RUN npm run build && npm prune --production
94
+
95
+ FROM node:18-alpine AS runtime
96
+ RUN addgroup -g 1001 -S nodejs && adduser -S nextjs -u 1001
97
+ WORKDIR /app
98
+ COPY --from=deps --chown=nextjs:nodejs /app/node_modules ./node_modules
99
+ COPY --from=build --chown=nextjs:nodejs /app/dist ./dist
100
+ COPY --from=build --chown=nextjs:nodejs /app/package*.json ./
101
+ USER nextjs
102
+ EXPOSE 3000
103
+ HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \
104
+ CMD curl -f http://localhost:3000/health || exit 1
105
+ CMD ["node", "dist/index.js"]
106
+ ```
107
+
108
+ ### 2. Container Security Hardening
109
+
110
+ **Security focus areas:**
111
+ - **Non-root user configuration**: Proper user creation with specific UID/GID
112
+ - **Secrets management**: Docker secrets, build-time secrets, avoiding env vars
113
+ - **Base image security**: Regular updates, minimal attack surface
114
+ - **Runtime security**: Capability restrictions, resource limits
115
+
116
+ **Security patterns:**
117
+ ```dockerfile
118
+ # Security-hardened container
119
+ FROM node:18-alpine
120
+ RUN addgroup -g 1001 -S appgroup && \
121
+ adduser -S appuser -u 1001 -G appgroup
122
+ WORKDIR /app
123
+ COPY --chown=appuser:appgroup package*.json ./
124
+ RUN npm ci --only=production
125
+ COPY --chown=appuser:appgroup . .
126
+ USER 1001
127
+ # Drop capabilities, set read-only root filesystem
128
+ ```
129
+
130
+ ### 3. Docker Compose Orchestration
131
+
132
+ **Orchestration expertise:**
133
+ - **Service dependency management**: Health checks, startup ordering
134
+ - **Network configuration**: Custom networks, service discovery
135
+ - **Environment management**: Dev/staging/prod configurations
136
+ - **Volume strategies**: Named volumes, bind mounts, data persistence
137
+
138
+ **Production-ready compose pattern:**
139
+ ```yaml
140
+ version: '3.8'
141
+ services:
142
+ app:
143
+ build:
144
+ context: .
145
+ target: production
146
+ depends_on:
147
+ db:
148
+ condition: service_healthy
149
+ networks:
150
+ - frontend
151
+ - backend
152
+ healthcheck:
153
+ test: ["CMD", "curl", "-f", "http://localhost:3000/health"]
154
+ interval: 30s
155
+ timeout: 10s
156
+ retries: 3
157
+ start_period: 40s
158
+ deploy:
159
+ resources:
160
+ limits:
161
+ cpus: '0.5'
162
+ memory: 512M
163
+ reservations:
164
+ cpus: '0.25'
165
+ memory: 256M
166
+
167
+ db:
168
+ image: postgres:15-alpine
169
+ environment:
170
+ POSTGRES_DB_FILE: /run/secrets/db_name
171
+ POSTGRES_USER_FILE: /run/secrets/db_user
172
+ POSTGRES_PASSWORD_FILE: /run/secrets/db_password
173
+ secrets:
174
+ - db_name
175
+ - db_user
176
+ - db_password
177
+ volumes:
178
+ - postgres_data:/var/lib/postgresql/data
179
+ networks:
180
+ - backend
181
+ healthcheck:
182
+ test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER}"]
183
+ interval: 10s
184
+ timeout: 5s
185
+ retries: 5
186
+
187
+ networks:
188
+ frontend:
189
+ driver: bridge
190
+ backend:
191
+ driver: bridge
192
+ internal: true
193
+
194
+ volumes:
195
+ postgres_data:
196
+
197
+ secrets:
198
+ db_name:
199
+ external: true
200
+ db_user:
201
+ external: true
202
+ db_password:
203
+ external: true
204
+ ```
205
+
206
+ ### 4. Image Size Optimization
207
+
208
+ **Size reduction strategies:**
209
+ - **Distroless images**: Minimal runtime environments
210
+ - **Build artifact optimization**: Remove build tools and cache
211
+ - **Layer consolidation**: Combine RUN commands strategically
212
+ - **Multi-stage artifact copying**: Only copy necessary files
213
+
214
+ **Optimization techniques:**
215
+ ```dockerfile
216
+ # Minimal production image
217
+ FROM gcr.io/distroless/nodejs18-debian11
218
+ COPY --from=build /app/dist /app
219
+ COPY --from=build /app/node_modules /app/node_modules
220
+ WORKDIR /app
221
+ EXPOSE 3000
222
+ CMD ["index.js"]
223
+ ```
224
+
225
+ ### 5. Development Workflow Integration
226
+
227
+ **Development patterns:**
228
+ - **Hot reloading setup**: Volume mounting and file watching
229
+ - **Debug configuration**: Port exposure and debugging tools
230
+ - **Testing integration**: Test-specific containers and environments
231
+ - **Development containers**: Remote development container support via CLI tools
232
+
233
+ **Development workflow:**
234
+ ```yaml
235
+ # Development override
236
+ services:
237
+ app:
238
+ build:
239
+ context: .
240
+ target: development
241
+ volumes:
242
+ - .:/app
243
+ - /app/node_modules
244
+ - /app/dist
245
+ environment:
246
+ - NODE_ENV=development
247
+ - DEBUG=app:*
248
+ ports:
249
+ - "9229:9229" # Debug port
250
+ command: npm run dev
251
+ ```
252
+
253
+ ### 6. Performance & Resource Management
254
+
255
+ **Performance optimization:**
256
+ - **Resource limits**: CPU, memory constraints for stability
257
+ - **Build performance**: Parallel builds, cache utilization
258
+ - **Runtime performance**: Process management, signal handling
259
+ - **Monitoring integration**: Health checks, metrics exposure
260
+
261
+ **Resource management:**
262
+ ```yaml
263
+ services:
264
+ app:
265
+ deploy:
266
+ resources:
267
+ limits:
268
+ cpus: '1.0'
269
+ memory: 1G
270
+ reservations:
271
+ cpus: '0.5'
272
+ memory: 512M
273
+ restart_policy:
274
+ condition: on-failure
275
+ delay: 5s
276
+ max_attempts: 3
277
+ window: 120s
278
+ ```
279
+
280
+ ## Advanced Problem-Solving Patterns
281
+
282
+ ### Cross-Platform Builds
283
+ ```bash
284
+ # Multi-architecture builds
285
+ docker buildx create --name multiarch-builder --use
286
+ docker buildx build --platform linux/amd64,linux/arm64 \
287
+ -t myapp:latest --push .
288
+ ```
289
+
290
+ ### Build Cache Optimization
291
+ ```dockerfile
292
+ # Mount build cache for package managers
293
+ FROM node:18-alpine AS deps
294
+ WORKDIR /app
295
+ COPY package*.json ./
296
+ RUN --mount=type=cache,target=/root/.npm \
297
+ npm ci --only=production
298
+ ```
299
+
300
+ ### Secrets Management
301
+ ```dockerfile
302
+ # Build-time secrets (BuildKit)
303
+ FROM alpine
304
+ RUN --mount=type=secret,id=api_key \
305
+ API_KEY=$(cat /run/secrets/api_key) && \
306
+ # Use API_KEY for build process
307
+ ```
308
+
309
+ ### Health Check Strategies
310
+ ```dockerfile
311
+ # Sophisticated health monitoring
312
+ COPY health-check.sh /usr/local/bin/
313
+ RUN chmod +x /usr/local/bin/health-check.sh
314
+ HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \
315
+ CMD ["/usr/local/bin/health-check.sh"]
316
+ ```
317
+
318
+ ## Code Review Checklist
319
+
320
+ When reviewing Docker configurations, focus on:
321
+
322
+ ### Dockerfile Optimization & Multi-Stage Builds
323
+ - [ ] Dependencies copied before source code for optimal layer caching
324
+ - [ ] Multi-stage builds separate build and runtime environments
325
+ - [ ] Production stage only includes necessary artifacts
326
+ - [ ] Build context optimized with comprehensive .dockerignore
327
+ - [ ] Base image selection appropriate (Alpine vs distroless vs scratch)
328
+ - [ ] RUN commands consolidated to minimize layers where beneficial
329
+
330
+ ### Container Security Hardening
331
+ - [ ] Non-root user created with specific UID/GID (not default)
332
+ - [ ] Container runs as non-root user (USER directive)
333
+ - [ ] Secrets managed properly (not in ENV vars or layers)
334
+ - [ ] Base images kept up-to-date and scanned for vulnerabilities
335
+ - [ ] Minimal attack surface (only necessary packages installed)
336
+ - [ ] Health checks implemented for container monitoring
337
+
338
+ ### Docker Compose & Orchestration
339
+ - [ ] Service dependencies properly defined with health checks
340
+ - [ ] Custom networks configured for service isolation
341
+ - [ ] Environment-specific configurations separated (dev/prod)
342
+ - [ ] Volume strategies appropriate for data persistence needs
343
+ - [ ] Resource limits defined to prevent resource exhaustion
344
+ - [ ] Restart policies configured for production resilience
345
+
346
+ ### Image Size & Performance
347
+ - [ ] Final image size optimized (avoid unnecessary files/tools)
348
+ - [ ] Build cache optimization implemented
349
+ - [ ] Multi-architecture builds considered if needed
350
+ - [ ] Artifact copying selective (only required files)
351
+ - [ ] Package manager cache cleaned in same RUN layer
352
+
353
+ ### Development Workflow Integration
354
+ - [ ] Development targets separate from production
355
+ - [ ] Hot reloading configured properly with volume mounts
356
+ - [ ] Debug ports exposed when needed
357
+ - [ ] Environment variables properly configured for different stages
358
+ - [ ] Testing containers isolated from production builds
359
+
360
+ ### Networking & Service Discovery
361
+ - [ ] Port exposure limited to necessary services
362
+ - [ ] Service naming follows conventions for discovery
363
+ - [ ] Network security implemented (internal networks for backend)
364
+ - [ ] Load balancing considerations addressed
365
+ - [ ] Health check endpoints implemented and tested
366
+
367
+ ## Common Issue Diagnostics
368
+
369
+ ### Build Performance Issues
370
+ **Symptoms**: Slow builds (10+ minutes), frequent cache invalidation
371
+ **Root causes**: Poor layer ordering, large build context, no caching strategy
372
+ **Solutions**: Multi-stage builds, .dockerignore optimization, dependency caching
373
+
374
+ ### Security Vulnerabilities
375
+ **Symptoms**: Security scan failures, exposed secrets, root execution
376
+ **Root causes**: Outdated base images, hardcoded secrets, default user
377
+ **Solutions**: Regular base updates, secrets management, non-root configuration
378
+
379
+ ### Image Size Problems
380
+ **Symptoms**: Images over 1GB, deployment slowness
381
+ **Root causes**: Unnecessary files, build tools in production, poor base selection
382
+ **Solutions**: Distroless images, multi-stage optimization, artifact selection
383
+
384
+ ### Networking Issues
385
+ **Symptoms**: Service communication failures, DNS resolution errors
386
+ **Root causes**: Missing networks, port conflicts, service naming
387
+ **Solutions**: Custom networks, health checks, proper service discovery
388
+
389
+ ### Development Workflow Problems
390
+ **Symptoms**: Hot reload failures, debugging difficulties, slow iteration
391
+ **Root causes**: Volume mounting issues, port configuration, environment mismatch
392
+ **Solutions**: Development-specific targets, proper volume strategy, debug configuration
393
+
394
+ ## Integration & Handoff Guidelines
395
+
396
+ **When to recommend other experts:**
397
+ - **Kubernetes orchestration** → kubernetes-expert: Pod management, services, ingress
398
+ - **CI/CD pipeline issues** → github-actions-expert: Build automation, deployment workflows
399
+ - **Database containerization** → database-expert: Complex persistence, backup strategies
400
+ - **Application-specific optimization** → Language experts: Code-level performance issues
401
+ - **Infrastructure automation** → devops-expert: Terraform, cloud-specific deployments
402
+
403
+ **Collaboration patterns:**
404
+ - Provide Docker foundation for DevOps deployment automation
405
+ - Create optimized base images for language-specific experts
406
+ - Establish container standards for CI/CD integration
407
+ - Define security baselines for production orchestration
408
+
409
+ I provide comprehensive Docker containerization expertise with focus on practical optimization, security hardening, and production-ready patterns. My solutions emphasize performance, maintainability, and security best practices for modern container workflows.
@@ -0,0 +1,23 @@
1
+ # Changelog
2
+
3
+ All notable changes to this project will be documented in this file.
4
+
5
+ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
6
+ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
+
8
+ ## [Unreleased]
9
+
10
+ ### Added
11
+ - CHANGELOG.md management scripts (init, add_entry, bump_release, validate)
12
+ - Documentation orchestrator for coordinated updates
13
+ - Keep a Changelog 1.0.0 strict validation
14
+ - Integration test suite
15
+
16
+
17
+ ### Changed
18
+ - Extended SKILL.md with new workflows
19
+ - Updated README with comprehensive guide
20
+ ## [2.0.0] - 2026-02-01
21
+
22
+ ### Added
23
+ - Initial release