@cubis/foundry 0.3.76 → 0.3.78

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 (276) hide show
  1. package/dist/cli/build/commands.js +19 -0
  2. package/dist/cli/build/commands.js.map +1 -0
  3. package/dist/cli/commands/register.js +4 -0
  4. package/dist/cli/commands/register.js.map +1 -1
  5. package/dist/cli/core.js +844 -25
  6. package/dist/cli/core.js.map +1 -1
  7. package/mcp/src/tools/skillTools.test.ts +34 -1
  8. package/package.json +4 -3
  9. package/src/cli/build/commands.ts +39 -0
  10. package/src/cli/commands/register.ts +6 -0
  11. package/src/cli/core.ts +1026 -28
  12. package/workflows/skills/_schema/skill-platform-attributes.json +7 -0
  13. package/workflows/skills/deep-research/SKILL.md +81 -0
  14. package/workflows/skills/deep-research/evals/assertions.md +17 -0
  15. package/workflows/skills/deep-research/evals/evals.json +56 -0
  16. package/workflows/skills/deep-research/examples/01-latest-docs-check.md +12 -0
  17. package/workflows/skills/deep-research/examples/02-ecosystem-comparison.md +12 -0
  18. package/workflows/skills/deep-research/examples/03-research-to-implementation-handoff.md +12 -0
  19. package/workflows/skills/deep-research/references/comparison-checklist.md +57 -0
  20. package/workflows/skills/deep-research/references/research-output.md +69 -0
  21. package/workflows/skills/deep-research/references/source-ladder.md +81 -0
  22. package/workflows/skills/generated/skill-audit.json +20 -2
  23. package/workflows/skills/generated/skill-catalog.json +70 -4
  24. package/workflows/skills/skills_index.json +66 -0
  25. package/workflows/skills/spec-driven-delivery/SKILL.md +63 -0
  26. package/workflows/workflows/agent-environment-setup/generated/route-manifest.json +123 -10
  27. package/workflows/workflows/agent-environment-setup/manifest.json +48 -1
  28. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/orchestrator.md +6 -5
  29. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/project-planner.md +4 -3
  30. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/researcher.md +8 -4
  31. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/accessibility.toml +10 -3
  32. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/architecture.toml +19 -0
  33. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/backend.toml +10 -3
  34. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/create.toml +10 -3
  35. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/database.toml +10 -3
  36. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/debug.toml +10 -3
  37. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/devops.toml +10 -3
  38. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/implement-track.toml +10 -3
  39. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/migrate.toml +10 -3
  40. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/mobile.toml +10 -3
  41. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/onboard.toml +10 -3
  42. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/orchestrate.toml +10 -3
  43. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/plan.toml +10 -3
  44. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/refactor.toml +10 -3
  45. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/release.toml +10 -3
  46. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/review.toml +10 -3
  47. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/security.toml +10 -3
  48. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/spec.toml +19 -0
  49. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/test.toml +10 -3
  50. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/vercel.toml +10 -3
  51. package/workflows/workflows/agent-environment-setup/platforms/antigravity/rules/GEMINI.md +15 -8
  52. package/workflows/workflows/agent-environment-setup/platforms/antigravity/skills/deep-research/SKILL.md +89 -0
  53. package/workflows/workflows/agent-environment-setup/platforms/antigravity/skills/deep-research/evals/assertions.md +17 -0
  54. package/workflows/workflows/agent-environment-setup/platforms/antigravity/skills/deep-research/evals/evals.json +56 -0
  55. package/workflows/workflows/agent-environment-setup/platforms/antigravity/skills/deep-research/examples/01-latest-docs-check.md +12 -0
  56. package/workflows/workflows/agent-environment-setup/platforms/antigravity/skills/deep-research/examples/02-ecosystem-comparison.md +12 -0
  57. package/workflows/workflows/agent-environment-setup/platforms/antigravity/skills/deep-research/examples/03-research-to-implementation-handoff.md +12 -0
  58. package/workflows/workflows/agent-environment-setup/platforms/antigravity/skills/deep-research/references/comparison-checklist.md +57 -0
  59. package/workflows/workflows/agent-environment-setup/platforms/antigravity/skills/deep-research/references/research-output.md +69 -0
  60. package/workflows/workflows/agent-environment-setup/platforms/antigravity/skills/deep-research/references/source-ladder.md +81 -0
  61. package/workflows/workflows/agent-environment-setup/platforms/antigravity/skills/spec-driven-delivery/SKILL.md +65 -0
  62. package/workflows/workflows/agent-environment-setup/platforms/antigravity/workflows/architecture.md +82 -0
  63. package/workflows/workflows/agent-environment-setup/platforms/antigravity/workflows/backend.md +3 -0
  64. package/workflows/workflows/agent-environment-setup/platforms/antigravity/workflows/create.md +4 -1
  65. package/workflows/workflows/agent-environment-setup/platforms/antigravity/workflows/database.md +3 -0
  66. package/workflows/workflows/agent-environment-setup/platforms/antigravity/workflows/implement-track.md +7 -1
  67. package/workflows/workflows/agent-environment-setup/platforms/antigravity/workflows/migrate.md +4 -1
  68. package/workflows/workflows/agent-environment-setup/platforms/antigravity/workflows/mobile.md +3 -0
  69. package/workflows/workflows/agent-environment-setup/platforms/antigravity/workflows/onboard.md +4 -3
  70. package/workflows/workflows/agent-environment-setup/platforms/antigravity/workflows/orchestrate.md +8 -3
  71. package/workflows/workflows/agent-environment-setup/platforms/antigravity/workflows/plan.md +16 -6
  72. package/workflows/workflows/agent-environment-setup/platforms/antigravity/workflows/refactor.md +3 -0
  73. package/workflows/workflows/agent-environment-setup/platforms/antigravity/workflows/release.md +3 -0
  74. package/workflows/workflows/agent-environment-setup/platforms/antigravity/workflows/spec.md +81 -0
  75. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/orchestrator.md +6 -5
  76. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/project-planner.md +4 -3
  77. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/researcher.md +8 -4
  78. package/workflows/workflows/agent-environment-setup/platforms/claude/hooks/README.md +15 -0
  79. package/workflows/workflows/agent-environment-setup/platforms/claude/hooks/route-research-guard.mjs +39 -0
  80. package/workflows/workflows/agent-environment-setup/platforms/claude/hooks/settings.snippet.json +15 -0
  81. package/workflows/workflows/agent-environment-setup/platforms/claude/rules/CLAUDE.md +17 -8
  82. package/workflows/workflows/agent-environment-setup/platforms/claude/skills/deep-research/SKILL.md +95 -0
  83. package/workflows/workflows/agent-environment-setup/platforms/claude/skills/deep-research/evals/assertions.md +17 -0
  84. package/workflows/workflows/agent-environment-setup/platforms/claude/skills/deep-research/evals/evals.json +56 -0
  85. package/workflows/workflows/agent-environment-setup/platforms/claude/skills/deep-research/examples/01-latest-docs-check.md +12 -0
  86. package/workflows/workflows/agent-environment-setup/platforms/claude/skills/deep-research/examples/02-ecosystem-comparison.md +12 -0
  87. package/workflows/workflows/agent-environment-setup/platforms/claude/skills/deep-research/examples/03-research-to-implementation-handoff.md +12 -0
  88. package/workflows/workflows/agent-environment-setup/platforms/claude/skills/deep-research/references/comparison-checklist.md +57 -0
  89. package/workflows/workflows/agent-environment-setup/platforms/claude/skills/deep-research/references/research-output.md +69 -0
  90. package/workflows/workflows/agent-environment-setup/platforms/claude/skills/deep-research/references/source-ladder.md +81 -0
  91. package/workflows/workflows/agent-environment-setup/platforms/claude/skills/skills_index.json +66 -0
  92. package/workflows/workflows/agent-environment-setup/platforms/claude/skills/spec-driven-delivery/SKILL.md +66 -0
  93. package/workflows/workflows/agent-environment-setup/platforms/claude/workflows/architecture.md +80 -0
  94. package/workflows/workflows/agent-environment-setup/platforms/claude/workflows/backend.md +3 -0
  95. package/workflows/workflows/agent-environment-setup/platforms/claude/workflows/create.md +4 -1
  96. package/workflows/workflows/agent-environment-setup/platforms/claude/workflows/database.md +3 -0
  97. package/workflows/workflows/agent-environment-setup/platforms/claude/workflows/implement-track.md +7 -1
  98. package/workflows/workflows/agent-environment-setup/platforms/claude/workflows/migrate.md +4 -1
  99. package/workflows/workflows/agent-environment-setup/platforms/claude/workflows/mobile.md +3 -0
  100. package/workflows/workflows/agent-environment-setup/platforms/claude/workflows/onboard.md +4 -3
  101. package/workflows/workflows/agent-environment-setup/platforms/claude/workflows/orchestrate.md +8 -3
  102. package/workflows/workflows/agent-environment-setup/platforms/claude/workflows/plan.md +16 -6
  103. package/workflows/workflows/agent-environment-setup/platforms/claude/workflows/refactor.md +3 -0
  104. package/workflows/workflows/agent-environment-setup/platforms/claude/workflows/release.md +3 -0
  105. package/workflows/workflows/agent-environment-setup/platforms/claude/workflows/spec.md +79 -0
  106. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/backend-specialist.md +1 -1
  107. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/code-archaeologist.md +1 -1
  108. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/database-architect.md +1 -1
  109. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/debugger.md +1 -1
  110. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/devops-engineer.md +1 -1
  111. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/documentation-writer.md +1 -1
  112. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/frontend-specialist.md +1 -1
  113. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/game-developer.md +1 -1
  114. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/mobile-developer.md +1 -1
  115. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/orchestrator.md +7 -6
  116. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/penetration-tester.md +1 -1
  117. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/performance-optimizer.md +1 -1
  118. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/product-manager.md +1 -1
  119. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/project-planner.md +5 -4
  120. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/qa-automation-engineer.md +1 -1
  121. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/researcher.md +9 -5
  122. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/security-auditor.md +1 -1
  123. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/seo-specialist.md +1 -1
  124. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/sre-engineer.md +1 -1
  125. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/test-engineer.md +1 -1
  126. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/validator.md +1 -1
  127. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/vercel-expert.md +1 -1
  128. package/workflows/workflows/agent-environment-setup/platforms/codex/rules/AGENTS.md +15 -8
  129. package/workflows/workflows/agent-environment-setup/platforms/codex/skills/deep-research/SKILL.md +89 -0
  130. package/workflows/workflows/agent-environment-setup/platforms/codex/skills/deep-research/evals/assertions.md +17 -0
  131. package/workflows/workflows/agent-environment-setup/platforms/codex/skills/deep-research/evals/evals.json +56 -0
  132. package/workflows/workflows/agent-environment-setup/platforms/codex/skills/deep-research/examples/01-latest-docs-check.md +12 -0
  133. package/workflows/workflows/agent-environment-setup/platforms/codex/skills/deep-research/examples/02-ecosystem-comparison.md +12 -0
  134. package/workflows/workflows/agent-environment-setup/platforms/codex/skills/deep-research/examples/03-research-to-implementation-handoff.md +12 -0
  135. package/workflows/workflows/agent-environment-setup/platforms/codex/skills/deep-research/references/comparison-checklist.md +57 -0
  136. package/workflows/workflows/agent-environment-setup/platforms/codex/skills/deep-research/references/research-output.md +69 -0
  137. package/workflows/workflows/agent-environment-setup/platforms/codex/skills/deep-research/references/source-ladder.md +81 -0
  138. package/workflows/workflows/agent-environment-setup/platforms/codex/skills/spec-driven-delivery/SKILL.md +65 -0
  139. package/workflows/workflows/agent-environment-setup/platforms/codex/workflows/accessibility.md +1 -1
  140. package/workflows/workflows/agent-environment-setup/platforms/codex/workflows/architecture.md +82 -0
  141. package/workflows/workflows/agent-environment-setup/platforms/codex/workflows/backend.md +4 -1
  142. package/workflows/workflows/agent-environment-setup/platforms/codex/workflows/create.md +5 -2
  143. package/workflows/workflows/agent-environment-setup/platforms/codex/workflows/database.md +4 -1
  144. package/workflows/workflows/agent-environment-setup/platforms/codex/workflows/debug.md +1 -1
  145. package/workflows/workflows/agent-environment-setup/platforms/codex/workflows/devops.md +1 -1
  146. package/workflows/workflows/agent-environment-setup/platforms/codex/workflows/implement-track.md +8 -2
  147. package/workflows/workflows/agent-environment-setup/platforms/codex/workflows/migrate.md +5 -2
  148. package/workflows/workflows/agent-environment-setup/platforms/codex/workflows/mobile.md +4 -1
  149. package/workflows/workflows/agent-environment-setup/platforms/codex/workflows/onboard.md +5 -4
  150. package/workflows/workflows/agent-environment-setup/platforms/codex/workflows/orchestrate.md +9 -4
  151. package/workflows/workflows/agent-environment-setup/platforms/codex/workflows/plan.md +17 -7
  152. package/workflows/workflows/agent-environment-setup/platforms/codex/workflows/refactor.md +4 -1
  153. package/workflows/workflows/agent-environment-setup/platforms/codex/workflows/release.md +4 -1
  154. package/workflows/workflows/agent-environment-setup/platforms/codex/workflows/review.md +1 -1
  155. package/workflows/workflows/agent-environment-setup/platforms/codex/workflows/security.md +1 -1
  156. package/workflows/workflows/agent-environment-setup/platforms/codex/workflows/spec.md +81 -0
  157. package/workflows/workflows/agent-environment-setup/platforms/codex/workflows/test.md +1 -1
  158. package/workflows/workflows/agent-environment-setup/platforms/codex/workflows/vercel.md +1 -1
  159. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/orchestrator.md +6 -5
  160. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/project-planner.md +4 -3
  161. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/researcher.md +8 -4
  162. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-accessibility.prompt.md +9 -3
  163. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-architecture.prompt.md +18 -0
  164. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-backend.prompt.md +9 -3
  165. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-create.prompt.md +9 -3
  166. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-database.prompt.md +9 -3
  167. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-debug.prompt.md +9 -3
  168. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-devops.prompt.md +9 -3
  169. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-implement-track.prompt.md +9 -3
  170. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-migrate.prompt.md +9 -3
  171. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-mobile.prompt.md +9 -3
  172. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-onboard.prompt.md +9 -3
  173. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-orchestrate.prompt.md +9 -3
  174. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-plan.prompt.md +9 -3
  175. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-refactor.prompt.md +9 -3
  176. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-release.prompt.md +9 -3
  177. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-review.prompt.md +9 -3
  178. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-security.prompt.md +9 -3
  179. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-spec.prompt.md +18 -0
  180. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-test.prompt.md +9 -3
  181. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-vercel.prompt.md +9 -3
  182. package/workflows/workflows/agent-environment-setup/platforms/copilot/rules/copilot-instructions.md +15 -8
  183. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/deep-research/SKILL.md +94 -0
  184. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/deep-research/evals/assertions.md +17 -0
  185. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/deep-research/evals/evals.json +56 -0
  186. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/deep-research/examples/01-latest-docs-check.md +12 -0
  187. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/deep-research/examples/02-ecosystem-comparison.md +12 -0
  188. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/deep-research/examples/03-research-to-implementation-handoff.md +12 -0
  189. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/deep-research/references/comparison-checklist.md +57 -0
  190. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/deep-research/references/research-output.md +69 -0
  191. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/deep-research/references/source-ladder.md +81 -0
  192. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/skills_index.json +66 -0
  193. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/spec-driven-delivery/SKILL.md +70 -0
  194. package/workflows/workflows/agent-environment-setup/platforms/copilot/workflows/architecture.md +80 -0
  195. package/workflows/workflows/agent-environment-setup/platforms/copilot/workflows/backend.md +3 -0
  196. package/workflows/workflows/agent-environment-setup/platforms/copilot/workflows/create.md +4 -1
  197. package/workflows/workflows/agent-environment-setup/platforms/copilot/workflows/database.md +3 -0
  198. package/workflows/workflows/agent-environment-setup/platforms/copilot/workflows/implement-track.md +7 -1
  199. package/workflows/workflows/agent-environment-setup/platforms/copilot/workflows/migrate.md +4 -1
  200. package/workflows/workflows/agent-environment-setup/platforms/copilot/workflows/mobile.md +3 -0
  201. package/workflows/workflows/agent-environment-setup/platforms/copilot/workflows/onboard.md +4 -3
  202. package/workflows/workflows/agent-environment-setup/platforms/copilot/workflows/orchestrate.md +8 -3
  203. package/workflows/workflows/agent-environment-setup/platforms/copilot/workflows/plan.md +16 -6
  204. package/workflows/workflows/agent-environment-setup/platforms/copilot/workflows/refactor.md +3 -0
  205. package/workflows/workflows/agent-environment-setup/platforms/copilot/workflows/release.md +3 -0
  206. package/workflows/workflows/agent-environment-setup/platforms/copilot/workflows/spec.md +79 -0
  207. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/accessibility.toml +10 -3
  208. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/architecture.toml +19 -0
  209. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/backend.toml +10 -3
  210. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/create.toml +10 -3
  211. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/database.toml +10 -3
  212. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/debug.toml +10 -3
  213. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/devops.toml +10 -3
  214. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/implement-track.toml +10 -3
  215. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/migrate.toml +10 -3
  216. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/mobile.toml +10 -3
  217. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/onboard.toml +10 -3
  218. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/orchestrate.toml +10 -3
  219. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/plan.toml +10 -3
  220. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/refactor.toml +10 -3
  221. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/release.toml +10 -3
  222. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/review.toml +10 -3
  223. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/security.toml +10 -3
  224. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/spec.toml +19 -0
  225. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/test.toml +10 -3
  226. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/vercel.toml +10 -3
  227. package/workflows/workflows/agent-environment-setup/platforms/gemini/rules/GEMINI.md +15 -8
  228. package/workflows/workflows/agent-environment-setup/platforms/gemini/skills/deep-research/SKILL.md +89 -0
  229. package/workflows/workflows/agent-environment-setup/platforms/gemini/skills/deep-research/evals/assertions.md +17 -0
  230. package/workflows/workflows/agent-environment-setup/platforms/gemini/skills/deep-research/evals/evals.json +56 -0
  231. package/workflows/workflows/agent-environment-setup/platforms/gemini/skills/deep-research/examples/01-latest-docs-check.md +12 -0
  232. package/workflows/workflows/agent-environment-setup/platforms/gemini/skills/deep-research/examples/02-ecosystem-comparison.md +12 -0
  233. package/workflows/workflows/agent-environment-setup/platforms/gemini/skills/deep-research/examples/03-research-to-implementation-handoff.md +12 -0
  234. package/workflows/workflows/agent-environment-setup/platforms/gemini/skills/deep-research/references/comparison-checklist.md +57 -0
  235. package/workflows/workflows/agent-environment-setup/platforms/gemini/skills/deep-research/references/research-output.md +69 -0
  236. package/workflows/workflows/agent-environment-setup/platforms/gemini/skills/deep-research/references/source-ladder.md +81 -0
  237. package/workflows/workflows/agent-environment-setup/platforms/gemini/skills/spec-driven-delivery/SKILL.md +65 -0
  238. package/workflows/workflows/agent-environment-setup/platforms/gemini/workflows/architecture.md +82 -0
  239. package/workflows/workflows/agent-environment-setup/platforms/gemini/workflows/backend.md +3 -0
  240. package/workflows/workflows/agent-environment-setup/platforms/gemini/workflows/create.md +4 -1
  241. package/workflows/workflows/agent-environment-setup/platforms/gemini/workflows/database.md +3 -0
  242. package/workflows/workflows/agent-environment-setup/platforms/gemini/workflows/implement-track.md +7 -1
  243. package/workflows/workflows/agent-environment-setup/platforms/gemini/workflows/migrate.md +4 -1
  244. package/workflows/workflows/agent-environment-setup/platforms/gemini/workflows/mobile.md +3 -0
  245. package/workflows/workflows/agent-environment-setup/platforms/gemini/workflows/onboard.md +4 -3
  246. package/workflows/workflows/agent-environment-setup/platforms/gemini/workflows/orchestrate.md +8 -3
  247. package/workflows/workflows/agent-environment-setup/platforms/gemini/workflows/plan.md +16 -6
  248. package/workflows/workflows/agent-environment-setup/platforms/gemini/workflows/refactor.md +3 -0
  249. package/workflows/workflows/agent-environment-setup/platforms/gemini/workflows/release.md +3 -0
  250. package/workflows/workflows/agent-environment-setup/platforms/gemini/workflows/spec.md +81 -0
  251. package/workflows/workflows/agent-environment-setup/shared/agents/backend-specialist.md +5 -5
  252. package/workflows/workflows/agent-environment-setup/shared/agents/database-architect.md +3 -3
  253. package/workflows/workflows/agent-environment-setup/shared/agents/orchestrator.md +10 -9
  254. package/workflows/workflows/agent-environment-setup/shared/agents/penetration-tester.md +3 -3
  255. package/workflows/workflows/agent-environment-setup/shared/agents/product-manager.md +6 -6
  256. package/workflows/workflows/agent-environment-setup/shared/agents/project-planner.md +10 -9
  257. package/workflows/workflows/agent-environment-setup/shared/agents/researcher.md +13 -9
  258. package/workflows/workflows/agent-environment-setup/shared/agents/security-auditor.md +2 -2
  259. package/workflows/workflows/agent-environment-setup/shared/rules/STEERING.md +57 -13
  260. package/workflows/workflows/agent-environment-setup/shared/rules/overrides/claude.md +2 -0
  261. package/workflows/workflows/agent-environment-setup/shared/rules/overrides/codex.md +3 -3
  262. package/workflows/workflows/agent-environment-setup/shared/rules/overrides/gemini.md +20 -0
  263. package/workflows/workflows/agent-environment-setup/shared/workflows/architecture.md +80 -0
  264. package/workflows/workflows/agent-environment-setup/shared/workflows/backend.md +8 -5
  265. package/workflows/workflows/agent-environment-setup/shared/workflows/create.md +5 -2
  266. package/workflows/workflows/agent-environment-setup/shared/workflows/database.md +6 -3
  267. package/workflows/workflows/agent-environment-setup/shared/workflows/implement-track.md +12 -6
  268. package/workflows/workflows/agent-environment-setup/shared/workflows/migrate.md +7 -4
  269. package/workflows/workflows/agent-environment-setup/shared/workflows/mobile.md +3 -0
  270. package/workflows/workflows/agent-environment-setup/shared/workflows/onboard.md +6 -5
  271. package/workflows/workflows/agent-environment-setup/shared/workflows/orchestrate.md +10 -5
  272. package/workflows/workflows/agent-environment-setup/shared/workflows/plan.md +18 -8
  273. package/workflows/workflows/agent-environment-setup/shared/workflows/refactor.md +5 -2
  274. package/workflows/workflows/agent-environment-setup/shared/workflows/release.md +3 -0
  275. package/workflows/workflows/agent-environment-setup/shared/workflows/security.md +2 -2
  276. package/workflows/workflows/agent-environment-setup/shared/workflows/spec.md +79 -0
