agent-devkit 0.1.6 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (551) hide show
  1. package/README.md +13 -1
  2. package/package.json +1 -1
  3. package/runtime/README.md +53 -1
  4. package/runtime/agent +5 -0
  5. package/runtime/agents/README.md +26 -0
  6. package/runtime/agents/agent-devkit-agent-builder/AGENTS.md +24 -0
  7. package/runtime/agents/agent-devkit-agent-builder/README.md +37 -0
  8. package/runtime/agents/agent-devkit-agent-builder/agent.yaml +46 -0
  9. package/runtime/agents/agent-devkit-agent-builder/capabilities/plan-agent/capability.yaml +29 -0
  10. package/runtime/agents/agent-devkit-agent-builder/capabilities/plan-agent/decision-rules.md +7 -0
  11. package/runtime/agents/agent-devkit-agent-builder/capabilities/plan-agent/runner.py +33 -0
  12. package/runtime/agents/agent-devkit-agent-builder/capabilities/plan-agent/workflow.md +8 -0
  13. package/runtime/agents/agent-devkit-agent-builder/capabilities/scaffold-agent/capability.yaml +31 -0
  14. package/runtime/agents/agent-devkit-agent-builder/capabilities/scaffold-agent/decision-rules.md +9 -0
  15. package/runtime/agents/agent-devkit-agent-builder/capabilities/scaffold-agent/runner.py +39 -0
  16. package/runtime/agents/agent-devkit-agent-builder/capabilities/scaffold-agent/workflow.md +8 -0
  17. package/runtime/agents/agent-devkit-agent-builder/capabilities/validate-agent-contract/capability.yaml +28 -0
  18. package/runtime/agents/agent-devkit-agent-builder/capabilities/validate-agent-contract/decision-rules.md +6 -0
  19. package/runtime/agents/agent-devkit-agent-builder/capabilities/validate-agent-contract/runner.py +33 -0
  20. package/runtime/agents/agent-devkit-agent-builder/capabilities/validate-agent-contract/workflow.md +7 -0
  21. package/runtime/agents/agent-devkit-agent-builder/infra/integrations/agent-devkit/agent_builder_repository.py +527 -0
  22. package/runtime/agents/agent-devkit-agent-builder/knowledge/context.md +15 -0
  23. package/runtime/agents/agent-devkit-agent-builder/knowledge/policies.yaml +11 -0
  24. package/runtime/agents/agent-devkit-agent-builder/knowledge/system.md +11 -0
  25. package/runtime/agents/agent-devkit-agent-builder/templates/agent-plan-output.md +20 -0
  26. package/runtime/agents/agent-devkit-agent-builder/templates/scaffold-plan-output.md +13 -0
  27. package/runtime/agents/agent-devkit-agent-builder/templates/validation-report-output.md +13 -0
  28. package/runtime/agents/agent-devkit-agent-builder/tests/test_runners.py +188 -0
  29. package/runtime/agents/automation-architect/AGENTS.md +11 -0
  30. package/runtime/agents/automation-architect/README.md +27 -0
  31. package/runtime/agents/automation-architect/agent.yaml +57 -0
  32. package/runtime/agents/automation-architect/capabilities/classify-automation-request/capability.yaml +35 -0
  33. package/runtime/agents/automation-architect/capabilities/classify-automation-request/decision-rules.md +10 -0
  34. package/runtime/agents/automation-architect/capabilities/classify-automation-request/runner.py +37 -0
  35. package/runtime/agents/automation-architect/capabilities/classify-automation-request/workflow.md +7 -0
  36. package/runtime/agents/automation-architect/capabilities/delegate-automation-build/capability.yaml +34 -0
  37. package/runtime/agents/automation-architect/capabilities/delegate-automation-build/decision-rules.md +7 -0
  38. package/runtime/agents/automation-architect/capabilities/delegate-automation-build/runner.py +37 -0
  39. package/runtime/agents/automation-architect/capabilities/delegate-automation-build/workflow.md +6 -0
  40. package/runtime/agents/automation-architect/capabilities/plan-automation-solution/capability.yaml +35 -0
  41. package/runtime/agents/automation-architect/capabilities/plan-automation-solution/decision-rules.md +7 -0
  42. package/runtime/agents/automation-architect/capabilities/plan-automation-solution/runner.py +37 -0
  43. package/runtime/agents/automation-architect/capabilities/plan-automation-solution/workflow.md +7 -0
  44. package/runtime/agents/automation-architect/capabilities/review-automation-solution/capability.yaml +36 -0
  45. package/runtime/agents/automation-architect/capabilities/review-automation-solution/decision-rules.md +7 -0
  46. package/runtime/agents/automation-architect/capabilities/review-automation-solution/runner.py +39 -0
  47. package/runtime/agents/automation-architect/capabilities/review-automation-solution/workflow.md +7 -0
  48. package/runtime/agents/automation-architect/infra/integrations/automation-architecture/automation_architecture_repository.py +481 -0
  49. package/runtime/agents/automation-architect/knowledge/context.md +22 -0
  50. package/runtime/agents/automation-architect/knowledge/policies.yaml +20 -0
  51. package/runtime/agents/automation-architect/knowledge/system.md +8 -0
  52. package/runtime/agents/automation-architect/templates/automation-classification.md +6 -0
  53. package/runtime/agents/automation-architect/templates/automation-plan.md +5 -0
  54. package/runtime/agents/automation-architect/tests/test_runners.py +135 -0
  55. package/runtime/agents/aws-architecture-analyst/agent.yaml +17 -4
  56. package/runtime/agents/aws-cloudwatch-log-analyzer/agent.yaml +12 -2
  57. package/runtime/agents/aws-cloudwatch-log-analyzer/capabilities/analyze-service-error/capability.yaml +16 -0
  58. package/runtime/agents/aws-lambda-builder/AGENTS.md +27 -0
  59. package/runtime/agents/aws-lambda-builder/README.md +21 -0
  60. package/runtime/agents/aws-lambda-builder/agent.yaml +46 -0
  61. package/runtime/agents/aws-lambda-builder/capabilities/deploy-lambda-plan/capability.yaml +18 -0
  62. package/runtime/agents/aws-lambda-builder/capabilities/deploy-lambda-plan/decision-rules.md +6 -0
  63. package/runtime/agents/aws-lambda-builder/capabilities/deploy-lambda-plan/runner.py +33 -0
  64. package/runtime/agents/aws-lambda-builder/capabilities/deploy-lambda-plan/workflow.md +6 -0
  65. package/runtime/agents/aws-lambda-builder/capabilities/generate-lambda-project/capability.yaml +20 -0
  66. package/runtime/agents/aws-lambda-builder/capabilities/generate-lambda-project/decision-rules.md +6 -0
  67. package/runtime/agents/aws-lambda-builder/capabilities/generate-lambda-project/runner.py +39 -0
  68. package/runtime/agents/aws-lambda-builder/capabilities/generate-lambda-project/workflow.md +7 -0
  69. package/runtime/agents/aws-lambda-builder/capabilities/package-lambda/capability.yaml +22 -0
  70. package/runtime/agents/aws-lambda-builder/capabilities/package-lambda/decision-rules.md +6 -0
  71. package/runtime/agents/aws-lambda-builder/capabilities/package-lambda/runner.py +41 -0
  72. package/runtime/agents/aws-lambda-builder/capabilities/package-lambda/workflow.md +6 -0
  73. package/runtime/agents/aws-lambda-builder/capabilities/plan-lambda/capability.yaml +18 -0
  74. package/runtime/agents/aws-lambda-builder/capabilities/plan-lambda/decision-rules.md +7 -0
  75. package/runtime/agents/aws-lambda-builder/capabilities/plan-lambda/runner.py +33 -0
  76. package/runtime/agents/aws-lambda-builder/capabilities/plan-lambda/workflow.md +6 -0
  77. package/runtime/agents/aws-lambda-builder/capabilities/review-lambda-security/capability.yaml +18 -0
  78. package/runtime/agents/aws-lambda-builder/capabilities/review-lambda-security/decision-rules.md +7 -0
  79. package/runtime/agents/aws-lambda-builder/capabilities/review-lambda-security/runner.py +33 -0
  80. package/runtime/agents/aws-lambda-builder/capabilities/review-lambda-security/workflow.md +5 -0
  81. package/runtime/agents/aws-lambda-builder/infra/integrations/aws-lambda/aws_lambda_repository.py +688 -0
  82. package/runtime/agents/aws-lambda-builder/knowledge/context.md +12 -0
  83. package/runtime/agents/aws-lambda-builder/knowledge/policies.yaml +23 -0
  84. package/runtime/agents/aws-lambda-builder/knowledge/system.md +10 -0
  85. package/runtime/agents/aws-lambda-builder/templates/lambda-deploy-plan.md +3 -0
  86. package/runtime/agents/aws-lambda-builder/templates/lambda-package.md +3 -0
  87. package/runtime/agents/aws-lambda-builder/templates/lambda-plan.md +3 -0
  88. package/runtime/agents/aws-lambda-builder/templates/lambda-readme.md +3 -0
  89. package/runtime/agents/aws-lambda-builder/templates/lambda-security-review.md +3 -0
  90. package/runtime/agents/aws-lambda-builder/tests/test_runners.py +355 -0
  91. package/runtime/agents/aws-operations-operator/agent.yaml +18 -6
  92. package/runtime/agents/aws-security-governance-auditor/agent.yaml +17 -5
  93. package/runtime/agents/azure-devops-orchestrator/agent.yaml +15 -2
  94. package/runtime/agents/azure-devops-orchestrator/capabilities/read-card/capability.yaml +29 -0
  95. package/runtime/agents/bpo-analyser/agent.yaml +12 -2
  96. package/runtime/agents/bpo-analyser/knowledge/policies.yaml +2 -2
  97. package/runtime/agents/data-scientist-analyst/agent.yaml +16 -4
  98. package/runtime/agents/data-scientist-analyst/capabilities/generate-data-report/capability.yaml +1 -1
  99. package/runtime/agents/data-scientist-analyst/capabilities/generate-reconciliation-report/capability.yaml +1 -1
  100. package/runtime/agents/data-scientist-analyst/capabilities/run-data-pipeline/capability.yaml +1 -1
  101. package/runtime/agents/data-scientist-analyst/infra/integrations/agent-bridge/methods/analyze-sql-source.yaml +1 -1
  102. package/runtime/agents/data-scientist-analyst/knowledge/policies.yaml +4 -4
  103. package/runtime/agents/data-scientist-analyst/knowledge/system.md +1 -1
  104. package/runtime/agents/data-scientist-analyst/tests/test_runners.py +1 -1
  105. package/runtime/agents/database-change-operator/agent.yaml +12 -1
  106. package/runtime/agents/docker-container-builder/AGENTS.md +27 -0
  107. package/runtime/agents/docker-container-builder/README.md +21 -0
  108. package/runtime/agents/docker-container-builder/agent.yaml +52 -0
  109. package/runtime/agents/docker-container-builder/capabilities/analyze-containerization-target/capability.yaml +18 -0
  110. package/runtime/agents/docker-container-builder/capabilities/analyze-containerization-target/decision-rules.md +6 -0
  111. package/runtime/agents/docker-container-builder/capabilities/analyze-containerization-target/runner.py +32 -0
  112. package/runtime/agents/docker-container-builder/capabilities/analyze-containerization-target/workflow.md +6 -0
  113. package/runtime/agents/docker-container-builder/capabilities/generate-compose/capability.yaml +18 -0
  114. package/runtime/agents/docker-container-builder/capabilities/generate-compose/decision-rules.md +7 -0
  115. package/runtime/agents/docker-container-builder/capabilities/generate-compose/runner.py +32 -0
  116. package/runtime/agents/docker-container-builder/capabilities/generate-compose/workflow.md +6 -0
  117. package/runtime/agents/docker-container-builder/capabilities/generate-container-project-files/capability.yaml +20 -0
  118. package/runtime/agents/docker-container-builder/capabilities/generate-container-project-files/decision-rules.md +7 -0
  119. package/runtime/agents/docker-container-builder/capabilities/generate-container-project-files/runner.py +38 -0
  120. package/runtime/agents/docker-container-builder/capabilities/generate-container-project-files/workflow.md +7 -0
  121. package/runtime/agents/docker-container-builder/capabilities/generate-dockerfile/capability.yaml +18 -0
  122. package/runtime/agents/docker-container-builder/capabilities/generate-dockerfile/decision-rules.md +6 -0
  123. package/runtime/agents/docker-container-builder/capabilities/generate-dockerfile/runner.py +32 -0
  124. package/runtime/agents/docker-container-builder/capabilities/generate-dockerfile/workflow.md +7 -0
  125. package/runtime/agents/docker-container-builder/capabilities/plan-image-build/capability.yaml +18 -0
  126. package/runtime/agents/docker-container-builder/capabilities/plan-image-build/decision-rules.md +6 -0
  127. package/runtime/agents/docker-container-builder/capabilities/plan-image-build/runner.py +32 -0
  128. package/runtime/agents/docker-container-builder/capabilities/plan-image-build/workflow.md +6 -0
  129. package/runtime/agents/docker-container-builder/capabilities/review-docker-security/capability.yaml +21 -0
  130. package/runtime/agents/docker-container-builder/capabilities/review-docker-security/decision-rules.md +6 -0
  131. package/runtime/agents/docker-container-builder/capabilities/review-docker-security/runner.py +43 -0
  132. package/runtime/agents/docker-container-builder/capabilities/review-docker-security/workflow.md +5 -0
  133. package/runtime/agents/docker-container-builder/infra/integrations/docker-container/docker_container_repository.py +837 -0
  134. package/runtime/agents/docker-container-builder/knowledge/context.md +21 -0
  135. package/runtime/agents/docker-container-builder/knowledge/policies.yaml +13 -0
  136. package/runtime/agents/docker-container-builder/knowledge/system.md +21 -0
  137. package/runtime/agents/docker-container-builder/templates/container-plan.md +4 -0
  138. package/runtime/agents/docker-container-builder/templates/container-review.md +4 -0
  139. package/runtime/agents/docker-container-builder/templates/docker-compose.md +5 -0
  140. package/runtime/agents/docker-container-builder/templates/docker-readme.md +3 -0
  141. package/runtime/agents/docker-container-builder/templates/dockerfile.md +5 -0
  142. package/runtime/agents/docker-container-builder/tests/test_runners.py +255 -0
  143. package/runtime/agents/drawio-diagram-builder/agent.yaml +11 -2
  144. package/runtime/agents/drawio-diagram-builder/capabilities/execute-diagram-delivery/capability.yaml +1 -1
  145. package/runtime/agents/drawio-diagram-builder/capabilities/read-azure-card-context/capability.yaml +1 -1
  146. package/runtime/agents/elasticsearch-log-analyzer/agent.yaml +14 -2
  147. package/runtime/agents/elasticsearch-log-analyzer/capabilities/analyze-service-errors/capability.yaml +14 -0
  148. package/runtime/agents/excel-workbook-builder/agent.yaml +10 -0
  149. package/runtime/agents/excel-workbook-builder/capabilities/create-template/capability.yaml +1 -1
  150. package/runtime/agents/excel-workbook-builder/capabilities/create-template/workflow.md +1 -1
  151. package/runtime/agents/excel-workbook-builder/capabilities/create-template-version/capability.yaml +1 -1
  152. package/runtime/agents/excel-workbook-builder/capabilities/generate-template-input-file/capability.yaml +1 -2
  153. package/runtime/agents/excel-workbook-builder/capabilities/refine-template/capability.yaml +1 -1
  154. package/runtime/agents/excel-workbook-builder/capabilities/register-template/capability.yaml +1 -2
  155. package/runtime/agents/excel-workbook-builder/capabilities/register-template/workflow.md +1 -1
  156. package/runtime/agents/execution-loop-builder/AGENTS.md +24 -0
  157. package/runtime/agents/execution-loop-builder/README.md +19 -0
  158. package/runtime/agents/execution-loop-builder/agent.yaml +49 -0
  159. package/runtime/agents/execution-loop-builder/capabilities/generate-loop-project-files/capability.yaml +20 -0
  160. package/runtime/agents/execution-loop-builder/capabilities/generate-loop-project-files/decision-rules.md +6 -0
  161. package/runtime/agents/execution-loop-builder/capabilities/generate-loop-project-files/runner.py +38 -0
  162. package/runtime/agents/execution-loop-builder/capabilities/generate-loop-project-files/workflow.md +7 -0
  163. package/runtime/agents/execution-loop-builder/capabilities/generate-loop-runner/capability.yaml +18 -0
  164. package/runtime/agents/execution-loop-builder/capabilities/generate-loop-runner/decision-rules.md +5 -0
  165. package/runtime/agents/execution-loop-builder/capabilities/generate-loop-runner/runner.py +32 -0
  166. package/runtime/agents/execution-loop-builder/capabilities/generate-loop-runner/workflow.md +6 -0
  167. package/runtime/agents/execution-loop-builder/capabilities/plan-execution-loop/capability.yaml +18 -0
  168. package/runtime/agents/execution-loop-builder/capabilities/plan-execution-loop/decision-rules.md +6 -0
  169. package/runtime/agents/execution-loop-builder/capabilities/plan-execution-loop/runner.py +32 -0
  170. package/runtime/agents/execution-loop-builder/capabilities/plan-execution-loop/workflow.md +6 -0
  171. package/runtime/agents/execution-loop-builder/capabilities/register-loop-task/capability.yaml +19 -0
  172. package/runtime/agents/execution-loop-builder/capabilities/register-loop-task/decision-rules.md +6 -0
  173. package/runtime/agents/execution-loop-builder/capabilities/register-loop-task/runner.py +36 -0
  174. package/runtime/agents/execution-loop-builder/capabilities/register-loop-task/workflow.md +6 -0
  175. package/runtime/agents/execution-loop-builder/capabilities/review-loop-safety/capability.yaml +19 -0
  176. package/runtime/agents/execution-loop-builder/capabilities/review-loop-safety/decision-rules.md +6 -0
  177. package/runtime/agents/execution-loop-builder/capabilities/review-loop-safety/runner.py +39 -0
  178. package/runtime/agents/execution-loop-builder/capabilities/review-loop-safety/workflow.md +5 -0
  179. package/runtime/agents/execution-loop-builder/infra/integrations/execution-loop/execution_loop_repository.py +608 -0
  180. package/runtime/agents/execution-loop-builder/knowledge/context.md +26 -0
  181. package/runtime/agents/execution-loop-builder/knowledge/policies.yaml +13 -0
  182. package/runtime/agents/execution-loop-builder/knowledge/system.md +19 -0
  183. package/runtime/agents/execution-loop-builder/templates/loop-plan.md +3 -0
  184. package/runtime/agents/execution-loop-builder/templates/loop-readme.md +3 -0
  185. package/runtime/agents/execution-loop-builder/templates/loop-review.md +3 -0
  186. package/runtime/agents/execution-loop-builder/templates/loop-runner.py +2 -0
  187. package/runtime/agents/execution-loop-builder/tests/test_runners.py +274 -0
  188. package/runtime/agents/execution-reviewer/agent.yaml +6 -4
  189. package/runtime/agents/execution-reviewer/capabilities/review-agent-result/capability.yaml +1 -2
  190. package/runtime/agents/execution-reviewer/capabilities/review-final-output/capability.yaml +1 -2
  191. package/runtime/agents/execution-reviewer/capabilities/review-plan/capability.yaml +1 -2
  192. package/runtime/agents/figma-ui-ux-product-designer/agent.yaml +17 -5
  193. package/runtime/agents/figma-ui-ux-product-designer/capabilities/analyze-product-context/capability.yaml +1 -1
  194. package/runtime/agents/figma-ui-ux-product-designer/capabilities/conduct-design-interview/capability.yaml +1 -1
  195. package/runtime/agents/figma-ui-ux-product-designer/capabilities/conduct-design-review-session/capability.yaml +1 -1
  196. package/runtime/agents/figma-ui-ux-product-designer/capabilities/generate-dev-handoff/capability.yaml +1 -1
  197. package/runtime/agents/figma-ui-ux-product-designer/capabilities/generate-user-journey-diagram/capability.yaml +1 -1
  198. package/runtime/agents/figma-ui-ux-product-designer/capabilities/ingest-design-source/capability.yaml +1 -1
  199. package/runtime/agents/figma-ui-ux-product-designer/capabilities/triage-design-feedback/capability.yaml +1 -1
  200. package/runtime/agents/generic-agent-builder/AGENTS.md +20 -0
  201. package/runtime/agents/generic-agent-builder/README.md +40 -0
  202. package/runtime/agents/generic-agent-builder/agent.yaml +43 -0
  203. package/runtime/agents/generic-agent-builder/capabilities/generate-agent-instructions/capability.yaml +18 -0
  204. package/runtime/agents/generic-agent-builder/capabilities/generate-agent-instructions/decision-rules.md +5 -0
  205. package/runtime/agents/generic-agent-builder/capabilities/generate-agent-instructions/runner.py +33 -0
  206. package/runtime/agents/generic-agent-builder/capabilities/generate-agent-instructions/workflow.md +6 -0
  207. package/runtime/agents/generic-agent-builder/capabilities/generate-project-agent-files/capability.yaml +20 -0
  208. package/runtime/agents/generic-agent-builder/capabilities/generate-project-agent-files/decision-rules.md +6 -0
  209. package/runtime/agents/generic-agent-builder/capabilities/generate-project-agent-files/runner.py +39 -0
  210. package/runtime/agents/generic-agent-builder/capabilities/generate-project-agent-files/workflow.md +7 -0
  211. package/runtime/agents/generic-agent-builder/capabilities/generate-skill/capability.yaml +18 -0
  212. package/runtime/agents/generic-agent-builder/capabilities/generate-skill/decision-rules.md +5 -0
  213. package/runtime/agents/generic-agent-builder/capabilities/generate-skill/runner.py +33 -0
  214. package/runtime/agents/generic-agent-builder/capabilities/generate-skill/workflow.md +5 -0
  215. package/runtime/agents/generic-agent-builder/capabilities/plan-generic-agent/capability.yaml +18 -0
  216. package/runtime/agents/generic-agent-builder/capabilities/plan-generic-agent/decision-rules.md +6 -0
  217. package/runtime/agents/generic-agent-builder/capabilities/plan-generic-agent/runner.py +33 -0
  218. package/runtime/agents/generic-agent-builder/capabilities/plan-generic-agent/workflow.md +6 -0
  219. package/runtime/agents/generic-agent-builder/capabilities/review-generic-agent/capability.yaml +20 -0
  220. package/runtime/agents/generic-agent-builder/capabilities/review-generic-agent/decision-rules.md +6 -0
  221. package/runtime/agents/generic-agent-builder/capabilities/review-generic-agent/runner.py +40 -0
  222. package/runtime/agents/generic-agent-builder/capabilities/review-generic-agent/workflow.md +7 -0
  223. package/runtime/agents/generic-agent-builder/infra/integrations/generic-agent/generic_agent_repository.py +445 -0
  224. package/runtime/agents/generic-agent-builder/knowledge/context.md +11 -0
  225. package/runtime/agents/generic-agent-builder/knowledge/policies.yaml +12 -0
  226. package/runtime/agents/generic-agent-builder/knowledge/system.md +17 -0
  227. package/runtime/agents/generic-agent-builder/templates/generic-agent-instructions.md +17 -0
  228. package/runtime/agents/generic-agent-builder/templates/generic-review-report.md +13 -0
  229. package/runtime/agents/generic-agent-builder/templates/generic-skill.md +14 -0
  230. package/runtime/agents/generic-agent-builder/tests/test_runners.py +220 -0
  231. package/runtime/agents/github-pr-reviewer/agent.yaml +17 -5
  232. package/runtime/agents/github-pr-reviewer/capabilities/create-review-automation/capability.yaml +1 -1
  233. package/runtime/agents/github-pr-reviewer/capabilities/inspect-pr/capability.yaml +1 -1
  234. package/runtime/agents/github-pr-reviewer/capabilities/list-review-requests/capability.yaml +1 -1
  235. package/runtime/agents/github-pr-reviewer/capabilities/review-pr-diff/capability.yaml +1 -1
  236. package/runtime/agents/knowledge-generator/agent.yaml +13 -3
  237. package/runtime/agents/knowledge-generator/capabilities/generate-knowledge/capability.yaml +1 -1
  238. package/runtime/agents/local-llm-operator/agent.yaml +6 -4
  239. package/runtime/agents/local-llm-operator/capabilities/delegate-operational-task/capability.yaml +1 -2
  240. package/runtime/agents/local-llm-operator/capabilities/inspect-local-models/capability.yaml +1 -2
  241. package/runtime/agents/local-llm-operator/capabilities/select-local-worker/capability.yaml +1 -2
  242. package/runtime/agents/n1-support-agent/agent.yaml +40 -1
  243. package/runtime/agents/n2-support-agent/agent.yaml +41 -2
  244. package/runtime/agents/n2-support-agent/knowledge/policies.yaml +2 -2
  245. package/runtime/agents/notification-operator/AGENTS.md +11 -0
  246. package/runtime/agents/notification-operator/README.md +15 -0
  247. package/runtime/agents/notification-operator/agent.yaml +43 -0
  248. package/runtime/agents/notification-operator/capabilities/configure-notification-channel/capability.yaml +19 -0
  249. package/runtime/agents/notification-operator/capabilities/configure-notification-channel/decision-rules.md +6 -0
  250. package/runtime/agents/notification-operator/capabilities/configure-notification-channel/runner.py +33 -0
  251. package/runtime/agents/notification-operator/capabilities/configure-notification-channel/workflow.md +6 -0
  252. package/runtime/agents/notification-operator/capabilities/format-task-completion-notification/capability.yaml +25 -0
  253. package/runtime/agents/notification-operator/capabilities/format-task-completion-notification/decision-rules.md +7 -0
  254. package/runtime/agents/notification-operator/capabilities/format-task-completion-notification/runner.py +49 -0
  255. package/runtime/agents/notification-operator/capabilities/format-task-completion-notification/workflow.md +6 -0
  256. package/runtime/agents/notification-operator/capabilities/send-task-completion-notification/capability.yaml +27 -0
  257. package/runtime/agents/notification-operator/capabilities/send-task-completion-notification/decision-rules.md +6 -0
  258. package/runtime/agents/notification-operator/capabilities/send-task-completion-notification/runner.py +68 -0
  259. package/runtime/agents/notification-operator/capabilities/send-task-completion-notification/workflow.md +7 -0
  260. package/runtime/agents/notification-operator/infra/README.md +6 -0
  261. package/runtime/agents/notification-operator/knowledge/context.md +10 -0
  262. package/runtime/agents/notification-operator/knowledge/policies.yaml +9 -0
  263. package/runtime/agents/notification-operator/knowledge/system.md +7 -0
  264. package/runtime/agents/notification-operator/templates/README.md +6 -0
  265. package/runtime/agents/notification-operator/tests/test_runners.py +108 -0
  266. package/runtime/agents/playwright-automation-builder/AGENTS.md +23 -0
  267. package/runtime/agents/playwright-automation-builder/README.md +43 -0
  268. package/runtime/agents/playwright-automation-builder/agent.yaml +48 -0
  269. package/runtime/agents/playwright-automation-builder/capabilities/generate-playwright-project-files/capability.yaml +20 -0
  270. package/runtime/agents/playwright-automation-builder/capabilities/generate-playwright-project-files/decision-rules.md +6 -0
  271. package/runtime/agents/playwright-automation-builder/capabilities/generate-playwright-project-files/runner.py +38 -0
  272. package/runtime/agents/playwright-automation-builder/capabilities/generate-playwright-project-files/workflow.md +6 -0
  273. package/runtime/agents/playwright-automation-builder/capabilities/generate-playwright-script/capability.yaml +18 -0
  274. package/runtime/agents/playwright-automation-builder/capabilities/generate-playwright-script/decision-rules.md +6 -0
  275. package/runtime/agents/playwright-automation-builder/capabilities/generate-playwright-script/runner.py +32 -0
  276. package/runtime/agents/playwright-automation-builder/capabilities/generate-playwright-script/workflow.md +6 -0
  277. package/runtime/agents/playwright-automation-builder/capabilities/plan-playwright-automation/capability.yaml +18 -0
  278. package/runtime/agents/playwright-automation-builder/capabilities/plan-playwright-automation/decision-rules.md +6 -0
  279. package/runtime/agents/playwright-automation-builder/capabilities/plan-playwright-automation/runner.py +32 -0
  280. package/runtime/agents/playwright-automation-builder/capabilities/plan-playwright-automation/workflow.md +6 -0
  281. package/runtime/agents/playwright-automation-builder/capabilities/review-playwright-artifacts/capability.yaml +19 -0
  282. package/runtime/agents/playwright-automation-builder/capabilities/review-playwright-artifacts/decision-rules.md +6 -0
  283. package/runtime/agents/playwright-automation-builder/capabilities/review-playwright-artifacts/runner.py +33 -0
  284. package/runtime/agents/playwright-automation-builder/capabilities/review-playwright-artifacts/workflow.md +6 -0
  285. package/runtime/agents/playwright-automation-builder/capabilities/run-playwright-check/capability.yaml +22 -0
  286. package/runtime/agents/playwright-automation-builder/capabilities/run-playwright-check/decision-rules.md +6 -0
  287. package/runtime/agents/playwright-automation-builder/capabilities/run-playwright-check/runner.py +40 -0
  288. package/runtime/agents/playwright-automation-builder/capabilities/run-playwright-check/workflow.md +6 -0
  289. package/runtime/agents/playwright-automation-builder/capabilities/wrap-playwright-as-capability/capability.yaml +22 -0
  290. package/runtime/agents/playwright-automation-builder/capabilities/wrap-playwright-as-capability/decision-rules.md +6 -0
  291. package/runtime/agents/playwright-automation-builder/capabilities/wrap-playwright-as-capability/runner.py +42 -0
  292. package/runtime/agents/playwright-automation-builder/capabilities/wrap-playwright-as-capability/workflow.md +6 -0
  293. package/runtime/agents/playwright-automation-builder/infra/integrations/playwright-automation/playwright_automation_repository.py +865 -0
  294. package/runtime/agents/playwright-automation-builder/knowledge/context.md +19 -0
  295. package/runtime/agents/playwright-automation-builder/knowledge/policies.yaml +25 -0
  296. package/runtime/agents/playwright-automation-builder/knowledge/system.md +19 -0
  297. package/runtime/agents/playwright-automation-builder/templates/capability-wrapper.md +4 -0
  298. package/runtime/agents/playwright-automation-builder/templates/playwright-automation.py +12 -0
  299. package/runtime/agents/playwright-automation-builder/templates/playwright-readme.md +13 -0
  300. package/runtime/agents/playwright-automation-builder/templates/playwright-review-report.md +9 -0
  301. package/runtime/agents/playwright-automation-builder/templates/playwright-test.py +2 -0
  302. package/runtime/agents/playwright-automation-builder/tests/test_runners.py +261 -0
  303. package/runtime/agents/postgres-data-analyzer/agent.yaml +13 -2
  304. package/runtime/agents/presentation-deck-builder/agent.yaml +14 -3
  305. package/runtime/agents/presentation-deck-builder/capabilities/create-template/capability.yaml +1 -1
  306. package/runtime/agents/presentation-deck-builder/capabilities/create-template-version/capability.yaml +1 -1
  307. package/runtime/agents/presentation-deck-builder/capabilities/generate-template-input-file/capability.yaml +1 -1
  308. package/runtime/agents/presentation-deck-builder/capabilities/refine-template/capability.yaml +1 -1
  309. package/runtime/agents/presentation-deck-builder/capabilities/register-template/capability.yaml +1 -1
  310. package/runtime/agents/presentation-deck-builder/knowledge/prompts/create-template.md +1 -1
  311. package/runtime/agents/presentation-deck-builder/knowledge/prompts/generate-template-input-file.md +1 -1
  312. package/runtime/agents/provider-configurator/agent.yaml +6 -4
  313. package/runtime/agents/provider-configurator/capabilities/collect-provider-credentials/capability.yaml +1 -2
  314. package/runtime/agents/provider-configurator/capabilities/configure-provider-source/capability.yaml +1 -2
  315. package/runtime/agents/provider-configurator/capabilities/validate-provider-readiness/capability.yaml +1 -2
  316. package/runtime/agents/pyautogui-automation-builder/AGENTS.md +32 -0
  317. package/runtime/agents/pyautogui-automation-builder/README.md +44 -0
  318. package/runtime/agents/pyautogui-automation-builder/agent.yaml +45 -0
  319. package/runtime/agents/pyautogui-automation-builder/capabilities/generate-pyautogui-project-files/capability.yaml +20 -0
  320. package/runtime/agents/pyautogui-automation-builder/capabilities/generate-pyautogui-project-files/decision-rules.md +6 -0
  321. package/runtime/agents/pyautogui-automation-builder/capabilities/generate-pyautogui-project-files/runner.py +39 -0
  322. package/runtime/agents/pyautogui-automation-builder/capabilities/generate-pyautogui-project-files/workflow.md +7 -0
  323. package/runtime/agents/pyautogui-automation-builder/capabilities/generate-pyautogui-script/capability.yaml +18 -0
  324. package/runtime/agents/pyautogui-automation-builder/capabilities/generate-pyautogui-script/decision-rules.md +7 -0
  325. package/runtime/agents/pyautogui-automation-builder/capabilities/generate-pyautogui-script/runner.py +33 -0
  326. package/runtime/agents/pyautogui-automation-builder/capabilities/generate-pyautogui-script/workflow.md +7 -0
  327. package/runtime/agents/pyautogui-automation-builder/capabilities/plan-desktop-automation/capability.yaml +18 -0
  328. package/runtime/agents/pyautogui-automation-builder/capabilities/plan-desktop-automation/decision-rules.md +8 -0
  329. package/runtime/agents/pyautogui-automation-builder/capabilities/plan-desktop-automation/runner.py +33 -0
  330. package/runtime/agents/pyautogui-automation-builder/capabilities/plan-desktop-automation/workflow.md +9 -0
  331. package/runtime/agents/pyautogui-automation-builder/capabilities/review-pyautogui-script/capability.yaml +20 -0
  332. package/runtime/agents/pyautogui-automation-builder/capabilities/review-pyautogui-script/decision-rules.md +8 -0
  333. package/runtime/agents/pyautogui-automation-builder/capabilities/review-pyautogui-script/runner.py +43 -0
  334. package/runtime/agents/pyautogui-automation-builder/capabilities/review-pyautogui-script/workflow.md +7 -0
  335. package/runtime/agents/pyautogui-automation-builder/capabilities/wrap-pyautogui-as-capability/capability.yaml +22 -0
  336. package/runtime/agents/pyautogui-automation-builder/capabilities/wrap-pyautogui-as-capability/decision-rules.md +6 -0
  337. package/runtime/agents/pyautogui-automation-builder/capabilities/wrap-pyautogui-as-capability/runner.py +43 -0
  338. package/runtime/agents/pyautogui-automation-builder/capabilities/wrap-pyautogui-as-capability/workflow.md +7 -0
  339. package/runtime/agents/pyautogui-automation-builder/infra/integrations/pyautogui-automation/pyautogui_automation_repository.py +856 -0
  340. package/runtime/agents/pyautogui-automation-builder/knowledge/context.md +17 -0
  341. package/runtime/agents/pyautogui-automation-builder/knowledge/policies.yaml +24 -0
  342. package/runtime/agents/pyautogui-automation-builder/knowledge/system.md +13 -0
  343. package/runtime/agents/pyautogui-automation-builder/templates/capability-wrapper.md +3 -0
  344. package/runtime/agents/pyautogui-automation-builder/templates/pyautogui-automation.py +12 -0
  345. package/runtime/agents/pyautogui-automation-builder/templates/pyautogui-readme.md +3 -0
  346. package/runtime/agents/pyautogui-automation-builder/templates/pyautogui-review-report.md +3 -0
  347. package/runtime/agents/pyautogui-automation-builder/templates/pyautogui-test.py +2 -0
  348. package/runtime/agents/pyautogui-automation-builder/tests/test_runners.py +376 -0
  349. package/runtime/agents/python-automation-builder/AGENTS.md +25 -0
  350. package/runtime/agents/python-automation-builder/README.md +43 -0
  351. package/runtime/agents/python-automation-builder/agent.yaml +45 -0
  352. package/runtime/agents/python-automation-builder/capabilities/generate-automation-project-files/capability.yaml +20 -0
  353. package/runtime/agents/python-automation-builder/capabilities/generate-automation-project-files/decision-rules.md +6 -0
  354. package/runtime/agents/python-automation-builder/capabilities/generate-automation-project-files/runner.py +39 -0
  355. package/runtime/agents/python-automation-builder/capabilities/generate-automation-project-files/workflow.md +7 -0
  356. package/runtime/agents/python-automation-builder/capabilities/generate-python-automation/capability.yaml +18 -0
  357. package/runtime/agents/python-automation-builder/capabilities/generate-python-automation/decision-rules.md +5 -0
  358. package/runtime/agents/python-automation-builder/capabilities/generate-python-automation/runner.py +33 -0
  359. package/runtime/agents/python-automation-builder/capabilities/generate-python-automation/workflow.md +5 -0
  360. package/runtime/agents/python-automation-builder/capabilities/plan-python-automation/capability.yaml +18 -0
  361. package/runtime/agents/python-automation-builder/capabilities/plan-python-automation/decision-rules.md +6 -0
  362. package/runtime/agents/python-automation-builder/capabilities/plan-python-automation/runner.py +33 -0
  363. package/runtime/agents/python-automation-builder/capabilities/plan-python-automation/workflow.md +6 -0
  364. package/runtime/agents/python-automation-builder/capabilities/review-python-automation/capability.yaml +20 -0
  365. package/runtime/agents/python-automation-builder/capabilities/review-python-automation/decision-rules.md +6 -0
  366. package/runtime/agents/python-automation-builder/capabilities/review-python-automation/runner.py +43 -0
  367. package/runtime/agents/python-automation-builder/capabilities/review-python-automation/workflow.md +5 -0
  368. package/runtime/agents/python-automation-builder/capabilities/wrap-automation-as-capability/capability.yaml +22 -0
  369. package/runtime/agents/python-automation-builder/capabilities/wrap-automation-as-capability/decision-rules.md +6 -0
  370. package/runtime/agents/python-automation-builder/capabilities/wrap-automation-as-capability/runner.py +43 -0
  371. package/runtime/agents/python-automation-builder/capabilities/wrap-automation-as-capability/workflow.md +6 -0
  372. package/runtime/agents/python-automation-builder/infra/integrations/python-automation/python_automation_repository.py +717 -0
  373. package/runtime/agents/python-automation-builder/knowledge/context.md +15 -0
  374. package/runtime/agents/python-automation-builder/knowledge/policies.yaml +12 -0
  375. package/runtime/agents/python-automation-builder/knowledge/system.md +19 -0
  376. package/runtime/agents/python-automation-builder/templates/automation-readme.md +13 -0
  377. package/runtime/agents/python-automation-builder/templates/automation-review-report.md +13 -0
  378. package/runtime/agents/python-automation-builder/templates/automation-test.py +9 -0
  379. package/runtime/agents/python-automation-builder/templates/automation.py +19 -0
  380. package/runtime/agents/python-automation-builder/templates/capability-wrapper.md +4 -0
  381. package/runtime/agents/python-automation-builder/tests/test_runners.py +292 -0
  382. package/runtime/agents/selenium-automation-builder/AGENTS.md +27 -0
  383. package/runtime/agents/selenium-automation-builder/README.md +40 -0
  384. package/runtime/agents/selenium-automation-builder/agent.yaml +45 -0
  385. package/runtime/agents/selenium-automation-builder/capabilities/generate-selenium-project-files/capability.yaml +20 -0
  386. package/runtime/agents/selenium-automation-builder/capabilities/generate-selenium-project-files/decision-rules.md +6 -0
  387. package/runtime/agents/selenium-automation-builder/capabilities/generate-selenium-project-files/runner.py +39 -0
  388. package/runtime/agents/selenium-automation-builder/capabilities/generate-selenium-project-files/workflow.md +7 -0
  389. package/runtime/agents/selenium-automation-builder/capabilities/generate-selenium-script/capability.yaml +18 -0
  390. package/runtime/agents/selenium-automation-builder/capabilities/generate-selenium-script/decision-rules.md +6 -0
  391. package/runtime/agents/selenium-automation-builder/capabilities/generate-selenium-script/runner.py +33 -0
  392. package/runtime/agents/selenium-automation-builder/capabilities/generate-selenium-script/workflow.md +6 -0
  393. package/runtime/agents/selenium-automation-builder/capabilities/plan-selenium-automation/capability.yaml +18 -0
  394. package/runtime/agents/selenium-automation-builder/capabilities/plan-selenium-automation/decision-rules.md +6 -0
  395. package/runtime/agents/selenium-automation-builder/capabilities/plan-selenium-automation/runner.py +33 -0
  396. package/runtime/agents/selenium-automation-builder/capabilities/plan-selenium-automation/workflow.md +6 -0
  397. package/runtime/agents/selenium-automation-builder/capabilities/review-selenium-script/capability.yaml +20 -0
  398. package/runtime/agents/selenium-automation-builder/capabilities/review-selenium-script/decision-rules.md +6 -0
  399. package/runtime/agents/selenium-automation-builder/capabilities/review-selenium-script/runner.py +40 -0
  400. package/runtime/agents/selenium-automation-builder/capabilities/review-selenium-script/workflow.md +6 -0
  401. package/runtime/agents/selenium-automation-builder/capabilities/wrap-selenium-as-capability/capability.yaml +22 -0
  402. package/runtime/agents/selenium-automation-builder/capabilities/wrap-selenium-as-capability/decision-rules.md +6 -0
  403. package/runtime/agents/selenium-automation-builder/capabilities/wrap-selenium-as-capability/runner.py +43 -0
  404. package/runtime/agents/selenium-automation-builder/capabilities/wrap-selenium-as-capability/workflow.md +6 -0
  405. package/runtime/agents/selenium-automation-builder/infra/integrations/selenium-automation/selenium_automation_repository.py +793 -0
  406. package/runtime/agents/selenium-automation-builder/knowledge/context.md +15 -0
  407. package/runtime/agents/selenium-automation-builder/knowledge/policies.yaml +17 -0
  408. package/runtime/agents/selenium-automation-builder/knowledge/system.md +18 -0
  409. package/runtime/agents/selenium-automation-builder/templates/capability-wrapper.md +4 -0
  410. package/runtime/agents/selenium-automation-builder/templates/selenium-automation.py +20 -0
  411. package/runtime/agents/selenium-automation-builder/templates/selenium-readme.md +13 -0
  412. package/runtime/agents/selenium-automation-builder/templates/selenium-review-report.md +13 -0
  413. package/runtime/agents/selenium-automation-builder/templates/selenium-test.py +9 -0
  414. package/runtime/agents/selenium-automation-builder/tests/test_runners.py +282 -0
  415. package/runtime/agents/software-specification-analyst/agent.yaml +17 -4
  416. package/runtime/agents/software-specification-analyst/capabilities/analyze-multiple-projects/capability.yaml +1 -1
  417. package/runtime/agents/software-specification-analyst/capabilities/analyze-project-context/capability.yaml +1 -1
  418. package/runtime/agents/software-specification-analyst/capabilities/conduct-requirements-interview/capability.yaml +1 -1
  419. package/runtime/agents/software-specification-analyst/capabilities/create-complete-spec/capability.yaml +1 -1
  420. package/runtime/agents/software-specification-analyst/capabilities/create-final-spec-from-analysis/capability.yaml +1 -1
  421. package/runtime/agents/software-specification-analyst/capabilities/create-functional-spec/capability.yaml +11 -0
  422. package/runtime/agents/software-specification-analyst/capabilities/create-technical-spec/capability.yaml +12 -0
  423. package/runtime/agents/software-specification-analyst/capabilities/refine-analysis-with-feedback/capability.yaml +1 -1
  424. package/runtime/agents/software-specification-analyst/capabilities/write-user-stories/capability.yaml +12 -0
  425. package/runtime/agents/sqlserver-change-operator/agent.yaml +12 -1
  426. package/runtime/agents/sqlserver-data-analyzer/agent.yaml +13 -2
  427. package/runtime/agents/supabase-project-analyst/AGENTS.md +29 -0
  428. package/runtime/agents/supabase-project-analyst/README.md +23 -0
  429. package/runtime/agents/supabase-project-analyst/agent.yaml +53 -0
  430. package/runtime/agents/supabase-project-analyst/capabilities/audit-auth-security/capability.yaml +18 -0
  431. package/runtime/agents/supabase-project-analyst/capabilities/audit-auth-security/decision-rules.md +5 -0
  432. package/runtime/agents/supabase-project-analyst/capabilities/audit-auth-security/runner.py +32 -0
  433. package/runtime/agents/supabase-project-analyst/capabilities/audit-auth-security/workflow.md +6 -0
  434. package/runtime/agents/supabase-project-analyst/capabilities/audit-rls-policies/capability.yaml +18 -0
  435. package/runtime/agents/supabase-project-analyst/capabilities/audit-rls-policies/decision-rules.md +6 -0
  436. package/runtime/agents/supabase-project-analyst/capabilities/audit-rls-policies/runner.py +32 -0
  437. package/runtime/agents/supabase-project-analyst/capabilities/audit-rls-policies/workflow.md +7 -0
  438. package/runtime/agents/supabase-project-analyst/capabilities/audit-storage-policies/capability.yaml +18 -0
  439. package/runtime/agents/supabase-project-analyst/capabilities/audit-storage-policies/decision-rules.md +5 -0
  440. package/runtime/agents/supabase-project-analyst/capabilities/audit-storage-policies/runner.py +32 -0
  441. package/runtime/agents/supabase-project-analyst/capabilities/audit-storage-policies/workflow.md +6 -0
  442. package/runtime/agents/supabase-project-analyst/capabilities/generate-supabase-report/capability.yaml +18 -0
  443. package/runtime/agents/supabase-project-analyst/capabilities/generate-supabase-report/decision-rules.md +6 -0
  444. package/runtime/agents/supabase-project-analyst/capabilities/generate-supabase-report/runner.py +32 -0
  445. package/runtime/agents/supabase-project-analyst/capabilities/generate-supabase-report/workflow.md +6 -0
  446. package/runtime/agents/supabase-project-analyst/capabilities/inspect-supabase-project/capability.yaml +19 -0
  447. package/runtime/agents/supabase-project-analyst/capabilities/inspect-supabase-project/decision-rules.md +6 -0
  448. package/runtime/agents/supabase-project-analyst/capabilities/inspect-supabase-project/runner.py +36 -0
  449. package/runtime/agents/supabase-project-analyst/capabilities/inspect-supabase-project/workflow.md +7 -0
  450. package/runtime/agents/supabase-project-analyst/capabilities/plan-supabase-fix/capability.yaml +18 -0
  451. package/runtime/agents/supabase-project-analyst/capabilities/plan-supabase-fix/decision-rules.md +6 -0
  452. package/runtime/agents/supabase-project-analyst/capabilities/plan-supabase-fix/runner.py +32 -0
  453. package/runtime/agents/supabase-project-analyst/capabilities/plan-supabase-fix/workflow.md +6 -0
  454. package/runtime/agents/supabase-project-analyst/capabilities/review-migrations/capability.yaml +18 -0
  455. package/runtime/agents/supabase-project-analyst/capabilities/review-migrations/decision-rules.md +6 -0
  456. package/runtime/agents/supabase-project-analyst/capabilities/review-migrations/runner.py +32 -0
  457. package/runtime/agents/supabase-project-analyst/capabilities/review-migrations/workflow.md +5 -0
  458. package/runtime/agents/supabase-project-analyst/infra/integrations/supabase-project/supabase_project_repository.py +589 -0
  459. package/runtime/agents/supabase-project-analyst/knowledge/context.md +11 -0
  460. package/runtime/agents/supabase-project-analyst/knowledge/policies.yaml +24 -0
  461. package/runtime/agents/supabase-project-analyst/knowledge/system.md +10 -0
  462. package/runtime/agents/supabase-project-analyst/templates/supabase-audit.md +3 -0
  463. package/runtime/agents/supabase-project-analyst/templates/supabase-fix-plan.md +3 -0
  464. package/runtime/agents/supabase-project-analyst/templates/supabase-inspection.md +3 -0
  465. package/runtime/agents/supabase-project-analyst/templates/supabase-report.md +3 -0
  466. package/runtime/agents/supabase-project-analyst/tests/test_runners.py +239 -0
  467. package/runtime/agents/task-orchestrator/agent.yaml +25 -3
  468. package/runtime/agents/task-orchestrator/capabilities/plan-task/capability.yaml +1 -2
  469. package/runtime/agents/task-orchestrator/capabilities/select-specialists/capability.yaml +1 -2
  470. package/runtime/agents/technical-integration-analyst/agent.yaml +15 -2
  471. package/runtime/agents/topdesk-orchestrator/agent.yaml +10 -2
  472. package/runtime/cli/aikit/__init__.py +1 -1
  473. package/runtime/cli/aikit/acceptance.py +166 -0
  474. package/runtime/cli/aikit/agent_executor.py +26 -3
  475. package/runtime/cli/aikit/agent_registry.py +244 -5
  476. package/runtime/cli/aikit/architecture.py +84 -0
  477. package/runtime/cli/aikit/audit.py +172 -3
  478. package/runtime/cli/aikit/autonomy.py +237 -0
  479. package/runtime/cli/aikit/capability_runtime.py +522 -0
  480. package/runtime/cli/aikit/catalog.py +246 -0
  481. package/runtime/cli/aikit/cli_dispatch.py +1078 -0
  482. package/runtime/cli/aikit/cli_parser.py +409 -0
  483. package/runtime/cli/aikit/collaboration.py +359 -0
  484. package/runtime/cli/aikit/configuration_orchestrator.py +52 -26
  485. package/runtime/cli/aikit/contribution.py +105 -0
  486. package/runtime/cli/aikit/core/__init__.py +1 -0
  487. package/runtime/cli/aikit/core/capability_contract.py +112 -0
  488. package/runtime/cli/aikit/core/requests.py +69 -0
  489. package/runtime/cli/aikit/core/runtime.py +64 -0
  490. package/runtime/cli/aikit/diagnostics.py +8 -2
  491. package/runtime/cli/aikit/doctor_runtime.py +79 -0
  492. package/runtime/cli/aikit/errors.py +7 -0
  493. package/runtime/cli/aikit/eval.py +158 -0
  494. package/runtime/cli/aikit/execution_reviewer.py +21 -0
  495. package/runtime/cli/aikit/extensions.py +140 -0
  496. package/runtime/cli/aikit/fallback.py +1 -0
  497. package/runtime/cli/aikit/github_pr.py +23 -0
  498. package/runtime/cli/aikit/guardrails.py +25 -10
  499. package/runtime/cli/aikit/human_output.py +1026 -0
  500. package/runtime/cli/aikit/impact_map.py +294 -0
  501. package/runtime/cli/aikit/interactive_wizard.py +79 -0
  502. package/runtime/cli/aikit/local_llm_operator.py +35 -1
  503. package/runtime/cli/aikit/main.py +9 -2834
  504. package/runtime/cli/aikit/mcp_manifest.py +229 -0
  505. package/runtime/cli/aikit/mcp_server.py +132 -0
  506. package/runtime/cli/aikit/mcp_tools.py +262 -0
  507. package/runtime/cli/aikit/mini_brain.py +227 -0
  508. package/runtime/cli/aikit/model_router.py +182 -18
  509. package/runtime/cli/aikit/module_controller.py +335 -0
  510. package/runtime/cli/aikit/natural_prompt_runtime.py +538 -0
  511. package/runtime/cli/aikit/notifications.py +716 -2
  512. package/runtime/cli/aikit/ollama.py +1 -0
  513. package/runtime/cli/aikit/orchestrator.py +809 -119
  514. package/runtime/cli/aikit/output.py +63 -2
  515. package/runtime/cli/aikit/permissions.py +14 -4
  516. package/runtime/cli/aikit/prompt_injection.py +57 -0
  517. package/runtime/cli/aikit/review_gate.py +38 -6
  518. package/runtime/cli/aikit/roadmap.py +195 -0
  519. package/runtime/cli/aikit/roadmap_cli.py +70 -0
  520. package/runtime/cli/aikit/router.py +41 -12
  521. package/runtime/cli/aikit/router_explain.py +152 -0
  522. package/runtime/cli/aikit/runtime_paths.py +11 -0
  523. package/runtime/cli/aikit/secrets.py +113 -0
  524. package/runtime/cli/aikit/sessions.py +88 -2
  525. package/runtime/cli/aikit/setup_wizard_payload.py +32 -0
  526. package/runtime/cli/aikit/sources.py +298 -50
  527. package/runtime/cli/aikit/tasks.py +449 -21
  528. package/runtime/cli/aikit/wizard_state.py +15 -1
  529. package/runtime/cli/aikit/workflows.py +115 -0
  530. package/runtime/cli/aikit/write_policy.py +108 -0
  531. package/runtime/plugins/claude-code-ai-devkit/README.md +17 -0
  532. package/runtime/plugins/claude-code-ai-devkit/agents/README.md +29 -2
  533. package/runtime/plugins/claude-code-ai-devkit/agents/agent-devkit-db-analyst.md +44 -0
  534. package/runtime/plugins/claude-code-ai-devkit/agents/agent-devkit-execution-reviewer.md +38 -0
  535. package/runtime/plugins/claude-code-ai-devkit/agents/agent-devkit-pr-reviewer.md +42 -0
  536. package/runtime/plugins/claude-code-ai-devkit/agents/agent-devkit-repo-explorer.md +40 -0
  537. package/runtime/plugins/claude-code-ai-devkit/agents/agent-devkit-support-triage.md +43 -0
  538. package/runtime/plugins/claude-code-ai-devkit/plugin.json +1 -1
  539. package/runtime/plugins/claude-code-ai-devkit/skills/ai-devkit-router/SKILL.md +16 -0
  540. package/runtime/plugins/claude-skill-ai-devkit/ai-devkit/SKILL.md +1 -0
  541. package/runtime/plugins/claude-skill-ai-devkit/ai-devkit/references/subagents.md +21 -0
  542. package/runtime/plugins/claude-skill-ai-devkit/plugin.json +1 -1
  543. package/runtime/providers/azure-devops.yaml +9 -0
  544. package/runtime/providers/github.yaml +4 -0
  545. package/runtime/providers/local-notification.yaml +5 -2
  546. package/runtime/providers/local-scheduler.yaml +1 -1
  547. package/runtime/providers/supabase.yaml +46 -0
  548. package/runtime/scripts/release-catalog-snapshot.json +543 -0
  549. package/runtime/scripts/release-gate.py +141 -1
  550. package/runtime/scripts/validate-repo.py +312 -0
  551. package/runtime/vendor/skills/napkin/napkin.md +15 -9