@@ -0,0 +1,18 @@
1
+ # Workflow Prompt: /architecture
2
+
3
+ Refresh the project architecture contract and current-state map in ENGINEERING_RULES.md and TECH.md with explicit structure, design-system, testing, and flow guidance.
4
+
5
+ Use this prompt with the matching workflow file:
6
+ - Workflow: ../copilot/workflows/architecture.md
7
+
8
+ Execution contract:
9
+ 1. Treat route selection as already resolved by this prompt; do not begin with skill discovery.
10
+ 2. Read `ENGINEERING_RULES.md` first and `TECH.md` next when they exist before non-trivial execution.
11
+ Attached skills:
12
+ - Load these exact skill IDs first: `architecture-doc`, `system-design`, `tech-doc`, `frontend-design`, `api-design`, `database-design`, `sadd`, `deep-research`.
13
+ - Local skill file hints if installed: `.github/skills/architecture-doc/SKILL.md`, `.github/skills/system-design/SKILL.md`, `.github/skills/tech-doc/SKILL.md`, `.github/skills/frontend-design/SKILL.md`, `.github/skills/api-design/SKILL.md`, `.github/skills/database-design/SKILL.md`, `.github/skills/sadd/SKILL.md`, `.github/skills/deep-research/SKILL.md`.
14
+ - Treat the skill bundle as already resolved for this workflow. Do not start with route discovery.
15
+ 3. Apply workflow sections in order: When to use, Workflow steps, Context notes, Verification.
16
+ 4. Route to the workflow's primary specialist and only add supporting specialists when needed.
17
+ 5. If freshness or public comparison matters, run `deep-research` before implementation and use official docs as primary evidence.
18
+ 6. Return actions taken, verification evidence, and any gaps.
@@ -7,6 +7,12 @@ Use this prompt with the matching workflow file:
7
7
 
8
8
  Execution contract:
9
9
  1. Treat route selection as already resolved by this prompt; do not begin with skill discovery.
10
- 2. Apply workflow sections in order: When to use, Workflow steps, Context notes, Verification.
11
- 3. Route to the workflow's primary specialist and only add supporting specialists when needed.
12
- 4. Return actions taken, verification evidence, and any gaps.
10
+ 2. Read `ENGINEERING_RULES.md` first and `TECH.md` next when they exist before non-trivial execution.
11
+ Attached skills:
12
+ - Load these exact skill IDs first: `api-design`, `javascript-best-practices`, `owasp-security-review`, `database-design`, `nestjs`, `fastapi`, `microservices-design`, `drizzle-orm`, `stripe-integration`, `ci-cd-pipeline`, `frontend-design`, `typescript-best-practices`, `python-best-practices`, `golang-best-practices`.
13
+ - Local skill file hints if installed: `.github/skills/api-design/SKILL.md`, `.github/skills/javascript-best-practices/SKILL.md`, `.github/skills/owasp-security-review/SKILL.md`, `.github/skills/database-design/SKILL.md`, `.github/skills/nestjs/SKILL.md`, `.github/skills/fastapi/SKILL.md`, `.github/skills/microservices-design/SKILL.md`, `.github/skills/drizzle-orm/SKILL.md`.
14
+ - Treat the skill bundle as already resolved for this workflow. Do not start with route discovery.
15
+ 3. Apply workflow sections in order: When to use, Workflow steps, Context notes, Verification.
16
+ 4. Route to the workflow's primary specialist and only add supporting specialists when needed.
17
+ 5. If freshness or public comparison matters, run `deep-research` before implementation and use official docs as primary evidence.
18
+ 6. Return actions taken, verification evidence, and any gaps.
@@ -7,6 +7,12 @@ Use this prompt with the matching workflow file:
7
7
 