@@ -0,0 +1,115 @@
1
+ """Installable workflow MVP for Agent DevKit."""
2
+
3
+ from __future__ import annotations
4
+
5
+ from typing import Any
6
+
7
+ from cli.aikit.tasks import create_task
8
+
9
+
10
+ WORKFLOW_SCHEMA_VERSION = "agent-devkit.workflows/v1"
11
+
12
+
13
+ BUILTIN_WORKFLOWS: dict[str, dict[str, Any]] = {
14
+ "daily-pr-review": {
15
+ "id": "daily-pr-review",
16
+ "title": "Daily PR review",
17
+ "description": "Create a local scheduled prompt to review pending pull requests.",
18
+ "schedule": {"type": "cron", "cron": "0 9 * * 1-5"},
19
+ "task": {
20
+ "title": "Daily PR review",
21
+ "prompt": "Revise as PRs que aguardam minha revisao hoje.",
22
+ "action": {"type": "prompt", "prompt": "Revise as PRs que aguardam minha revisao hoje.", "external_writes": False},
23
+ "permissions": {"mode": "report-only"},
24
+ "notifications": [{"type": "desktop", "events": ["task.completed", "task.blocked"]}],
25
+ },
26
+ "write_policy": "local_config_write",
27
+ }
28
+ }
29
+
30
+
31
+ def workflow_list() -> dict[str, Any]:
32
+ return {
33
+ "kind": "workflows",
34
+ "schema_version": WORKFLOW_SCHEMA_VERSION,
35
+ "status": "ok",
36
+ "items": [public_workflow(item) for item in BUILTIN_WORKFLOWS.values()],
37
+ }
38
+
39
+
40
+ def workflow_show(workflow_id: str) -> dict[str, Any]:
41
+ workflow = require_workflow(workflow_id)
42
+ return {"kind": "workflow", "schema_version": WORKFLOW_SCHEMA_VERSION, "status": "ok", "workflow": public_workflow(workflow)}
43
+
44
+
45
+ def workflow_install(workflow_id: str, *, dry_run: bool = True, yes: bool = False) -> dict[str, Any]:
46
+ workflow = require_workflow(workflow_id)
47
+ mode = "dry-run" if dry_run or not yes else "apply"
48
+ task = workflow["task"]
49
+ plan = {
50
+ "task": {
51
+ "id": workflow["id"],
52
+ "title": task["title"],
53
+ "schedule": workflow["schedule"],
54
+ "permissions": task["permissions"],
55
+ "notifications": task["notifications"],
56
+ },
57
+ "writes": ["local task registry"],
58
+ "stores_secret": False,
59
+ }
60
+ if mode == "dry-run":
61
+ return {
62
+ "kind": "workflow-install",
63
+ "schema_version": WORKFLOW_SCHEMA_VERSION,
64
+ "status": "planned",
65
+ "mode": "dry-run",
66
+ "workflow": public_workflow(workflow),
67
+ "plan": plan,
68
+ }
69
+ created = create_task(
70
+ task_id=workflow["id"],
71
+ title=task["title"],
72
+ prompt=task["prompt"],
73
+ schedule=workflow["schedule"],
74
+ action=task["action"],
75
+ permissions=task["permissions"],
76
+ notifications=task["notifications"],
77
+ )
78
+ return {
79
+ "kind": "workflow-install",
80
+ "schema_version": WORKFLOW_SCHEMA_VERSION,
81
+ "status": "installed",
82
+ "mode": "apply",
83
+ "workflow": public_workflow(workflow),
84
+ "task": created.get("task"),
85
+ }
86
+
87
+
88
+ def workflow_run(workflow_id: str, *, dry_run: bool = True) -> dict[str, Any]:
89
+ workflow = require_workflow(workflow_id)
90
+ return {
91
+ "kind": "workflow-run",
92
+ "schema_version": WORKFLOW_SCHEMA_VERSION,
93
+ "status": "planned" if dry_run else "blocked",
94
+ "dry_run": dry_run,
95
+ "workflow": public_workflow(workflow),
96
+ "message": "Workflow MVP runs through installed tasks; use workflow install first.",
97
+ }
98
+
99
+
100
+ def require_workflow(workflow_id: str) -> dict[str, Any]:
101
+ workflow = BUILTIN_WORKFLOWS.get(workflow_id or "")
102
+ if not workflow:
103
+ raise ValueError(f"workflow not found: {workflow_id}")
104
+ return workflow
105
+
106
+
107
+ def public_workflow(workflow: dict[str, Any]) -> dict[str, Any]:
108
+ return {
109
+ "id": workflow["id"],
110
+ "title": workflow["title"],
111
+ "description": workflow["description"],
112
+ "schedule": workflow["schedule"],
113
+ "write_policy": workflow["write_policy"],
114
+ "stores_secret": False,
115
+ }
@@ -0,0 +1,108 @@
1
+ """Canonical write policy vocabulary used by the Agent DevKit runtime."""
2
+
3
+ from __future__ import annotations
4
+
5
+ from typing import Any
6
+
7
+
8
+ CANONICAL_WRITE_POLICIES = {
9
+ "read_only",
10
+ "dry_run",
11
+ "output_only",
12
+ "local_write",
13
+ "local_config_write",
14
+ "confirm",
15
+ "blocked_by_default",
16
+ "delegated",
17
+ }
18
+
19
+ LEGACY_WRITE_POLICY_ALIASES = {
20
+ "read-only": "read_only",
21
+ "delegated_read_only": "read_only",
22
+ "ask_before_write": "confirm",
23
+ "ask_before_creating_output_directory": "output_only",
24
+ "generated_artifacts_only": "output_only",
25
+ "create_new_version": "local_write",
26
+ "template_version_write": "local_write",
27
+ "local-write": "local_write",
28
+ "local-config-write": "local_config_write",
29
+ }
30
+
31
+ AUTONOMOUS_SAFE_WRITE_POLICIES = {"read_only", "dry_run"}
32
+ CONFIRMATION_WRITE_POLICIES = {"confirm", "local_write", "local_config_write"}
33
+ BLOCKED_WRITE_POLICIES = {"blocked_by_default"}
34
+
35
+
36
+ def canonical_write_policies() -> set[str]:
37
+ return set(CANONICAL_WRITE_POLICIES)
38
+
39
+
40
+ def legacy_write_policy_aliases() -> dict[str, str]:
41
+ return dict(LEGACY_WRITE_POLICY_ALIASES)
42
+
43
+
44
+ def normalize_write_policy(value: Any, *, default: str = "read_only") -> str:
45
+ raw = str(value or "").strip()
46
+ if not raw:
47
+ raw = default
48
+ return LEGACY_WRITE_POLICY_ALIASES.get(raw, raw)
49
+
50
+
51
+ def is_known_write_policy(value: Any) -> bool:
52
+ raw = str(value or "").strip()
53
+ if not raw:
54
+ return False
55
+ return raw in CANONICAL_WRITE_POLICIES or raw in LEGACY_WRITE_POLICY_ALIASES
56
+
57
+
58
+ def is_autonomous_safe_write_policy(value: Any) -> bool:
59
+ return normalize_write_policy(value) in AUTONOMOUS_SAFE_WRITE_POLICIES
60
+
61
+
62
+ def requires_runtime_confirmation(value: Any) -> bool:
63
+ return normalize_write_policy(value) in CONFIRMATION_WRITE_POLICIES
64
+
65
+
66
+ def is_blocked_by_default(value: Any) -> bool:
67
+ return normalize_write_policy(value) in BLOCKED_WRITE_POLICIES
68
+
69
+
70
+ def write_policy_metadata(value: Any, *, default: str = "read_only") -> dict[str, Any]:
71
+ raw = str(value or "").strip() or default
72
+ canonical = normalize_write_policy(raw, default=default)
73
+ return {
74
+ "raw": raw,
75
+ "canonical": canonical,
76
+ "known": is_known_write_policy(raw),
77
+ "legacy": raw in LEGACY_WRITE_POLICY_ALIASES,
78
+ "autonomous_safe": canonical in AUTONOMOUS_SAFE_WRITE_POLICIES,
79
+ "requires_confirmation": canonical in CONFIRMATION_WRITE_POLICIES,
80
+ "blocked_by_default": canonical in BLOCKED_WRITE_POLICIES,
81
+ }
82
+
83
+
84
+ def coerce_write_policy_metadata(value: Any, *, default: str = "read_only") -> dict[str, Any]:
85
+ if not isinstance(value, dict):
86
+ return write_policy_metadata(value, default=default)
87
+
88
+ canonical_hint = str(value.get("canonical") or "").strip()
89
+ raw = str(value.get("raw") or "").strip() or canonical_hint or default
90
+ canonical = canonical_hint or normalize_write_policy(raw, default=default)
91
+ return {
92
+ "raw": raw,
93
+ "canonical": canonical,
94
+ "known": canonical in CANONICAL_WRITE_POLICIES or is_known_write_policy(raw),
95
+ "legacy": raw in LEGACY_WRITE_POLICY_ALIASES,
96
+ "autonomous_safe": canonical in AUTONOMOUS_SAFE_WRITE_POLICIES,
97
+ "requires_confirmation": canonical in CONFIRMATION_WRITE_POLICIES,
98
+ "blocked_by_default": canonical in BLOCKED_WRITE_POLICIES,
99
+ }
100
+
101
+
102
+ def write_policy_public_fields(value: Any, *, default: str = "read_only") -> dict[str, Any]:
103
+ metadata = coerce_write_policy_metadata(value, default=default)
104
+ return {
105
+ "write_policy": metadata["canonical"],
106
+ "write_policy_raw": metadata["raw"],
107
+ "write_policy_metadata": metadata,
108
+ }
@@ -6,6 +6,11 @@ DevKit.
6
6
  O plugin fornece um router skill, comandos de orientacao e scripts que delegam