8
8
  Execution contract:
9
9
  1. Treat route selection as already resolved by this prompt; do not begin with skill discovery.
10
- 2. Apply workflow sections in order: When to use, Workflow steps, Context notes, Verification.
11
- 3. Route to the workflow's primary specialist and only add supporting specialists when needed.
12
- 4. Return actions taken, verification evidence, and any gaps.
10
+ 2. Read `ENGINEERING_RULES.md` first and `TECH.md` next when they exist before non-trivial execution.
11
+ Attached skills:
12
+ - Load these exact skill IDs first: `typescript-best-practices`, `javascript-best-practices`, `python-best-practices`, `golang-best-practices`, `java-best-practices`, `csharp-best-practices`, `kotlin-best-practices`, `rust-best-practices`, `php-best-practices`, `expo-app`, `swift-best-practices`, `api-design`, `nestjs`, `fastapi`, `drizzle-orm`, `database-design`, `mcp-server-builder`, `stitch`, `react`, `nextjs`, `frontend-design`, `performance-testing`, `skill-creator`, `stripe-integration`, `ci-cd-pipeline`.
13
+ - Local skill file hints if installed: `.github/skills/typescript-best-practices/SKILL.md`, `.github/skills/javascript-best-practices/SKILL.md`, `.github/skills/python-best-practices/SKILL.md`, `.github/skills/golang-best-practices/SKILL.md`, `.github/skills/java-best-practices/SKILL.md`, `.github/skills/csharp-best-practices/SKILL.md`, `.github/skills/kotlin-best-practices/SKILL.md`, `.github/skills/rust-best-practices/SKILL.md`.
14
+ - Treat the skill bundle as already resolved for this workflow. Do not start with route discovery.
15
+ 3. Apply workflow sections in order: When to use, Workflow steps, Context notes, Verification.
16
+ 4. Route to the workflow's primary specialist and only add supporting specialists when needed.
17
+ 5. If freshness or public comparison matters, run `deep-research` before implementation and use official docs as primary evidence.
18
+ 6. Return actions taken, verification evidence, and any gaps.
@@ -7,6 +7,12 @@ Use this prompt with the matching workflow file:
7
7
 
8
8
  Execution contract:
9
9
  1. Treat route selection as already resolved by this prompt; do not begin with skill discovery.
10
- 2. Apply workflow sections in order: When to use, Workflow steps, Context notes, Verification.
11
- 3. Route to the workflow's primary specialist and only add supporting specialists when needed.
12
- 4. Return actions taken, verification evidence, and any gaps.
10
+ 2. Read `ENGINEERING_RULES.md` first and `TECH.md` next when they exist before non-trivial execution.
11
+ Attached skills:
12
+ - Load these exact skill IDs first: `database-design`, `drizzle-orm`, `typescript-best-practices`, `javascript-best-practices`, `python-best-practices`.
13
+ - Local skill file hints if installed: `.github/skills/database-design/SKILL.md`, `.github/skills/drizzle-orm/SKILL.md`, `.github/skills/typescript-best-practices/SKILL.md`, `.github/skills/javascript-best-practices/SKILL.md`, `.github/skills/python-best-practices/SKILL.md`.
14
+ - Treat the skill bundle as already resolved for this workflow. Do not start with route discovery.
15
+ 3. Apply workflow sections in order: When to use, Workflow steps, Context notes, Verification.
16
+ 4. Route to the workflow's primary specialist and only add supporting specialists when needed.
17
+ 5. If freshness or public comparison matters, run `deep-research` before implementation and use official docs as primary evidence.
18
+ 6. Return actions taken, verification evidence, and any gaps.
@@ -7,6 +7,12 @@ Use this prompt with the matching workflow file:
7
7
 
8
8
  Execution contract:
9
9
  1. Treat route selection as already resolved by this prompt; do not begin with skill discovery.
10
- 2. Apply workflow sections in order: When to use, Workflow steps, Context notes, Verification.
11
- 3. Route to the workflow's primary specialist and only add supporting specialists when needed.
12
- 4. Return actions taken, verification evidence, and any gaps.
10
+ 2. Read `ENGINEERING_RULES.md` first and `TECH.md` next when they exist before non-trivial execution.
11
+ Attached skills:
12
+ - Load these exact skill IDs first: `systematic-debugging`, `observability`, `unit-testing`, `typescript-best-practices`, `javascript-best-practices`, `python-best-practices`, `golang-best-practices`, `java-best-practices`, `csharp-best-practices`, `kotlin-best-practices`, `rust-best-practices`, `integration-testing`, `playwright-interactive`, `skill-creator`.
13
+ - Local skill file hints if installed: `.github/skills/systematic-debugging/SKILL.md`, `.github/skills/observability/SKILL.md`, `.github/skills/unit-testing/SKILL.md`, `.github/skills/typescript-best-practices/SKILL.md`, `.github/skills/javascript-best-practices/SKILL.md`, `.github/skills/python-best-practices/SKILL.md`, `.github/skills/golang-best-practices/SKILL.md`, `.github/skills/java-best-practices/SKILL.md`.
14
+ - Treat the skill bundle as already resolved for this workflow. Do not start with route discovery.
15
+ 3. Apply workflow sections in order: When to use, Workflow steps, Context notes, Verification.
16
+ 4. Route to the workflow's primary specialist and only add supporting specialists when needed.
17
+ 5. If freshness or public comparison matters, run `deep-research` before implementation and use official docs as primary evidence.
18
+ 6. Return actions taken, verification evidence, and any gaps.
@@ -7,6 +7,12 @@ Use this prompt with the matching workflow file:
7
7
 
8
8
  Execution contract:
9
9
  1. Treat route selection as already resolved by this prompt; do not begin with skill discovery.
10
- 2. Apply workflow sections in order: When to use, Workflow steps, Context notes, Verification.
11
- 3. Route to the workflow's primary specialist and only add supporting specialists when needed.
12
- 4. Return actions taken, verification evidence, and any gaps.
10
+ 2. Read `ENGINEERING_RULES.md` first and `TECH.md` next when they exist before non-trivial execution.
11
+ Attached skills:
12
+ - Load these exact skill IDs first: `ci-cd-pipeline`, `kubernetes-deploy`, `observability`, `git-workflow`, `systematic-debugging`, `typescript-best-practices`, `javascript-best-practices`, `python-best-practices`, `golang-best-practices`.
13
+ - Local skill file hints if installed: `.github/skills/ci-cd-pipeline/SKILL.md`, `.github/skills/kubernetes-deploy/SKILL.md`, `.github/skills/observability/SKILL.md`, `.github/skills/git-workflow/SKILL.md`, `.github/skills/systematic-debugging/SKILL.md`, `.github/skills/typescript-best-practices/SKILL.md`, `.github/skills/javascript-best-practices/SKILL.md`, `.github/skills/python-best-practices/SKILL.md`.
14
+ - Treat the skill bundle as already resolved for this workflow. Do not start with route discovery.
15
+ 3. Apply workflow sections in order: When to use, Workflow steps, Context notes, Verification.
16
+ 4. Route to the workflow's primary specialist and only add supporting specialists when needed.
17
+ 5. If freshness or public comparison matters, run `deep-research` before implementation and use official docs as primary evidence.
18
+ 6. Return actions taken, verification evidence, and any gaps.
@@ -7,6 +7,12 @@ Use this prompt with the matching workflow file:
7
7
 
8
8
  Execution contract:
9
9
  1. Treat route selection as already resolved by this prompt; do not begin with skill discovery.
10
- 2. Apply workflow sections in order: When to use, Workflow steps, Context notes, Verification.
11
- 3. Route to the workflow's primary specialist and only add supporting specialists when needed.
12
- 4. Return actions taken, verification evidence, and any gaps.
10
+ 2. Read `ENGINEERING_RULES.md` first and `TECH.md` next when they exist before non-trivial execution.
11
+ Attached skills:
12
+ - Load these exact skill IDs first: `system-design`, `api-design`, `database-design`, `typescript-best-practices`, `javascript-best-practices`, `python-best-practices`, `golang-best-practices`, `react`, `nextjs`.
13
+ - Local skill file hints if installed: `.github/skills/system-design/SKILL.md`, `.github/skills/api-design/SKILL.md`, `.github/skills/database-design/SKILL.md`, `.github/skills/typescript-best-practices/SKILL.md`, `.github/skills/javascript-best-practices/SKILL.md`, `.github/skills/python-best-practices/SKILL.md`, `.github/skills/golang-best-practices/SKILL.md`, `.github/skills/react/SKILL.md`.
14
+ - Treat the skill bundle as already resolved for this workflow. Do not start with route discovery.
15
+ 3. Apply workflow sections in order: When to use, Workflow steps, Context notes, Verification.
16
+ 4. Route to the workflow's primary specialist and only add supporting specialists when needed.
17
+ 5. If freshness or public comparison matters, run `deep-research` before implementation and use official docs as primary evidence.
18
+ 6. Return actions taken, verification evidence, and any gaps.
@@ -7,6 +7,12 @@ Use this prompt with the matching workflow file:
7
7
 
8
8
  Execution contract:
9
9
  1. Treat route selection as already resolved by this prompt; do not begin with skill discovery.
10
- 2. Apply workflow sections in order: When to use, Workflow steps, Context notes, Verification.
11
- 3. Route to the workflow's primary specialist and only add supporting specialists when needed.
12
- 4. Return actions taken, verification evidence, and any gaps.
10
+ 2. Read `ENGINEERING_RULES.md` first and `TECH.md` next when they exist before non-trivial execution.
11
+ Attached skills:
12
+ - Load these exact skill IDs first: `system-design`, `code-review`, `unit-testing`, `typescript-best-practices`, `javascript-best-practices`, `python-best-practices`, `golang-best-practices`.
13
+ - Local skill file hints if installed: `.github/skills/system-design/SKILL.md`, `.github/skills/code-review/SKILL.md`, `.github/skills/unit-testing/SKILL.md`, `.github/skills/typescript-best-practices/SKILL.md`, `.github/skills/javascript-best-practices/SKILL.md`, `.github/skills/python-best-practices/SKILL.md`, `.github/skills/golang-best-practices/SKILL.md`.
14
+ - Treat the skill bundle as already resolved for this workflow. Do not start with route discovery.
15
+ 3. Apply workflow sections in order: When to use, Workflow steps, Context notes, Verification.
16
+ 4. Route to the workflow's primary specialist and only add supporting specialists when needed.
17
+ 5. If freshness or public comparison matters, run `deep-research` before implementation and use official docs as primary evidence.
18
+ 6. Return actions taken, verification evidence, and any gaps.
@@ -7,6 +7,12 @@ Use this prompt with the matching workflow file:
7
7
 
8
8
  Execution contract:
9
9
  1. Treat route selection as already resolved by this prompt; do not begin with skill discovery.
10
- 2. Apply workflow sections in order: When to use, Workflow steps, Context notes, Verification.
11
- 3. Route to the workflow's primary specialist and only add supporting specialists when needed.
12
- 4. Return actions taken, verification evidence, and any gaps.
10
+ 2. Read `ENGINEERING_RULES.md` first and `TECH.md` next when they exist before non-trivial execution.
11
+ Attached skills:
12
+ - Load these exact skill IDs first: `expo-app`, `react-native`, `stitch`, `frontend-design`, `swift-best-practices`, `kotlin-best-practices`.
13
+ - Local skill file hints if installed: `.github/skills/expo-app/SKILL.md`, `.github/skills/react-native/SKILL.md`, `.github/skills/stitch/SKILL.md`, `.github/skills/frontend-design/SKILL.md`, `.github/skills/swift-best-practices/SKILL.md`, `.github/skills/kotlin-best-practices/SKILL.md`.
14
+ - Treat the skill bundle as already resolved for this workflow. Do not start with route discovery.
15
+ 3. Apply workflow sections in order: When to use, Workflow steps, Context notes, Verification.
16
+ 4. Route to the workflow's primary specialist and only add supporting specialists when needed.
17
+ 5. If freshness or public comparison matters, run `deep-research` before implementation and use official docs as primary evidence.
18
+ 6. Return actions taken, verification evidence, and any gaps.
@@ -7,6 +7,12 @@ Use this prompt with the matching workflow file:
7
7
 
8
8
  Execution contract:
9
9
  1. Treat route selection as already resolved by this prompt; do not begin with skill discovery.
10
- 2. Apply workflow sections in order: When to use, Workflow steps, Context notes, Verification.
11
- 3. Route to the workflow's primary specialist and only add supporting specialists when needed.
12
- 4. Return actions taken, verification evidence, and any gaps.
10
+ 2. Read `ENGINEERING_RULES.md` first and `TECH.md` next when they exist before non-trivial execution.
11
+ Attached skills:
12
+ - Load these exact skill IDs first: `deep-research`, `system-design`, `database-design`, `typescript-best-practices`, `javascript-best-practices`, `python-best-practices`.
13
+ - Local skill file hints if installed: `.github/skills/deep-research/SKILL.md`, `.github/skills/system-design/SKILL.md`, `.github/skills/database-design/SKILL.md`, `.github/skills/typescript-best-practices/SKILL.md`, `.github/skills/javascript-best-practices/SKILL.md`, `.github/skills/python-best-practices/SKILL.md`.
14
+ - Treat the skill bundle as already resolved for this workflow. Do not start with route discovery.
15
+ 3. Apply workflow sections in order: When to use, Workflow steps, Context notes, Verification.
16
+ 4. Route to the workflow's primary specialist and only add supporting specialists when needed.
17
+ 5. If freshness or public comparison matters, run `deep-research` before implementation and use official docs as primary evidence.
18
+ 6. Return actions taken, verification evidence, and any gaps.
@@ -7,6 +7,12 @@ Use this prompt with the matching workflow file:
7
7
 
8
8
  Execution contract:
9
9
  1. Treat route selection as already resolved by this prompt; do not begin with skill discovery.
10
- 2. Apply workflow sections in order: When to use, Workflow steps, Context notes, Verification.
11
- 3. Route to the workflow's primary specialist and only add supporting specialists when needed.
12
- 4. Return actions taken, verification evidence, and any gaps.
10
+ 2. Read `ENGINEERING_RULES.md` first and `TECH.md` next when they exist before non-trivial execution.
11
+ Attached skills:
12
+ - Load these exact skill IDs first: `system-design`, `api-design`, `database-design`, `deep-research`, `mcp-server-builder`, `tech-doc`, `prompt-engineering`, `skill-creator`.
13
+ - Local skill file hints if installed: `.github/skills/system-design/SKILL.md`, `.github/skills/api-design/SKILL.md`, `.github/skills/database-design/SKILL.md`, `.github/skills/deep-research/SKILL.md`, `.github/skills/mcp-server-builder/SKILL.md`, `.github/skills/tech-doc/SKILL.md`, `.github/skills/prompt-engineering/SKILL.md`, `.github/skills/skill-creator/SKILL.md`.
14
+ - Treat the skill bundle as already resolved for this workflow. Do not start with route discovery.
15
+ 3. Apply workflow sections in order: When to use, Workflow steps, Context notes, Verification.
16
+ 4. Route to the workflow's primary specialist and only add supporting specialists when needed.
17
+ 5. If freshness or public comparison matters, run `deep-research` before implementation and use official docs as primary evidence.
18
+ 6. Return actions taken, verification evidence, and any gaps.
@@ -7,6 +7,12 @@ Use this prompt with the matching workflow file:
7
7
 
8
8
  Execution contract:
9
9
  1. Treat route selection as already resolved by this prompt; do not begin with skill discovery.
10
- 2. Apply workflow sections in order: When to use, Workflow steps, Context notes, Verification.
11
- 3. Route to the workflow's primary specialist and only add supporting specialists when needed.
12
- 4. Return actions taken, verification evidence, and any gaps.
10
+ 2. Read `ENGINEERING_RULES.md` first and `TECH.md` next when they exist before non-trivial execution.
11
+ Attached skills:
12
+ - Load these exact skill IDs first: `system-design`, `api-design`, `database-design`, `deep-research`, `mcp-server-builder`, `tech-doc`, `prompt-engineering`, `skill-creator`.
13
+ - Local skill file hints if installed: `.github/skills/system-design/SKILL.md`, `.github/skills/api-design/SKILL.md`, `.github/skills/database-design/SKILL.md`, `.github/skills/deep-research/SKILL.md`, `.github/skills/mcp-server-builder/SKILL.md`, `.github/skills/tech-doc/SKILL.md`, `.github/skills/prompt-engineering/SKILL.md`, `.github/skills/skill-creator/SKILL.md`.
14
+ - Treat the skill bundle as already resolved for this workflow. Do not start with route discovery.
15
+ 3. Apply workflow sections in order: When to use, Workflow steps, Context notes, Verification.
16
+ 4. Route to the workflow's primary specialist and only add supporting specialists when needed.
17
+ 5. If freshness or public comparison matters, run `deep-research` before implementation and use official docs as primary evidence.
18
+ 6. Return actions taken, verification evidence, and any gaps.
@@ -7,6 +7,12 @@ Use this prompt with the matching workflow file:
7
7
 