7
7
  para `agent`.
8
8
 
9
+ Ele tambem inclui subagentes Claude Code em `agents/` para isolar contexto de
10
+ exploracao, banco, PR, suporte e revisao final. Esses subagentes continuam
11
+ usando o Agent DevKit como fonte da verdade: preferem MCP quando disponivel e,
12
+ como fallback atual, chamam `scripts/run-capability.py`.
13
+
9
14
  ## Comandos
10
15
 
11
16
  ```bash
@@ -14,6 +19,18 @@ python3 scripts/doctor.py --json
14
19
  python3 scripts/run-capability.py --json elasticsearch-log-analyzer search-log-events --source app --from 2026-06-27T00:00:00Z --to 2026-06-27T01:00:00Z
15
20
  ```
16
21
 
22
+ ## Subagentes
23
+
24
+ - `agent-devkit-repo-explorer`
25
+ - `agent-devkit-db-analyst`
26
+ - `agent-devkit-pr-reviewer`
27
+ - `agent-devkit-support-triage`
28
+ - `agent-devkit-execution-reviewer`
29
+
30
+ Eles sao opcionais e conservadores. Nao devem executar escrita externa sem
31
+ confirmacao, nao devem ignorar `write_policy` e nao devem duplicar a logica dos
32
+ agentes em `agents/`.
33
+
17
34
  A instalacao recomendada pelo runtime e:
18
35
 
19
36
  ```bash
@@ -1,5 +1,32 @@
1
1
  # Claude Code Agents
2
2
 
3
3
  Este plugin usa o runtime central do Agent DevKit como fonte da verdade. Agentes
4
- nativos do host podem ser adicionados depois, mas nao devem duplicar logica de
5
- `agents/`.
4
+ nativos do host devem ser pequenos, focados e conservadores. Eles nao duplicam
5
+ logica de `agents/`; apenas orientam o Claude Code a chamar o Agent DevKit por
6
+ MCP quando disponivel ou pelo script local `run-capability.py`.
7
+
8
+ ## Subagentes incluidos
9
+
10
+ - `agent-devkit-repo-explorer`: explora repositorios e inventario de agentes.
11
+ - `agent-devkit-db-analyst`: analisa perguntas de banco usando capabilities
12
+ read-only.
13
+ - `agent-devkit-pr-reviewer`: revisa Pull Requests por contrato do
14
+ `github-pr-reviewer`.
15
+ - `agent-devkit-support-triage`: faz triagem N1/N2 sem assumir escrita externa.
16
+ - `agent-devkit-execution-reviewer`: revisa plano/resultado antes da resposta
17
+ final.
18
+
19
+ ## Guardrails
20
+
21
+ - Use o MCP `mcp__agent-devkit__capability_run` se ele existir na sessao.
22
+ - Se MCP nao existir, use apenas `python3 plugins/claude-code-ai-devkit/scripts/run-capability.py --json ...`.
23
+ - Nao use shell arbitrario para resolver uma tarefa coberta por capability.
24
+ - Preserve `write_policy`, `providers`, `fallback_applied`, `risks` e
25
+ `next_steps` na resposta.
26
+ - Retorne resumo com evidencias; nao despeje logs completos.
27
+ - Reporte `blocked` quando a tarefa exigir permissao, provider ou escrita
28
+ externa nao autorizada.
29
+
30
+ Observacao: em subagentes fornecidos por plugin, Claude Code ignora frontmatter
31
+ como `permissionMode` e `mcpServers`. Por isso estes templates restringem
32
+ ferramentas com `tools` e reforcam permissoes no prompt do subagente.
@@ -0,0 +1,44 @@
1
+ ---
2
+ name: agent-devkit-db-analyst
3
+ description: Use para investigar perguntas de banco com Agent DevKit read-only, SQL Server, Postgres ou Supabase, retornando evidencias e bloqueios.
4
+ tools: Read, Glob, Grep, Bash
5
+ model: sonnet
6
+ ---
7
+
8
+ Voce e um subagente Claude Code para analise de banco via Agent DevKit.
9
+
10
+ Escopo permitido:
11
+
12
+ - `sqlserver-data-analyzer`
13
+ - `postgres-data-analyzer`
14
+ - `supabase-project-analyst`
15
+
16
+ Regras:
17
+
18
+ - Execute apenas capabilities `read_only` ou `dry_run`.
19
+ - Prefira MCP `mcp__agent-devkit__capability_run` quando disponivel.
20
+ - Se MCP nao existir, use apenas
21
+ `python3 plugins/claude-code-ai-devkit/scripts/run-capability.py --json <agent> <capability> ...`.
22
+ - Nao execute cliente SQL direto, migration, update, delete, insert ou DDL.
23
+ - Preserve `write_policy`, providers, fallbacks, riscos e proximos passos nos
24
+ resumos.
25
+ - Se a pergunta exigir escrita, retorne `blocked` e indique a confirmacao ou o
26
+ agente de change operator apropriado.
27
+ - Resuma amostras e evidencias; nao despeje tabelas grandes.
28
+ - Preserve `providers.missing`, `fallback_applied`, `risks` e `next_steps` dos
29
+ payloads do Agent DevKit.
30
+
31
+ Formato de saida:
32
+
33
+ ```json
34
+ {
35
+ "status": "ok|blocked|partial",
36
+ "agent_used": "...",
37
+ "capability_used": "...",
38
+ "summary": "...",
39
+ "evidence": [],
40
+ "risks": [],
41
+ "blocked_reason": null,
42
+ "next_steps": []
43
+ }
44
+ ```
@@ -0,0 +1,38 @@
1
+ ---
2
+ name: agent-devkit-execution-reviewer
3
+ description: Use para revisar plano, resultado ou resposta final com execution-reviewer antes de concluir uma tarefa Agent DevKit.
4
+ tools: Read, Glob, Grep, Bash
5
+ model: sonnet
6
+ ---
7
+
8
+ Voce e um subagente Claude Code de revisao final para Agent DevKit.
9
+
10
+ Escopo preferencial:
11
+
12
+ - `execution-reviewer/review-plan`
13
+ - `execution-reviewer/review-agent-result`
14
+ - `execution-reviewer/review-final-output`
15
+
16
+ Regras:
17
+
18
+ - Prefira MCP `mcp__agent-devkit__capability_run` quando disponivel.
19
+ - Se MCP nao existir, use apenas
20
+ `python3 plugins/claude-code-ai-devkit/scripts/run-capability.py --json execution-reviewer <capability> ...`.
21
+ - Preserve `write_policy`, providers, fallbacks, riscos e proximos passos nos
22
+ resumos.
23
+ - Nao altere arquivos e nao execute a correcao diretamente.
24
+ - Verifique coerencia, policy, riscos, provider missing, testes e lacunas.
25
+ - Preserve achados de bloqueio e indique a menor correcao necessaria.
26
+
27
+ Formato de saida:
28
+
29
+ ```json
30
+ {
31
+ "status": "ok|needs-fix|blocked",
32
+ "approved": false,
33
+ "findings": [],
34
+ "policy_risks": [],
35
+ "test_gaps": [],
36
+ "next_steps": []
37
+ }
38
+ ```
@@ -0,0 +1,42 @@
1
+ ---
2
+ name: agent-devkit-pr-reviewer
3
+ description: Use para revisar Pull Requests via Agent DevKit em modo report-only, sem comentar, aprovar ou solicitar mudancas automaticamente.
4
+ tools: Read, Glob, Grep, Bash
5
+ model: sonnet
6
+ ---
7
+
8
+ Voce e um subagente Claude Code para review de PR usando Agent DevKit.
9
+
10
+ Escopo preferencial:
11
+
12
+ - `github-pr-reviewer/list-review-requests`
13
+ - `github-pr-reviewer/inspect-pr`
14
+ - `github-pr-reviewer/review-pr-diff`
15
+
16
+ Regras:
17
+
18
+ - Modo padrao e report-only.
19
+ - Nunca aprove, comente ou solicite mudancas sem permissao explicita e policy
20
+ correspondente.
21
+ - Prefira MCP `mcp__agent-devkit__capability_run` quando disponivel.
22
+ - Se MCP nao existir, use apenas
23
+ `python3 plugins/claude-code-ai-devkit/scripts/run-capability.py --json github-pr-reviewer <capability> ...`.
24
+ - Preserve `write_policy`, providers, fallbacks, riscos e proximos passos nos
25
+ resumos.
26
+ - Preserve `permission`, `requires_permission`, `providers`, `risks`,
27
+ `fallback_applied` e `next_steps`.
28
+ - Foque em bugs, regressao, seguranca, contrato e testes faltantes.
29
+
30
+ Formato de saida:
31
+
32
+ ```json
33
+ {
34
+ "status": "ok|blocked|partial",
35
+ "pr": "...",
36
+ "findings": [],
37
+ "tests_or_gaps": [],
38
+ "requires_permission": false,
39
+ "blocked_reason": null,
40
+ "next_steps": []
41
+ }
42
+ ```
@@ -0,0 +1,40 @@
1
+ ---
2
+ name: agent-devkit-repo-explorer
3
+ description: Use para explorar estrutura de repositorio, agentes, capabilities e contexto antes de planejar trabalho com Agent DevKit.
4
+ tools: Read, Glob, Grep, Bash
5
+ model: haiku
6
+ ---
7
+
8
+ Voce e um subagente Claude Code de exploracao read-only para Agent DevKit.
9
+
10
+ Objetivo: levantar contexto pequeno e acionavel sem poluir a conversa principal.
11
+
12
+ Regras:
13
+
14
+ - Prefira `mcp__agent-devkit__capability_run` quando a ferramenta MCP do Agent
15
+ DevKit estiver disponivel.
16
+ - Se MCP nao estiver disponivel, use apenas comandos seguros do runtime:
17
+ `agent agents --json`, `agent capabilities <agent> --json`,
18
+ `agent inspect <agent> <capability> --json` ou
19
+ `python3 plugins/claude-code-ai-devkit/scripts/run-capability.py --json ...`.
20
+ - Use `Read`, `Glob` e `Grep` para localizar arquivos relevantes.
21
+ - Preserve `write_policy`, providers, fallbacks, riscos e proximos passos nos
22
+ resumos.
23
+ - Nao edite arquivos, nao rode formatadores e nao execute comandos externos de
24
+ instalacao.
25
+ - Nao exponha segredos. Se encontrar valores sensiveis, redija.
26
+
27
+ Formato de saida:
28
+
29
+ ```json
30
+ {
31
+ "status": "ok|blocked|partial",
32
+ "scope": "...",
33
+ "findings": [],
34
+ "recommended_agent": "...",
35
+ "recommended_capability": "...",
36
+ "evidence": [],
37
+ "blocked_reason": null,
38
+ "next_steps": []
39
+ }
40
+ ```
@@ -0,0 +1,43 @@
1
+ ---
2
+ name: agent-devkit-support-triage
3
+ description: Use para triagem N1/N2 de incidentes usando Agent DevKit, preservando providers, fallbacks, evidencias e bloqueios.
4
+ tools: Read, Glob, Grep, Bash
5
+ model: sonnet
6
+ ---
7
+
8
+ Voce e um subagente Claude Code para triagem de suporte via Agent DevKit.
9
+
10
+ Escopo preferencial:
11
+
12
+ - `n1-support-agent`
13
+ - `n2-support-agent`
14
+ - `azure-devops-orchestrator`
15
+ - `topdesk-orchestrator`
16
+ - analisadores de logs e bancos read-only
17
+
18
+ Regras:
19
+
20
+ - Prefira MCP `mcp__agent-devkit__capability_run` quando disponivel.
21
+ - Se MCP nao existir, use apenas
22
+ `python3 plugins/claude-code-ai-devkit/scripts/run-capability.py --json ...`.
23
+ - Nao mova cards, comente, atualize TOPdesk ou execute escrita externa sem
24
+ confirmacao explicita.
25
+ - Preserve `write_policy`, providers, fallbacks, riscos e proximos passos nos
26
+ resumos.
27
+ - Preserve `providers.missing`, `fallback_applied`, `risks` e `next_steps`.
28
+ - Resuma logs e dados sensiveis; nao copie payloads grandes para a resposta.
29
+ - Se faltar provider, retorne `blocked` ou `partial` com a configuracao minima.
30
+
31
+ Formato de saida:
32
+
33
+ ```json
34
+ {
35
+ "status": "ok|blocked|partial",
36
+ "incident": "...",
37
+ "summary": "...",
38
+ "evidence": [],
39
+ "hypotheses": [],
40
+ "blocked_reason": null,
41
+ "next_steps": []
42
+ }
43
+ ```
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "id": "claude-code-ai-devkit",
3
3
  "name": "AI DevKit",
4
- "version": "0.0.4",
4
+ "version": "0.0.5",
5
5
  "description": "Thin Claude Code adapter for routing software support, infrastructure, data, and development tasks through the local AI DevKit runtime.",
6
6
  "runtime": {
7
7
  "command": "agent",
@@ -13,6 +13,22 @@ specification.
13
13
  Prefer `agent run` for deterministic execution. Use `agent` only when the
14
14
  terminal runtime must route free-form language without host LLM support.
15
15
 
16
+ Use the plugin subagents in `plugins/claude-code-ai-devkit/agents/` when the
17
+ task benefits from isolated context:
18
+
19
+ - `agent-devkit-repo-explorer` for repository exploration and agent/capability
20
+ inventory.
21
+ - `agent-devkit-db-analyst` for SQL Server, Postgres, or Supabase read-only
22
+ analysis.
23
+ - `agent-devkit-pr-reviewer` for GitHub PR review in report-only mode.
24
+ - `agent-devkit-support-triage` for N1/N2 support triage.
25
+ - `agent-devkit-execution-reviewer` for final plan/result review.
26
+
27
+ Subagents must prefer Agent DevKit MCP tools when available. If MCP is not
28
+ available, they must call the thin plugin runtime script instead of duplicating
29
+ domain logic. They must preserve `write_policy`, `providers`, `risks`,
30
+ `fallback_applied`, and `next_steps` in their summaries.
31
+
16
32
  If a provider is missing, ask for the minimum provider reference with
17
33
  `agent provider configure`. If the user ignores the request, preserve the
18
34
  runtime fallback result from `requires.providers`.
@@ -26,3 +26,4 @@ queries, runbooks, and manual steps without pretending local execution happened.
26
26
  - For support workflows, read `references/sustentacao.md`.
27
27
  - For infrastructure workflows, read `references/infra.md`.
28
28
  - For development/specification workflows, read `references/desenvolvimento.md`.
29
+ - For Claude Code subagent patterns, read `references/subagents.md`.
@@ -0,0 +1,21 @@
1
+ # Subagentes Claude
2
+
3
+ Subagentes sao um recurso do Claude Code. Este skill de Claude Desktop/Claude.ai
4
+ permanece `skill-only` e nao tenta criar subagentes dinamicos.
5
+
6
+ Quando o usuario estiver em Claude Code, use os templates do plugin
7
+ `claude-code-ai-devkit/agents/`:
8
+
9
+ - `agent-devkit-repo-explorer`
10
+ - `agent-devkit-db-analyst`
11
+ - `agent-devkit-pr-reviewer`
12
+ - `agent-devkit-support-triage`
13
+ - `agent-devkit-execution-reviewer`
14
+
15
+ Regras:
16
+
17
+ - Agent DevKit continua sendo a fonte da verdade.
18
+ - Prefira MCP do Agent DevKit quando existir.
19
+ - Sem MCP, use `scripts/run-capability.py --json`.
20
+ - Preserve `write_policy`, providers, fallbacks, riscos e proximos passos.
21
+ - Nao conceda escrita externa por padrao.
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "id": "claude-skill-ai-devkit",
3
3
  "name": "AI DevKit Claude Skill",
4
- "version": "0.0.4",
4
+ "version": "0.0.5",
5
5
  "description": "Skill bundle for Claude Desktop and Claude.ai to route support, infrastructure, data, documentation, and development work through AI DevKit practices.",
6
6
  "runtime": {
7
7
  "command": "agent",
@@ -23,6 +23,15 @@ detection:
23
23
  env_any:
24
24
  - AZURE_DEVOPS_ORG
25
25
  - AZURE_DEVOPS_PAT
26
+ wizard:
27
+ suggested_config:
28
+ project: prompt.project
29
+ AZURE_DEVOPS_PROJECT: prompt.project
30
+ field_suggestions:
31
+ AZURE_DEVOPS_PROJECT: prompt.project
32
+ questions:
33
+ AZURE_DEVOPS_ORG: Qual e a organizacao do Azure DevOps?
34
+ AZURE_DEVOPS_PROJECT: Qual e o nome do projeto no Azure DevOps?
26
35
  capabilities:
27
36
  read:
28
37
  - azure-devops-orchestrator/list-cards
@@ -32,10 +32,14 @@ fallbacks:
32
32
  - manual_steps
33
33
  capabilities:
34
34
  read:
35
+ - github-pr-reviewer/list-review-requests
36
+ - github-pr-reviewer/inspect-pr
37
+ - github-pr-reviewer/review-pr-diff
35
38
  - pr.list-review-requests
36
39
  - pr.inspect
37
40
  - pr.review-report
38
41
  write:
42
+ - github-pr-reviewer/create-review-automation
39
43
  - pr.comment
40
44
  - pr.approve
41
45
  - pr.request-changes
@@ -1,8 +1,8 @@
1
1
  id: local-notification
2
2
  name: Local Notification
3
3
  kind: local-runtime
4
- status: draft
5
- description: Local notification provider for terminal notifications.
4
+ status: active
5
+ description: Local notifications for task completion and operational alerts.
6
6
  auth_methods: []
7
7
  config_fields: []
8
8
  health_check:
@@ -15,5 +15,8 @@ fallbacks:
15
15
  capabilities:
16
16
  read: []
17
17
  write:
18
+ - notification.desktop
18
19
  - notification.terminal
20
+ - notification.stdout
21
+ - notification.audit
19
22
  write: true
@@ -8,7 +8,7 @@ config_fields: []
8
8
  health_check:
9
9
  command: agent scheduler run-once --dry-run
10
10
  risk:
11
- default: local-write
11
+ default: local_write
12
12
  writes: true
13
13
  fallbacks:
14
14
  - dry_run