8
8
  Execution contract:
9
9
  1. Treat route selection as already resolved by this prompt; do not begin with skill discovery.
10
- 2. Apply workflow sections in order: When to use, Workflow steps, Context notes, Verification.
11
- 3. Route to the workflow's primary specialist and only add supporting specialists when needed.
12
- 4. Return actions taken, verification evidence, and any gaps.
10
+ 2. Read `ENGINEERING_RULES.md` first and `TECH.md` next when they exist before non-trivial execution.
11
+ Attached skills:
12
+ - Load these exact skill IDs first: `code-review`, `system-design`, `unit-testing`, `typescript-best-practices`, `javascript-best-practices`, `python-best-practices`, `golang-best-practices`.
13
+ - Local skill file hints if installed: `.github/skills/code-review/SKILL.md`, `.github/skills/system-design/SKILL.md`, `.github/skills/unit-testing/SKILL.md`, `.github/skills/typescript-best-practices/SKILL.md`, `.github/skills/javascript-best-practices/SKILL.md`, `.github/skills/python-best-practices/SKILL.md`, `.github/skills/golang-best-practices/SKILL.md`.
14
+ - Treat the skill bundle as already resolved for this workflow. Do not start with route discovery.
15
+ 3. Apply workflow sections in order: When to use, Workflow steps, Context notes, Verification.
16
+ 4. Route to the workflow's primary specialist and only add supporting specialists when needed.
17
+ 5. If freshness or public comparison matters, run `deep-research` before implementation and use official docs as primary evidence.
18
+ 6. Return actions taken, verification evidence, and any gaps.
@@ -7,6 +7,12 @@ Use this prompt with the matching workflow file:
7
7
 
8
8
  Execution contract:
9
9
  1. Treat route selection as already resolved by this prompt; do not begin with skill discovery.
10
- 2. Apply workflow sections in order: When to use, Workflow steps, Context notes, Verification.
11
- 3. Route to the workflow's primary specialist and only add supporting specialists when needed.
12
- 4. Return actions taken, verification evidence, and any gaps.
10
+ 2. Read `ENGINEERING_RULES.md` first and `TECH.md` next when they exist before non-trivial execution.
11
+ Attached skills:
12
+ - Load these exact skill IDs first: `ci-cd-pipeline`, `git-workflow`, `tech-doc`, `observability`, `kubernetes-deploy`, `typescript-best-practices`, `javascript-best-practices`.
13
+ - Local skill file hints if installed: `.github/skills/ci-cd-pipeline/SKILL.md`, `.github/skills/git-workflow/SKILL.md`, `.github/skills/tech-doc/SKILL.md`, `.github/skills/observability/SKILL.md`, `.github/skills/kubernetes-deploy/SKILL.md`, `.github/skills/typescript-best-practices/SKILL.md`, `.github/skills/javascript-best-practices/SKILL.md`.
14
+ - Treat the skill bundle as already resolved for this workflow. Do not start with route discovery.
15
+ 3. Apply workflow sections in order: When to use, Workflow steps, Context notes, Verification.
16
+ 4. Route to the workflow's primary specialist and only add supporting specialists when needed.
17
+ 5. If freshness or public comparison matters, run `deep-research` before implementation and use official docs as primary evidence.
18
+ 6. Return actions taken, verification evidence, and any gaps.
@@ -7,6 +7,12 @@ Use this prompt with the matching workflow file:
7
7
 
8
8
  Execution contract:
9
9
  1. Treat route selection as already resolved by this prompt; do not begin with skill discovery.
10
- 2. Apply workflow sections in order: When to use, Workflow steps, Context notes, Verification.
11
- 3. Route to the workflow's primary specialist and only add supporting specialists when needed.
12
- 4. Return actions taken, verification evidence, and any gaps.
10
+ 2. Read `ENGINEERING_RULES.md` first and `TECH.md` next when they exist before non-trivial execution.
11
+ Attached skills:
12
+ - Load these exact skill IDs first: `code-review`, `unit-testing`, `owasp-security-review`, `performance-testing`, `react`, `nextjs`, `typescript-best-practices`, `javascript-best-practices`, `python-best-practices`, `golang-best-practices`.
13
+ - Local skill file hints if installed: `.github/skills/code-review/SKILL.md`, `.github/skills/unit-testing/SKILL.md`, `.github/skills/owasp-security-review/SKILL.md`, `.github/skills/performance-testing/SKILL.md`, `.github/skills/react/SKILL.md`, `.github/skills/nextjs/SKILL.md`, `.github/skills/typescript-best-practices/SKILL.md`, `.github/skills/javascript-best-practices/SKILL.md`.
14
+ - Treat the skill bundle as already resolved for this workflow. Do not start with route discovery.
15
+ 3. Apply workflow sections in order: When to use, Workflow steps, Context notes, Verification.
16
+ 4. Route to the workflow's primary specialist and only add supporting specialists when needed.
17
+ 5. If freshness or public comparison matters, run `deep-research` before implementation and use official docs as primary evidence.
18
+ 6. Return actions taken, verification evidence, and any gaps.
@@ -7,6 +7,12 @@ Use this prompt with the matching workflow file:
7
7
 
8
8
  Execution contract:
9
9
  1. Treat route selection as already resolved by this prompt; do not begin with skill discovery.
10
- 2. Apply workflow sections in order: When to use, Workflow steps, Context notes, Verification.
11
- 3. Route to the workflow's primary specialist and only add supporting specialists when needed.
12
- 4. Return actions taken, verification evidence, and any gaps.
10
+ 2. Read `ENGINEERING_RULES.md` first and `TECH.md` next when they exist before non-trivial execution.
11
+ Attached skills:
12
+ - Load these exact skill IDs first: `owasp-security-review`, `code-review`, `api-design`, `typescript-best-practices`, `javascript-best-practices`, `python-best-practices`, `golang-best-practices`, `rust-best-practices`.
13
+ - Local skill file hints if installed: `.github/skills/owasp-security-review/SKILL.md`, `.github/skills/code-review/SKILL.md`, `.github/skills/api-design/SKILL.md`, `.github/skills/typescript-best-practices/SKILL.md`, `.github/skills/javascript-best-practices/SKILL.md`, `.github/skills/python-best-practices/SKILL.md`, `.github/skills/golang-best-practices/SKILL.md`, `.github/skills/rust-best-practices/SKILL.md`.
14
+ - Treat the skill bundle as already resolved for this workflow. Do not start with route discovery.
15
+ 3. Apply workflow sections in order: When to use, Workflow steps, Context notes, Verification.
16
+ 4. Route to the workflow's primary specialist and only add supporting specialists when needed.
17
+ 5. If freshness or public comparison matters, run `deep-research` before implementation and use official docs as primary evidence.
18
+ 6. Return actions taken, verification evidence, and any gaps.
@@ -0,0 +1,18 @@
1
+ # Workflow Prompt: /spec
2
+
3
+ Create or refresh a Git-tracked spec pack for non-trivial work, including acceptance criteria, traceability, architecture impact, and next-route handoff.
4
+
5
+ Use this prompt with the matching workflow file:
6
+ - Workflow: ../copilot/workflows/spec.md
7
+
8
+ Execution contract:
9
+ 1. Treat route selection as already resolved by this prompt; do not begin with skill discovery.
10
+ 2. Read `ENGINEERING_RULES.md` first and `TECH.md` next when they exist before non-trivial execution.
11
+ Attached skills:
12
+ - Load these exact skill IDs first: `spec-driven-delivery`, `sadd`, `system-design`, `architecture-doc`, `deep-research`, `api-design`, `database-design`, `tech-doc`.
13
+ - Local skill file hints if installed: `.github/skills/spec-driven-delivery/SKILL.md`, `.github/skills/sadd/SKILL.md`, `.github/skills/system-design/SKILL.md`, `.github/skills/architecture-doc/SKILL.md`, `.github/skills/deep-research/SKILL.md`, `.github/skills/api-design/SKILL.md`, `.github/skills/database-design/SKILL.md`, `.github/skills/tech-doc/SKILL.md`.
14
+ - Treat the skill bundle as already resolved for this workflow. Do not start with route discovery.
15
+ 3. Apply workflow sections in order: When to use, Workflow steps, Context notes, Verification.
16
+ 4. Route to the workflow's primary specialist and only add supporting specialists when needed.
17
+ 5. If freshness or public comparison matters, run `deep-research` before implementation and use official docs as primary evidence.
18
+ 6. Return actions taken, verification evidence, and any gaps.
@@ -7,6 +7,12 @@ Use this prompt with the matching workflow file:
7
7
 
8
8
  Execution contract:
9
9
  1. Treat route selection as already resolved by this prompt; do not begin with skill discovery.
10
- 2. Apply workflow sections in order: When to use, Workflow steps, Context notes, Verification.
11
- 3. Route to the workflow's primary specialist and only add supporting specialists when needed.
12
- 4. Return actions taken, verification evidence, and any gaps.
10
+ 2. Read `ENGINEERING_RULES.md` first and `TECH.md` next when they exist before non-trivial execution.
11
+ Attached skills:
12
+ - Load these exact skill IDs first: `unit-testing`, `integration-testing`, `playwright-interactive`, `observability`, `systematic-debugging`, `code-review`, `typescript-best-practices`, `javascript-best-practices`, `python-best-practices`, `golang-best-practices`, `java-best-practices`.
13
+ - Local skill file hints if installed: `.github/skills/unit-testing/SKILL.md`, `.github/skills/integration-testing/SKILL.md`, `.github/skills/playwright-interactive/SKILL.md`, `.github/skills/observability/SKILL.md`, `.github/skills/systematic-debugging/SKILL.md`, `.github/skills/code-review/SKILL.md`, `.github/skills/typescript-best-practices/SKILL.md`, `.github/skills/javascript-best-practices/SKILL.md`.
14
+ - Treat the skill bundle as already resolved for this workflow. Do not start with route discovery.
15
+ 3. Apply workflow sections in order: When to use, Workflow steps, Context notes, Verification.
16
+ 4. Route to the workflow's primary specialist and only add supporting specialists when needed.
17
+ 5. If freshness or public comparison matters, run `deep-research` before implementation and use official docs as primary evidence.
18
+ 6. Return actions taken, verification evidence, and any gaps.
@@ -7,6 +7,12 @@ Use this prompt with the matching workflow file:
7
7
 
8
8
  Execution contract:
9
9
  1. Treat route selection as already resolved by this prompt; do not begin with skill discovery.
10
- 2. Apply workflow sections in order: When to use, Workflow steps, Context notes, Verification.
11
- 3. Route to the workflow's primary specialist and only add supporting specialists when needed.
12
- 4. Return actions taken, verification evidence, and any gaps.
10
+ 2. Read `ENGINEERING_RULES.md` first and `TECH.md` next when they exist before non-trivial execution.
11
+ Attached skills:
12
+ - Load these exact skill IDs first: `nextjs`, `ci-cd-pipeline`, `performance-testing`, `react`, `frontend-design`, `javascript-best-practices`, `typescript-best-practices`.
13
+ - Local skill file hints if installed: `.github/skills/nextjs/SKILL.md`, `.github/skills/ci-cd-pipeline/SKILL.md`, `.github/skills/performance-testing/SKILL.md`, `.github/skills/react/SKILL.md`, `.github/skills/frontend-design/SKILL.md`, `.github/skills/javascript-best-practices/SKILL.md`, `.github/skills/typescript-best-practices/SKILL.md`.
14
+ - Treat the skill bundle as already resolved for this workflow. Do not start with route discovery.
15
+ 3. Apply workflow sections in order: When to use, Workflow steps, Context notes, Verification.
16
+ 4. Route to the workflow's primary specialist and only add supporting specialists when needed.
17
+ 5. If freshness or public comparison matters, run `deep-research` before implementation and use official docs as primary evidence.
18
+ 6. Return actions taken, verification evidence, and any gaps.
@@ -44,7 +44,7 @@ Execute this tree top-to-bottom. Stop at the **first match**. Never skip levels.
44
44
  ├─ [TRIVIAL] Single-step, obvious, reversible?
45
45
  │ → Execute directly. No routing. Stop.
46
46
 
47
- ├─ [EXPLICIT] User named a prompt, workflow, or @agent?
47
+ ├─ [EXPLICIT] User named a prompt, workflow, @agent, or exact skill?
48
48
  │ → Honor that route exactly. Stop.
49
49
 
50
50
  ├─ [SINGLE-DOMAIN] Multi-step but contained in one specialty?
@@ -64,6 +64,7 @@ Execute this tree top-to-bottom. Stop at the **first match**. Never skip levels.
64
64
  **Hard rules:**
65
65
 
66
66
  - Never pre-load skills before route resolution.
67
+ - If the user names an exact skill ID, run `skill_validate` on that ID before `route_resolve`.
67
68
  - Never invoke an agent when direct execution suffices.
68
69
  - Never chain more than one `skill_search` per request.
69
70
  - Codex compatibility aliases (`$workflow-*`, `$agent-*`) are not native Copilot surfaces — treat as hints only.
@@ -367,6 +368,7 @@ Use this matrix to match incoming tasks to the correct skill and primary agent.
367
368
  | docker-compose-dev | DevOps | Docker Compose local dev environments | @devops-engineer |
368
369
  | kubernetes-deploy | DevOps | K8s manifests, Helm charts, deployment | @devops-engineer |
369
370
  | observability | DevOps | Logging, metrics, tracing, alerting | @devops-engineer |
371
+ | deep-research | Research | Latest docs, public comparisons, external verification | @researcher |
370
372
  | llm-eval | AI/ML | LLM evaluation, benchmarking, evals | @researcher |
371
373
  | rag-patterns | AI/ML | RAG architecture, embeddings, retrieval | @researcher |
372
374
  | prompt-engineering | AI/ML | Prompt design, few-shot, chain-of-thought | @researcher |
@@ -414,12 +416,17 @@ Selection policy:
414
416
  Keep MCP context lazy and exact. Skills are supporting context, not the route layer.
415
417
 
416
418
  1. Never begin with `skill_search`. Inspect the repo/task locally first.
417
- 2. Resolve workflows, agents, or free-text route intent with `route_resolve` before loading any skills.
418
- 3. If the route is still unresolved and local grounding leaves the domain unclear, use one narrow `skill_search`.
419
- 4. Always run `skill_validate` on the exact selected ID before `skill_get`.
420
- 5. Call `skill_get` with `includeReferences:false` by default.
421
- 6. Load at most one sidecar markdown file at a time with `skill_get_reference`.
422
- 7. Do not auto-prime every specialist with a skill. Load only what the task clearly needs.
423
- 8. Use upstream MCP servers such as `postman`, `stitch`, or `playwright` for real cloud/browser actions when available.
419
+ 2. If the user already named `/workflow`, `@agent`, or an exact skill ID, honor it directly. For exact skills, run `skill_validate` first and skip `route_resolve` when valid.
420
+ 3. Resolve only free-text workflow/agent intent with `route_resolve` before loading non-explicit skills.
421
+ 4. If the route is still unresolved and local grounding leaves the domain unclear, use one narrow `skill_search`.
422
+ 5. Always run `skill_validate` on the exact selected ID before `skill_get`.
423
+ 6. Call `skill_get` with `includeReferences:false` by default.
424
+ 7. Load at most one sidecar markdown file at a time with `skill_get_reference`.
425
+ 8. Do not auto-prime every specialist with a skill. Load only what the task clearly needs.
426
+ 9. For research: repo/local evidence first, official docs next, Reddit/community only as labeled secondary evidence.
427
+ 10. Escalate to research only when freshness matters, public comparison matters, or the user explicitly asks to research/verify.
428
+ 11. For non-trivial work, read `ENGINEERING_RULES.md` first and `TECH.md` next when they exist.
429
+ 12. If those docs declare architecture or design-system rules, follow them unless the current spec or task explicitly changes them.
430
+ 13. Use upstream MCP servers such as `postman`, `stitch`, or `playwright` for real cloud/browser actions when available.
424
431
 
425
432
  <!-- cbx:mcp:auto:end -->
@@ -0,0 +1,94 @@
1
+ ---
2
+ name: deep-research
3
+ description: Use when investigating latest vendor behavior, comparing tools or platforms, verifying claims beyond the repo, or gathering external evidence before implementation.
4
+ license: MIT
5
+ metadata:
6
+ author: cubis-foundry
7
+ version: "1.0"
8
+ compatibility: Claude Code, Codex, GitHub Copilot
9
+ ---
10
+ # Deep Research
11
+
12
+ ## Purpose
13
+
14
+ Run a disciplined research pass before implementation when the repo alone is not enough. This skill keeps research evidence-driven: inspect the local codebase first, escalate to official docs when freshness or public comparison matters, then use labeled community evidence only when it adds practical context.
15
+
16
+ ## When to Use
17
+
18
+ - Verifying latest SDK, CLI, API, or platform behavior
19
+ - Comparing tools, frameworks, hosted services, or implementation approaches
20
+ - Checking whether public docs and the local repo disagree
21
+ - Gathering external evidence before planning a migration or new capability
22
+ - Producing a structured research brief that hands off cleanly into implementation
23
+
24
+ ## Instructions
25
+
26
+ 1. **Define the research question before collecting sources** because vague research sprawls quickly. Restate the target topic, freshness requirement, comparison axis, and what decision the findings need to support.
27
+
28
+ 2. **Inspect the repo first** because many questions are already answerable from local code, configs, tests, docs, or generated assets. Do not browse externally until the local evidence is exhausted or clearly insufficient.
29
+
30
+ 3. **Decide whether external research is actually required** because not every task needs web evidence. Escalate only when freshness matters, public comparison matters, or the user explicitly asks to research or verify.
31
+
32
+ 4. **Follow the source ladder strictly** because evidence quality matters. Use official docs, upstream repositories, standards, and maintainer material as primary sources before looking at blogs, issue threads, or Reddit.
33
+
34
+ 5. **Capture concrete source details** because research without provenance is hard to trust. Record exact links, relevant dates, versions, and any repo files that support or contradict the external evidence.
35
+
36
+ 6. **Cross-check important claims across more than one source when possible** because public docs, repos, and community advice can drift. If sources disagree, say so explicitly instead of smoothing over the conflict.
37
+
38
+ 7. **Use Reddit and other community sources only as labeled secondary evidence** because they can surface practical gotchas but are not authoritative. Treat them as implementation color, not final truth.
39
+
40
+ 8. **Separate verified facts from inference** because downstream planning depends on confidence. Mark what is directly supported by repo evidence or official sources versus what you infer from patterns or secondary signals.
41
+
42
+ 9. **Keep the output decision-oriented** because the goal is not to dump links. Tie each finding back to the implementation, workflow, agent, or skill decision it affects.
43
+
44
+ 10. **Recommend the next route explicitly** because research is usually a handoff, not the end of the task. Name the next workflow, agent, or exact skill that should continue the work.
45
+
46
+ 11. **State the remaining gaps and risks** because incomplete research is still useful when the uncertainty is visible. Call out what you could not verify, what may have changed recently, and what assumptions remain.
47
+
48
+ 12. **Avoid over-quoting and over-collecting** because research quality comes from synthesis, not volume. Prefer concise summaries with high-signal citations over long pasted excerpts.
49
+
50
+ 13. **When the task turns into implementation, stop researching and hand off** because mixing discovery and execution usually creates drift. Deliver the research brief first, then route into the correct workflow or specialist.
51
+
52
+ ## Output Format
53
+
54
+ Deliver:
55
+
56
+ 1. **Research question** — topic, freshness requirement, and decision to support
57
+ 2. **Verified facts** — repo evidence and primary-source findings
58
+ 3. **Secondary/community evidence** — labeled lower-trust supporting signals
59
+ 4. **Gaps / unknowns** — unresolved questions or contradictory evidence
60
+ 5. **Recommended next route** — direct execution, workflow, agent, or exact skill to use next
61
+
62
+ ## References
63
+
64
+ Load only the file needed for the current question.
65
+
66
+ | File | Load when |
67
+ | --- | --- |
68
+ | `references/source-ladder.md` | Need the repo-first and source-priority policy for official docs versus community evidence. |
69
+ | `references/research-output.md` | Need the structured output format, evidence labeling rules, or handoff pattern. |
70
+ | `references/comparison-checklist.md` | Comparing vendors, frameworks, or tools and need a concrete evaluation frame. |
71
+
72
+ ## Examples
73
+
74
+ Use these when the task shape already matches.
75
+
76
+ | File | Use when |
77
+ | --- | --- |
78
+ | `examples/01-latest-docs-check.md` | Verifying a latest capability or doc claim before implementation. |
79
+ | `examples/02-ecosystem-comparison.md` | Comparing multiple tools or platforms with official-first sourcing. |
80
+ | `examples/03-research-to-implementation-handoff.md` | Turning research findings into a concrete next workflow or specialist handoff. |
81
+
82
+ ## Copilot Research Flow
83
+
84
+ - Restate the research question, freshness requirement, and comparison scope before gathering sources.
85
+ - Use repo evidence and `#file:` context first, then bring in official docs, then labeled community evidence only if it adds implementation color.
86
+ - Finish with the next recommended route so the research result can hand off cleanly into a workflow, prompt file, or agent.
87
+
88
+ ## Copilot Platform Notes
89
+
90
+ - Skill files are stored under `.github/prompts/` (prompt files) and `.github/instructions/` (instruction files).
91
+ - Copilot does not support subagent spawning — all skill guidance executes within the current conversation context.
92
+ - User arguments are provided as natural language input in the prompt, not through a `$ARGUMENTS` variable.
93
+ - Frontmatter keys `context`, `agent`, and `allowed-tools` are not supported; guidance is advisory only.
94
+ - Reference files can be included via `#file:references/<name>.md` syntax in Copilot Chat.
@@ -0,0 +1,17 @@
1
+ # Deep Research Eval Assertions
2
+
3
+ ## Eval 1: Latest Capability Verification
4
+
5
+ 1. **repo-first** — Starts by checking repo or local evidence before jumping to web claims.
6
+ 2. **official-first** — Uses official docs or upstream sources as the primary evidence for the capability.
7
+ 3. **secondary-labeled** — If community sources are mentioned, labels them as secondary evidence instead of presenting them as authoritative.
8
+ 4. **gaps-called-out** — Identifies unresolved uncertainty or missing confirmation.
9
+ 5. **next-route** — Ends with a concrete recommended workflow, agent, or skill to use next.
10
+
11
+ ## Eval 2: Tool Comparison
12
+
13
+ 1. **comparison-frame** — Defines the comparison axes instead of producing vague preferences.
14
+ 2. **repo-impact** — Connects the comparison back to the current repo or implementation constraints.
15
+ 3. **fact-vs-inference** — Separates verified facts from inference or interpretation.
16
+ 4. **decision-oriented** — Produces a recommendation or explicit defer condition.
17
+ 5. **no-research-sprawl** — Keeps the output concise and structured rather than dumping raw links.
@@ -0,0 +1,56 @@
1
+ [
2
+ {
3
+ "name": "latest-capability-verification",
4
+ "description": "Validate that the skill performs repo-first research, prioritizes official documentation, labels secondary evidence, and recommends a next route.",
5
+ "prompt": "Research whether the latest official Claude Code hook surface supports reinforcing route honoring before implementation. Start with the current repo state, then use official docs if needed. If community sources add useful practical context, include them but label them appropriately. End with the next workflow, agent, or skill we should use.",
6
+ "assertions": [
7
+ {
8
+ "id": "repo-first",
9
+ "description": "Starts with repo or local evidence before using external sources."
10
+ },
11
+ {
12
+ "id": "official-first",
13
+ "description": "Treats official docs or upstream sources as the primary evidence."
14
+ },
15
+ {
16
+ "id": "secondary-labeled",
17
+ "description": "Labels any Reddit or community evidence as secondary rather than authoritative."
18
+ },
19
+ {
20
+ "id": "gaps-called-out",
21
+ "description": "States any unresolved gaps, conflicts, or unknowns."
22
+ },
23
+ {
24
+ "id": "next-route",
25
+ "description": "Ends with a concrete recommended next route."
26
+ }
27
+ ]
28
+ },
29
+ {
30
+ "name": "tool-comparison",
31
+ "description": "Validate that the skill compares options with a clear frame, ties findings back to repo impact, and produces a decision-ready output.",
32
+ "prompt": "Compare whether our CLI should keep enforcement in Gemini command wrappers only or also add Claude hook templates. Use the repo state first, then official docs for current platform capabilities, and include community evidence only if it adds implementation nuance. Finish with a recommendation and the next route to take.",
33
+ "assertions": [
34
+ {
35
+ "id": "comparison-frame",
36
+ "description": "Defines concrete comparison axes such as repo impact, enforcement surface, and maintenance cost."
37
+ },
38
+ {
39
+ "id": "repo-impact",
40
+ "description": "Connects each option back to the current repo or bundle behavior."
41
+ },
42
+ {
43
+ "id": "fact-vs-inference",
44
+ "description": "Separates verified facts from inference or interpretation."
45
+ },
46
+ {
47
+ "id": "decision-oriented",
48
+ "description": "Produces a recommendation or explicit defer condition."
49
+ },
50
+ {
51
+ "id": "no-research-sprawl",
52
+ "description": "Keeps the answer structured instead of turning into an unfiltered dump of sources."
53
+ }
54
+ ]
55
+ }
56
+ ]
@@ -0,0 +1,12 @@
1
+ # Example: Latest Docs Check
2
+
3
+ ## User Request
4
+
5
+ > Research whether Claude Code hooks can reinforce route honoring before we add new workflow rules.
6
+
7
+ ## Expected Shape
8
+
9
+ 1. Inspect the repo's current Claude rule and hook support first.
10
+ 2. Verify the current official Claude docs for hooks, event names, and config format.
11
+ 3. Separate those verified facts from any community commentary about hook effectiveness.
12
+ 4. End with the recommended next route, for example `@researcher` continuing the research or `/create` applying the validated hook template changes.