@cubis/foundry 0.3.75 → 0.3.77

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 (263) hide show
  1. package/README.md +98 -76
  2. package/dist/cli/commands/register.js +1 -1
  3. package/dist/cli/commands/register.js.map +1 -1
  4. package/dist/cli/core.js +405 -216
  5. package/dist/cli/core.js.map +1 -1
  6. package/dist/cli/init/execute.js +5 -7
  7. package/dist/cli/init/execute.js.map +1 -1
  8. package/dist/cli/workflows/commands.js +2 -2
  9. package/dist/cli/workflows/commands.js.map +1 -1
  10. package/mcp/src/tools/skillTools.test.ts +34 -1
  11. package/package.json +4 -3
  12. package/src/cli/commands/register.ts +1 -1
  13. package/src/cli/core.ts +495 -267
  14. package/src/cli/init/execute.ts +5 -9
  15. package/src/cli/workflows/commands.ts +2 -2
  16. package/workflows/skills/_schema/skill-platform-attributes.json +14 -0
  17. package/workflows/skills/deep-research/SKILL.md +81 -0
  18. package/workflows/skills/deep-research/evals/assertions.md +17 -0
  19. package/workflows/skills/deep-research/evals/evals.json +56 -0
  20. package/workflows/skills/deep-research/examples/01-latest-docs-check.md +12 -0
  21. package/workflows/skills/deep-research/examples/02-ecosystem-comparison.md +12 -0
  22. package/workflows/skills/deep-research/examples/03-research-to-implementation-handoff.md +12 -0
  23. package/workflows/skills/deep-research/references/comparison-checklist.md +57 -0
  24. package/workflows/skills/deep-research/references/research-output.md +69 -0
  25. package/workflows/skills/deep-research/references/source-ladder.md +81 -0
  26. package/workflows/skills/generated/skill-audit.json +20 -2
  27. package/workflows/skills/generated/skill-catalog.json +62 -4
  28. package/workflows/skills/skills_index.json +58 -0
  29. package/workflows/skills/stitch/SKILL.md +79 -0
  30. package/workflows/skills/stitch/evals/assertions.md +45 -0
  31. package/workflows/skills/stitch/evals/evals.json +68 -0
  32. package/workflows/skills/stitch/examples/01-new-screen.md +13 -0
  33. package/workflows/skills/stitch/examples/02-update-existing-screen.md +13 -0
  34. package/workflows/skills/stitch/examples/03-mobile-handoff.md +13 -0
  35. package/workflows/skills/stitch/examples/04-prompt-enhancement.md +21 -0
  36. package/workflows/skills/stitch/examples/05-design-sync-loop.md +16 -0
  37. package/workflows/skills/stitch/references/implementation-patterns.md +20 -0
  38. package/workflows/skills/stitch/references/platform-setup.md +46 -0
  39. package/workflows/skills/stitch/references/update-diff-workflow.md +23 -0
  40. package/workflows/workflows/agent-environment-setup/generated/route-manifest.json +21 -13
  41. package/workflows/workflows/agent-environment-setup/manifest.json +32 -1
  42. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/frontend-specialist.md +10 -2
  43. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/mobile-developer.md +6 -2
  44. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/orchestrator.md +6 -5
  45. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/project-planner.md +4 -3
  46. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/researcher.md +8 -4
  47. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/accessibility.toml +2 -0
  48. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/backend.toml +2 -0
  49. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/create.toml +2 -0
  50. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/database.toml +2 -0
  51. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/debug.toml +2 -0
  52. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/devops.toml +2 -0
  53. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/implement-track.toml +2 -0
  54. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/migrate.toml +2 -0
  55. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/mobile.toml +2 -0
  56. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/onboard.toml +2 -0
  57. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/orchestrate.toml +2 -0
  58. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/plan.toml +2 -0
  59. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/refactor.toml +2 -0
  60. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/release.toml +2 -0
  61. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/review.toml +2 -0
  62. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/security.toml +2 -0
  63. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/test.toml +2 -0
  64. package/workflows/workflows/agent-environment-setup/platforms/antigravity/commands/vercel.toml +2 -0
  65. package/workflows/workflows/agent-environment-setup/platforms/antigravity/rules/GEMINI.md +14 -8
  66. package/workflows/workflows/agent-environment-setup/platforms/antigravity/skills/deep-research/SKILL.md +89 -0
  67. package/workflows/workflows/agent-environment-setup/platforms/antigravity/skills/deep-research/evals/assertions.md +17 -0
  68. package/workflows/workflows/agent-environment-setup/platforms/antigravity/skills/deep-research/evals/evals.json +56 -0
  69. package/workflows/workflows/agent-environment-setup/platforms/antigravity/skills/deep-research/examples/01-latest-docs-check.md +12 -0
  70. package/workflows/workflows/agent-environment-setup/platforms/antigravity/skills/deep-research/examples/02-ecosystem-comparison.md +12 -0
  71. package/workflows/workflows/agent-environment-setup/platforms/antigravity/skills/deep-research/examples/03-research-to-implementation-handoff.md +12 -0
  72. package/workflows/workflows/agent-environment-setup/platforms/antigravity/skills/deep-research/references/comparison-checklist.md +57 -0
  73. package/workflows/workflows/agent-environment-setup/platforms/antigravity/skills/deep-research/references/research-output.md +69 -0
  74. package/workflows/workflows/agent-environment-setup/platforms/antigravity/skills/deep-research/references/source-ladder.md +81 -0
  75. package/workflows/workflows/agent-environment-setup/platforms/antigravity/skills/stitch/SKILL.md +87 -0
  76. package/workflows/workflows/agent-environment-setup/platforms/antigravity/skills/stitch/evals/assertions.md +45 -0
  77. package/workflows/workflows/agent-environment-setup/platforms/antigravity/skills/stitch/evals/evals.json +68 -0
  78. package/workflows/workflows/agent-environment-setup/platforms/antigravity/skills/stitch/examples/01-new-screen.md +13 -0
  79. package/workflows/workflows/agent-environment-setup/platforms/antigravity/skills/stitch/examples/02-update-existing-screen.md +13 -0
  80. package/workflows/workflows/agent-environment-setup/platforms/antigravity/skills/stitch/examples/03-mobile-handoff.md +13 -0
  81. package/workflows/workflows/agent-environment-setup/platforms/antigravity/skills/stitch/examples/04-prompt-enhancement.md +21 -0
  82. package/workflows/workflows/agent-environment-setup/platforms/antigravity/skills/stitch/examples/05-design-sync-loop.md +16 -0
  83. package/workflows/workflows/agent-environment-setup/platforms/antigravity/skills/stitch/references/implementation-patterns.md +20 -0
  84. package/workflows/workflows/agent-environment-setup/platforms/antigravity/skills/stitch/references/platform-setup.md +46 -0
  85. package/workflows/workflows/agent-environment-setup/platforms/antigravity/skills/stitch/references/update-diff-workflow.md +23 -0
  86. package/workflows/workflows/agent-environment-setup/platforms/antigravity/workflows/create.md +3 -2
  87. package/workflows/workflows/agent-environment-setup/platforms/antigravity/workflows/mobile.md +4 -3
  88. package/workflows/workflows/agent-environment-setup/platforms/antigravity/workflows/onboard.md +3 -3
  89. package/workflows/workflows/agent-environment-setup/platforms/antigravity/workflows/orchestrate.md +2 -2
  90. package/workflows/workflows/agent-environment-setup/platforms/antigravity/workflows/plan.md +4 -4
  91. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/frontend-specialist.md +10 -2
  92. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/mobile-developer.md +6 -2
  93. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/orchestrator.md +6 -5
  94. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/project-planner.md +4 -3
  95. package/workflows/workflows/agent-environment-setup/platforms/claude/agents/researcher.md +8 -4
  96. package/workflows/workflows/agent-environment-setup/platforms/claude/hooks/README.md +15 -0
  97. package/workflows/workflows/agent-environment-setup/platforms/claude/hooks/route-research-guard.mjs +39 -0
  98. package/workflows/workflows/agent-environment-setup/platforms/claude/hooks/settings.snippet.json +15 -0
  99. package/workflows/workflows/agent-environment-setup/platforms/claude/rules/CLAUDE.md +16 -8
  100. package/workflows/workflows/agent-environment-setup/platforms/claude/skills/deep-research/SKILL.md +95 -0
  101. package/workflows/workflows/agent-environment-setup/platforms/claude/skills/deep-research/evals/assertions.md +17 -0
  102. package/workflows/workflows/agent-environment-setup/platforms/claude/skills/deep-research/evals/evals.json +56 -0
  103. package/workflows/workflows/agent-environment-setup/platforms/claude/skills/deep-research/examples/01-latest-docs-check.md +12 -0
  104. package/workflows/workflows/agent-environment-setup/platforms/claude/skills/deep-research/examples/02-ecosystem-comparison.md +12 -0
  105. package/workflows/workflows/agent-environment-setup/platforms/claude/skills/deep-research/examples/03-research-to-implementation-handoff.md +12 -0
  106. package/workflows/workflows/agent-environment-setup/platforms/claude/skills/deep-research/references/comparison-checklist.md +57 -0
  107. package/workflows/workflows/agent-environment-setup/platforms/claude/skills/deep-research/references/research-output.md +69 -0
  108. package/workflows/workflows/agent-environment-setup/platforms/claude/skills/deep-research/references/source-ladder.md +81 -0
  109. package/workflows/workflows/agent-environment-setup/platforms/claude/skills/skills_index.json +58 -0
  110. package/workflows/workflows/agent-environment-setup/platforms/claude/skills/stitch/SKILL.md +93 -0
  111. package/workflows/workflows/agent-environment-setup/platforms/claude/skills/stitch/evals/assertions.md +45 -0
  112. package/workflows/workflows/agent-environment-setup/platforms/claude/skills/stitch/evals/evals.json +68 -0
  113. package/workflows/workflows/agent-environment-setup/platforms/claude/skills/stitch/examples/01-new-screen.md +13 -0
  114. package/workflows/workflows/agent-environment-setup/platforms/claude/skills/stitch/examples/02-update-existing-screen.md +13 -0
  115. package/workflows/workflows/agent-environment-setup/platforms/claude/skills/stitch/examples/03-mobile-handoff.md +13 -0
  116. package/workflows/workflows/agent-environment-setup/platforms/claude/skills/stitch/examples/04-prompt-enhancement.md +21 -0
  117. package/workflows/workflows/agent-environment-setup/platforms/claude/skills/stitch/examples/05-design-sync-loop.md +16 -0
  118. package/workflows/workflows/agent-environment-setup/platforms/claude/skills/stitch/references/implementation-patterns.md +20 -0
  119. package/workflows/workflows/agent-environment-setup/platforms/claude/skills/stitch/references/platform-setup.md +46 -0
  120. package/workflows/workflows/agent-environment-setup/platforms/claude/skills/stitch/references/update-diff-workflow.md +23 -0
  121. package/workflows/workflows/agent-environment-setup/platforms/claude/workflows/create.md +3 -2
  122. package/workflows/workflows/agent-environment-setup/platforms/claude/workflows/mobile.md +4 -3
  123. package/workflows/workflows/agent-environment-setup/platforms/claude/workflows/onboard.md +3 -3
  124. package/workflows/workflows/agent-environment-setup/platforms/claude/workflows/orchestrate.md +2 -2
  125. package/workflows/workflows/agent-environment-setup/platforms/claude/workflows/plan.md +4 -4
  126. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/frontend-specialist.md +10 -2
  127. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/mobile-developer.md +6 -2
  128. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/orchestrator.md +6 -5
  129. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/project-planner.md +4 -3
  130. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/researcher.md +8 -4
  131. package/workflows/workflows/agent-environment-setup/platforms/codex/rules/AGENTS.md +14 -8
  132. package/workflows/workflows/agent-environment-setup/platforms/codex/skills/deep-research/SKILL.md +89 -0
  133. package/workflows/workflows/agent-environment-setup/platforms/codex/skills/deep-research/evals/assertions.md +17 -0
  134. package/workflows/workflows/agent-environment-setup/platforms/codex/skills/deep-research/evals/evals.json +56 -0
  135. package/workflows/workflows/agent-environment-setup/platforms/codex/skills/deep-research/examples/01-latest-docs-check.md +12 -0
  136. package/workflows/workflows/agent-environment-setup/platforms/codex/skills/deep-research/examples/02-ecosystem-comparison.md +12 -0
  137. package/workflows/workflows/agent-environment-setup/platforms/codex/skills/deep-research/examples/03-research-to-implementation-handoff.md +12 -0
  138. package/workflows/workflows/agent-environment-setup/platforms/codex/skills/deep-research/references/comparison-checklist.md +57 -0
  139. package/workflows/workflows/agent-environment-setup/platforms/codex/skills/deep-research/references/research-output.md +69 -0
  140. package/workflows/workflows/agent-environment-setup/platforms/codex/skills/deep-research/references/source-ladder.md +81 -0
  141. package/workflows/workflows/agent-environment-setup/platforms/codex/skills/stitch/SKILL.md +87 -0
  142. package/workflows/workflows/agent-environment-setup/platforms/codex/skills/stitch/evals/assertions.md +45 -0
  143. package/workflows/workflows/agent-environment-setup/platforms/codex/skills/stitch/evals/evals.json +68 -0
  144. package/workflows/workflows/agent-environment-setup/platforms/codex/skills/stitch/examples/01-new-screen.md +13 -0
  145. package/workflows/workflows/agent-environment-setup/platforms/codex/skills/stitch/examples/02-update-existing-screen.md +13 -0
  146. package/workflows/workflows/agent-environment-setup/platforms/codex/skills/stitch/examples/03-mobile-handoff.md +13 -0
  147. package/workflows/workflows/agent-environment-setup/platforms/codex/skills/stitch/examples/04-prompt-enhancement.md +21 -0
  148. package/workflows/workflows/agent-environment-setup/platforms/codex/skills/stitch/examples/05-design-sync-loop.md +16 -0
  149. package/workflows/workflows/agent-environment-setup/platforms/codex/skills/stitch/references/implementation-patterns.md +20 -0
  150. package/workflows/workflows/agent-environment-setup/platforms/codex/skills/stitch/references/platform-setup.md +46 -0
  151. package/workflows/workflows/agent-environment-setup/platforms/codex/skills/stitch/references/update-diff-workflow.md +23 -0
  152. package/workflows/workflows/agent-environment-setup/platforms/codex/workflows/create.md +3 -2
  153. package/workflows/workflows/agent-environment-setup/platforms/codex/workflows/mobile.md +4 -3
  154. package/workflows/workflows/agent-environment-setup/platforms/codex/workflows/onboard.md +3 -3
  155. package/workflows/workflows/agent-environment-setup/platforms/codex/workflows/orchestrate.md +2 -2
  156. package/workflows/workflows/agent-environment-setup/platforms/codex/workflows/plan.md +4 -4
  157. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/frontend-specialist.md +6 -2
  158. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/mobile-developer.md +6 -2
  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 +2 -1
  163. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-backend.prompt.md +2 -1
  164. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-create.prompt.md +2 -1
  165. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-database.prompt.md +2 -1
  166. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-debug.prompt.md +2 -1
  167. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-devops.prompt.md +2 -1
  168. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-implement-track.prompt.md +2 -1
  169. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-migrate.prompt.md +2 -1
  170. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-mobile.prompt.md +2 -1
  171. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-onboard.prompt.md +2 -1
  172. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-orchestrate.prompt.md +2 -1
  173. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-plan.prompt.md +2 -1
  174. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-refactor.prompt.md +2 -1
  175. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-release.prompt.md +2 -1
  176. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-review.prompt.md +2 -1
  177. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-security.prompt.md +2 -1
  178. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-test.prompt.md +2 -1
  179. package/workflows/workflows/agent-environment-setup/platforms/copilot/prompts/workflow-vercel.prompt.md +2 -1
  180. package/workflows/workflows/agent-environment-setup/platforms/copilot/rules/copilot-instructions.md +14 -8
  181. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/deep-research/SKILL.md +94 -0
  182. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/deep-research/evals/assertions.md +17 -0
  183. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/deep-research/evals/evals.json +56 -0
  184. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/deep-research/examples/01-latest-docs-check.md +12 -0
  185. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/deep-research/examples/02-ecosystem-comparison.md +12 -0
  186. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/deep-research/examples/03-research-to-implementation-handoff.md +12 -0
  187. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/deep-research/references/comparison-checklist.md +57 -0
  188. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/deep-research/references/research-output.md +69 -0
  189. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/deep-research/references/source-ladder.md +81 -0
  190. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/skills_index.json +58 -0
  191. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/stitch/SKILL.md +92 -0
  192. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/stitch/evals/assertions.md +45 -0
  193. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/stitch/evals/evals.json +68 -0
  194. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/stitch/examples/01-new-screen.md +13 -0
  195. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/stitch/examples/02-update-existing-screen.md +13 -0
  196. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/stitch/examples/03-mobile-handoff.md +13 -0
  197. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/stitch/examples/04-prompt-enhancement.md +21 -0
  198. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/stitch/examples/05-design-sync-loop.md +16 -0
  199. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/stitch/references/implementation-patterns.md +20 -0
  200. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/stitch/references/platform-setup.md +46 -0
  201. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/stitch/references/update-diff-workflow.md +23 -0
  202. package/workflows/workflows/agent-environment-setup/platforms/copilot/workflows/create.md +3 -2
  203. package/workflows/workflows/agent-environment-setup/platforms/copilot/workflows/mobile.md +4 -3
  204. package/workflows/workflows/agent-environment-setup/platforms/copilot/workflows/onboard.md +3 -3
  205. package/workflows/workflows/agent-environment-setup/platforms/copilot/workflows/orchestrate.md +2 -2
  206. package/workflows/workflows/agent-environment-setup/platforms/copilot/workflows/plan.md +4 -4
  207. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/accessibility.toml +2 -0
  208. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/backend.toml +2 -0
  209. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/create.toml +2 -0
  210. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/database.toml +2 -0
  211. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/debug.toml +2 -0
  212. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/devops.toml +2 -0
  213. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/implement-track.toml +2 -0
  214. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/migrate.toml +2 -0
  215. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/mobile.toml +2 -0
  216. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/onboard.toml +2 -0
  217. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/orchestrate.toml +2 -0
  218. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/plan.toml +2 -0
  219. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/refactor.toml +2 -0
  220. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/release.toml +2 -0
  221. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/review.toml +2 -0
  222. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/security.toml +2 -0
  223. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/test.toml +2 -0
  224. package/workflows/workflows/agent-environment-setup/platforms/gemini/commands/vercel.toml +2 -0
  225. package/workflows/workflows/agent-environment-setup/platforms/gemini/rules/GEMINI.md +14 -8
  226. package/workflows/workflows/agent-environment-setup/platforms/gemini/skills/deep-research/SKILL.md +89 -0
  227. package/workflows/workflows/agent-environment-setup/platforms/gemini/skills/deep-research/evals/assertions.md +17 -0
  228. package/workflows/workflows/agent-environment-setup/platforms/gemini/skills/deep-research/evals/evals.json +56 -0
  229. package/workflows/workflows/agent-environment-setup/platforms/gemini/skills/deep-research/examples/01-latest-docs-check.md +12 -0
  230. package/workflows/workflows/agent-environment-setup/platforms/gemini/skills/deep-research/examples/02-ecosystem-comparison.md +12 -0
  231. package/workflows/workflows/agent-environment-setup/platforms/gemini/skills/deep-research/examples/03-research-to-implementation-handoff.md +12 -0
  232. package/workflows/workflows/agent-environment-setup/platforms/gemini/skills/deep-research/references/comparison-checklist.md +57 -0
  233. package/workflows/workflows/agent-environment-setup/platforms/gemini/skills/deep-research/references/research-output.md +69 -0
  234. package/workflows/workflows/agent-environment-setup/platforms/gemini/skills/deep-research/references/source-ladder.md +81 -0
  235. package/workflows/workflows/agent-environment-setup/platforms/gemini/skills/stitch/SKILL.md +87 -0
  236. package/workflows/workflows/agent-environment-setup/platforms/gemini/skills/stitch/evals/assertions.md +45 -0
  237. package/workflows/workflows/agent-environment-setup/platforms/gemini/skills/stitch/evals/evals.json +68 -0
  238. package/workflows/workflows/agent-environment-setup/platforms/gemini/skills/stitch/examples/01-new-screen.md +13 -0
  239. package/workflows/workflows/agent-environment-setup/platforms/gemini/skills/stitch/examples/02-update-existing-screen.md +13 -0
  240. package/workflows/workflows/agent-environment-setup/platforms/gemini/skills/stitch/examples/03-mobile-handoff.md +13 -0
  241. package/workflows/workflows/agent-environment-setup/platforms/gemini/skills/stitch/examples/04-prompt-enhancement.md +21 -0
  242. package/workflows/workflows/agent-environment-setup/platforms/gemini/skills/stitch/examples/05-design-sync-loop.md +16 -0
  243. package/workflows/workflows/agent-environment-setup/platforms/gemini/skills/stitch/references/implementation-patterns.md +20 -0
  244. package/workflows/workflows/agent-environment-setup/platforms/gemini/skills/stitch/references/platform-setup.md +46 -0
  245. package/workflows/workflows/agent-environment-setup/platforms/gemini/skills/stitch/references/update-diff-workflow.md +23 -0
  246. package/workflows/workflows/agent-environment-setup/platforms/gemini/workflows/create.md +3 -2
  247. package/workflows/workflows/agent-environment-setup/platforms/gemini/workflows/mobile.md +4 -3
  248. package/workflows/workflows/agent-environment-setup/platforms/gemini/workflows/onboard.md +3 -3
  249. package/workflows/workflows/agent-environment-setup/platforms/gemini/workflows/orchestrate.md +2 -2
  250. package/workflows/workflows/agent-environment-setup/platforms/gemini/workflows/plan.md +4 -4
  251. package/workflows/workflows/agent-environment-setup/shared/agents/frontend-specialist.md +10 -2
  252. package/workflows/workflows/agent-environment-setup/shared/agents/mobile-developer.md +6 -2
  253. package/workflows/workflows/agent-environment-setup/shared/agents/orchestrator.md +2 -1
  254. package/workflows/workflows/agent-environment-setup/shared/agents/project-planner.md +2 -1
  255. package/workflows/workflows/agent-environment-setup/shared/agents/researcher.md +5 -1
  256. package/workflows/workflows/agent-environment-setup/shared/rules/STEERING.md +44 -13
  257. package/workflows/workflows/agent-environment-setup/shared/rules/overrides/claude.md +2 -0
  258. package/workflows/workflows/agent-environment-setup/shared/rules/overrides/gemini.md +20 -0
  259. package/workflows/workflows/agent-environment-setup/shared/workflows/create.md +3 -2
  260. package/workflows/workflows/agent-environment-setup/shared/workflows/mobile.md +4 -3
  261. package/workflows/workflows/agent-environment-setup/shared/workflows/onboard.md +1 -1
  262. package/workflows/workflows/agent-environment-setup/shared/workflows/orchestrate.md +1 -1
  263. package/workflows/workflows/agent-environment-setup/shared/workflows/plan.md +2 -2
@@ -0,0 +1,95 @@
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
+ allowed-tools: Read Grep Glob Bash
5
+ context: fork
6
+ agent: researcher
7
+ user-invocable: true
8
+ argument-hint: "Topic, vendor capability, or public comparison to research"
9
+ ---
10
+
11
+ # Deep Research
12
+
13
+ ## Purpose
14
+
15
+ 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.
16
+
17
+ ## When to Use
18
+
19
+ - Verifying latest SDK, CLI, API, or platform behavior
20
+ - Comparing tools, frameworks, hosted services, or implementation approaches
21
+ - Checking whether public docs and the local repo disagree
22
+ - Gathering external evidence before planning a migration or new capability
23
+ - Producing a structured research brief that hands off cleanly into implementation
24
+
25
+ ## Instructions
26
+
27
+ 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.
28
+
29
+ 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.
30
+
31
+ 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.
32
+
33
+ 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.
34
+
35
+ 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.
36
+
37
+ 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.
38
+
39
+ 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.
40
+
41
+ 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.
42
+
43
+ 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.
44
+
45
+ 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.
46
+
47
+ 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.
48
+
49
+ 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.
50
+
51
+ 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.
52
+
53
+ ## Output Format
54
+
55
+ Deliver:
56
+
57
+ 1. **Research question** — topic, freshness requirement, and decision to support
58
+ 2. **Verified facts** — repo evidence and primary-source findings
59
+ 3. **Secondary/community evidence** — labeled lower-trust supporting signals
60
+ 4. **Gaps / unknowns** — unresolved questions or contradictory evidence
61
+ 5. **Recommended next route** — direct execution, workflow, agent, or exact skill to use next
62
+
63
+ ## References
64
+
65
+ Load only the file needed for the current question.
66
+
67
+ | File | Load when |
68
+ | --- | --- |
69
+ | `references/source-ladder.md` | Need the repo-first and source-priority policy for official docs versus community evidence. |
70
+ | `references/research-output.md` | Need the structured output format, evidence labeling rules, or handoff pattern. |
71
+ | `references/comparison-checklist.md` | Comparing vendors, frameworks, or tools and need a concrete evaluation frame. |
72
+
73
+ ## Examples
74
+
75
+ Use these when the task shape already matches.
76
+
77
+ | File | Use when |
78
+ | --- | --- |
79
+ | `examples/01-latest-docs-check.md` | Verifying a latest capability or doc claim before implementation. |
80
+ | `examples/02-ecosystem-comparison.md` | Comparing multiple tools or platforms with official-first sourcing. |
81
+ | `examples/03-research-to-implementation-handoff.md` | Turning research findings into a concrete next workflow or specialist handoff. |
82
+
83
+ ## Claude Research Flow
84
+
85
+ - Use `$ARGUMENTS` as the research topic when this skill is invoked directly.
86
+ - Prefer official docs, upstream repos, and maintainer material before blog posts or Reddit threads.
87
+ - If Claude hook templates are installed, let them reinforce repo-first inspection and research escalation, but keep the final research output aligned with this skill's evidence contract.
88
+
89
+ ## Claude Platform Notes
90
+
91
+ - Use `$ARGUMENTS` to access user-provided arguments passed when the skill is invoked.
92
+ - Reference skill-local files with `${CLAUDE_SKILL_DIR}/references/<file>` for portable paths.
93
+ - When `context: fork` is set, the skill runs in an isolated subagent context; the `agent` field names the fork target.
94
+ - MCP skill tools (`skill_search`, `skill_get`, `skill_validate`, `skill_get_reference`) are available for dynamic skill discovery and loading.
95
+ - Use `allowed-tools` in frontmatter to restrict tool access for security-sensitive skills.
@@ -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.
@@ -0,0 +1,12 @@
1
+ # Example: Ecosystem Comparison
2
+
3
+ ## User Request
4
+
5
+ > Compare whether our CLI should keep Gemini command enforcement only, or add another platform-native hook layer for Claude as well.
6
+
7
+ ## Expected Shape
8
+
9
+ 1. Start with repo constraints and current platform bundle behavior.
10
+ 2. Compare the official platform capabilities using primary docs.
11
+ 3. Add any useful community evidence as clearly labeled secondary input.
12
+ 4. Produce a recommendation tied to the repo: which platform gets which enforcement surface, and why.
@@ -0,0 +1,12 @@
1
+ # Example: Research To Implementation Handoff
2
+
3
+ ## User Request
4
+
5
+ > Research the latest Codex, Claude, and Gemini MCP behavior, then tell me the next route to update our workflow rules safely.
6
+
7
+ ## Expected Shape
8
+
9
+ 1. Gather repo evidence first.
10
+ 2. Verify current official docs for each platform.
11
+ 3. Summarize verified facts, secondary evidence, and gaps.
12
+ 4. End with a precise next route such as `/plan` for a policy change or `skill-creator` for skill/rule packaging work.
@@ -0,0 +1,57 @@
1
+ # Comparison Checklist
2
+
3
+ Use this when evaluating tools, frameworks, APIs, or platforms.
4
+
5
+ ## 1. Scope the Comparison
6
+
7
+ Define:
8
+
9
+ - what is being compared
10
+ - whether the comparison is about implementation fit, operational cost, or product capability
11
+ - what time horizon matters: immediate migration, medium-term maintenance, or long-term platform fit
12
+
13
+ ## 2. Compare on Stable Axes
14
+
15
+ Use a short set of dimensions:
16
+
17
+ - integration fit with the current repo
18
+ - maturity and maintenance signal
19
+ - official documentation quality
20
+ - configuration complexity
21
+ - ecosystem and tooling support
22
+ - operational constraints
23
+ - migration cost
24
+
25
+ Do not compare on vague criteria like "better DX" without concrete evidence.
26
+
27
+ ## 3. Capture Repo Impact
28
+
29
+ Tie each option back to the current codebase:
30
+
31
+ - what code would change
32
+ - which workflows or agents would own the work
33
+ - what risks are specific to this repo
34
+ - whether new MCP tools or skills would be required
35
+
36
+ ## 4. Separate Product Claims from Team Constraints
37
+
38
+ An option can be technically stronger and still be a worse fit for the repo.
39
+
40
+ Keep these separate:
41
+
42
+ - product capability
43
+ - ecosystem quality
44
+ - team familiarity
45
+ - migration blast radius
46
+ - existing architecture constraints
47
+
48
+ ## 5. Decision Frame
49
+
50
+ Finish with one of:
51
+
52
+ - recommend option A
53
+ - recommend option B
54
+ - defer decision pending one missing verification
55
+ - keep current approach because switching cost outweighs gain
56
+
57
+ If the evidence is mixed, say what would change the recommendation.
@@ -0,0 +1,69 @@
1
+ # Research Output Contract
2
+
3
+ ## Required Sections
4
+
5
+ ### 1. Research question
6
+
7
+ State:
8
+
9
+ - the exact topic
10
+ - why research was necessary
11
+ - whether freshness or public comparison mattered
12
+ - the decision this research is meant to support
13
+
14
+ ### 2. Verified facts
15
+
16
+ List the strongest findings first.
17
+
18
+ For each fact:
19
+
20
+ - state the claim in one sentence
21
+ - cite the source class: repo, official docs, upstream repo, standard
22
+ - include the relevant link or file path
23
+ - include date/version when it matters
24
+
25
+ ### 3. Secondary / community evidence
26
+
27
+ Only include this when it adds signal the primary sources did not provide.
28
+
29
+ For each item:
30
+
31
+ - label it as secondary evidence
32
+ - state what practical signal it adds
33
+ - avoid presenting it as settled fact
34
+
35
+ ### 4. Gaps / unknowns
36
+
37
+ Document:
38
+
39
+ - unresolved conflicts
40
+ - missing official confirmation
41
+ - assumptions that still need validation
42
+ - risks if the team proceeds anyway
43
+
44
+ ### 5. Recommended next route
45
+
46
+ Research should end with one clear recommendation:
47
+
48
+ - direct execution
49
+ - a specific workflow like `/plan` or `/create`
50
+ - a specialist like `@researcher` or `@frontend-specialist`
51
+ - an exact skill like `stitch` or `deep-research`
52
+
53
+ Keep this recommendation concrete enough that the next step does not need another routing pass.
54
+
55
+ ## Compression Rules
56
+
57
+ - Prefer 5 strong findings over 20 weak ones.
58
+ - Do not paste long quotes from docs when a citation plus summary will do.
59
+ - If multiple sources say the same thing, summarize once and cite the strongest source.
60
+ - If research found nothing reliable, say that directly.
61
+
62
+ ## Handoff Pattern
63
+
64
+ When handing off to implementation or planning, include:
65
+
66
+ - the decision summary
67
+ - the highest-confidence constraints
68
+ - the unresolved risks
69
+ - the next route to take
@@ -0,0 +1,81 @@
1
+ # Source Ladder
2
+
3
+ ## Goal
4
+
5
+ Use the smallest amount of external research that still produces a decision-ready answer. Keep the evidence traceable and ordered by trust.
6
+
7
+ ## 1. Repo / Local Evidence First
8
+
9
+ Start by inspecting:
10
+
11
+ - application code and tests
12
+ - README files and internal docs
13
+ - generated workflow or skill assets
14
+ - lockfiles, config files, and package manifests
15
+ - existing integration code and migration history
16
+
17
+ If the repo already answers the question, stop there. Do not browse externally just because web research feels safer.
18
+
19
+ ## 2. Primary External Sources
20
+
21
+ Use these next:
22
+
23
+ - official vendor docs
24
+ - upstream repositories and release notes
25
+ - standards bodies and reference specs
26
+ - maintainer-authored examples
27
+
28
+ Prefer sources that expose:
29
+
30
+ - exact feature names
31
+ - current version constraints
32
+ - config formats
33
+ - dates or changelog context
34
+
35
+ When the topic is time-sensitive, capture the date you verified the source and the version or doc page involved.
36
+
37
+ ## 3. Secondary / Community Sources
38
+
39
+ Use these only after primary evidence:
40
+
41
+ - Reddit threads
42
+ - issue comments
43
+ - independent blog posts
44
+ - forum discussions
45
+ - third-party comparison articles
46
+
47
+ Community evidence is useful for:
48
+
49
+ - practical gotchas
50
+ - migration pain points
51
+ - missing-doc workarounds
52
+ - real-world adoption patterns
53
+
54
+ Community evidence is not enough on its own for authoritative claims about product behavior, supported configuration, or security guarantees.
55
+
56
+ ## 4. Conflict Handling
57
+
58
+ When sources disagree:
59
+
60
+ 1. Prefer repo evidence for the current codebase state.
61
+ 2. Prefer official docs over community claims for product behavior.
62
+ 3. Prefer newer dated material when the sources cover the same feature.
63
+ 4. If the conflict remains unresolved, report it as a gap instead of guessing.
64
+
65
+ ## 5. Evidence Labels
66
+
67
+ Use these labels in research output:
68
+
69
+ - **Verified fact** — backed by repo evidence or a primary source
70
+ - **Secondary evidence** — backed only by community or indirect sources
71
+ - **Inference** — reasoned conclusion not directly stated by a source
72
+ - **Gap** — could not be verified confidently
73
+
74
+ ## 6. Stop Conditions
75
+
76
+ Stop researching when:
77
+
78
+ - the decision is already clear
79
+ - new sources only repeat the same point
80
+ - the remaining uncertainty is small and clearly documented
81
+ - the task should move into implementation or planning
@@ -193,6 +193,38 @@
193
193
  "databases"
194
194
  ]
195
195
  },
196
+ {
197
+ "id": "deep-research",
198
+ "package_id": "deep-research",
199
+ "catalog_id": "deep-research",
200
+ "kind": "skill",
201
+ "name": "deep-research",
202
+ "canonical": true,
203
+ "canonical_id": "deep-research",
204
+ "deprecated": false,
205
+ "replaced_by": null,
206
+ "aliases": [],
207
+ "category": "core-operating",
208
+ "layer": "core-operating",
209
+ "maturity": "incubating",
210
+ "tier": "experimental",
211
+ "tags": [
212
+ "core-operating",
213
+ "deep",
214
+ "deep research",
215
+ "deep-research",
216
+ "research"
217
+ ],
218
+ "path": ".claude/skills/deep-research/SKILL.md",
219
+ "description": "Use when investigating latest vendor behavior, comparing tools or platforms, verifying claims beyond the repo, or gathering external evidence before implementation.",
220
+ "triggers": [
221
+ "deep-research",
222
+ "deep research",
223
+ "deep",
224
+ "research",
225
+ "core-operating"
226
+ ]
227
+ },
196
228
  {
197
229
  "id": "django-drf",
198
230
  "package_id": "django-drf",
@@ -1747,6 +1779,32 @@
1747
1779
  "workflow-specialists"
1748
1780
  ]
1749
1781
  },
1782
+ {
1783
+ "id": "stitch",
1784
+ "package_id": "stitch",
1785
+ "catalog_id": "stitch",
1786
+ "kind": "skill",
1787
+ "name": "stitch",
1788
+ "canonical": true,
1789
+ "canonical_id": "stitch",
1790
+ "deprecated": false,
1791
+ "replaced_by": null,
1792
+ "aliases": [],
1793
+ "category": "workflow-specialists",
1794
+ "layer": "workflow-specialists",
1795
+ "maturity": "incubating",
1796
+ "tier": "experimental",
1797
+ "tags": [
1798
+ "stitch",
1799
+ "workflow-specialists"
1800
+ ],
1801
+ "path": ".claude/skills/stitch/SKILL.md",
1802
+ "description": "Use when implementing or updating UI from Google Stitch artifacts, screen-to-code handoff, design-to-code diffs, or syncing an existing screen with the latest Stitch output through Cubis Foundry MCP.",
1803
+ "triggers": [
1804
+ "stitch",
1805
+ "workflow-specialists"
1806
+ ]
1807
+ },
1750
1808
  {
1751
1809
  "id": "stripe-integration",
1752
1810
  "package_id": "stripe-integration",
@@ -0,0 +1,93 @@
1
+ ---
2
+ name: stitch
3
+ description: Use when implementing or updating UI from Google Stitch artifacts, screen-to-code handoff, design-to-code diffs, or syncing an existing screen with the latest Stitch output through Cubis Foundry MCP.
4
+ allowed-tools: Read Grep Glob Bash Edit Write
5
+ context: fork
6
+ agent: frontend-specialist
7
+ user-invocable: true
8
+ argument-hint: "Stitch screen, design artifact, or UI diff to implement"
9
+ ---
10
+
11
+ # Stitch
12
+
13
+ ## Purpose
14
+
15
+ Turn Google Stitch artifacts into production-ready UI changes without guessing the design. This skill is for real Stitch-driven implementation and update work: fetch the latest Stitch artifacts through Cubis Foundry MCP, map them into the repo's actual stack and design system, and apply minimal, accessible changes.
16
+
17
+ ## When to Use
18
+
19
+ - Implementing a new screen from Stitch artifacts
20
+ - Updating an existing screen from refreshed Stitch output
21
+ - Performing design-to-code diffs against local UI
22
+ - Translating Stitch artifacts into React, Next.js, React Native, Flutter, SwiftUI, or another project framework
23
+ - Auditing whether the local screen still matches the current Stitch version
24
+
25
+ ## Instructions
26
+
27
+ 1. **Verify Stitch is reachable before relying on it**. Check `stitch_get_status` and `mcp_gateway_status` first. If Stitch is misconfigured or unavailable, say so clearly and do not invent screen details. See `references/platform-setup.md`.
28
+
29
+ 2. **List enabled Stitch tools before choosing a workflow**. Use `stitch_list_enabled_tools` or the Stitch passthrough namespace to confirm which real upstream tools are available in the current environment.
30
+
31
+ 3. **Normalize the request into a concrete implementation brief**. If the prompt is vague, restate the target screen, destination route or component, framework, responsive expectations, and reuse constraints before editing anything. This follows the same prompt-sharpening idea used in Stitch-first design workflows, but the output here should stay implementation-oriented.
32
+
33
+ 4. **Pull Stitch artifacts before planning implementation**. Fetch the actual screen artifact, code, metadata, and image/snapshot when available. Do not reconstruct the UI from a natural-language guess.
34
+
35
+ 5. **Map Stitch output into the repo's real stack**. Re-express the artifact in the project's framework, routing model, state layer, styling system, and component primitives. Do not paste generated output blindly. See `references/implementation-patterns.md`.
36
+
37
+ 6. **Prefer local component reuse over one-off markup**. If the project already has buttons, cards, typography, layout shells, tokens, or navigation primitives, use them instead of cloning raw Stitch structure.
38
+
39
+ 7. **Keep diffs minimal when updating an existing screen**. Compare the local implementation against the latest Stitch artifact and patch only the changed structure, spacing, copy, tokens, states, and assets. Preserve validated business logic and local architecture. See `references/update-diff-workflow.md`.
40
+
41
+ 8. **Use existing local exports or prior implementations as a diff baseline**. If the repo already contains the target screen or a prior Stitch-derived implementation, compare against that first. Refresh from Stitch when the task requires live parity; otherwise use the local baseline to reduce churn.
42
+
43
+ 9. **Preserve accessibility and interaction states**. Maintain semantic structure, keyboard flow, focus treatment, labels, contrast, loading/error/empty states, and responsive behavior while translating the design.
44
+
45
+ 10. **Call out unavoidable drift explicitly**. If the repo's design system, data model, or framework constraints prevent a literal Stitch match, explain the exact deviation and why it was necessary.
46
+
47
+ 11. **Ask only targeted clarification questions**. Ask when the artifact is ambiguous, multiple Stitch screens plausibly match, or the repo has competing destination surfaces. Otherwise proceed with the best repo-grounded implementation.
48
+
49
+ ## Output Format
50
+
51
+ Deliver:
52
+
53
+ 1. **Artifact summary** — which Stitch artifact or screen was used
54
+ 2. **Implementation plan** — target files, framework mapping, and any deviations
55
+ 3. **Code changes** — minimal production-ready implementation or patch
56
+ 4. **Diff notes** — what changed relative to the prior local UI, if applicable
57
+ 5. **Verification** — accessibility, responsive behavior, and any remaining gaps
58
+
59
+ ## References
60
+
61
+ Load only what the current task requires.
62
+
63
+ | File | Load when |
64
+ | --- | --- |
65
+ | `references/platform-setup.md` | Need to verify Stitch availability, gateway status, profile setup, or secure credential expectations. |
66
+ | `references/implementation-patterns.md` | Need guidance for mapping Stitch artifacts into web/mobile stacks and existing design systems. |
67
+ | `references/update-diff-workflow.md` | Updating an existing implementation from revised Stitch artifacts or running a UI diff workflow. |
68
+
69
+ ## Examples
70
+
71
+ Use these when the task closely matches the example shape.
72
+
73
+ | File | Use when |
74
+ | --- | --- |
75
+ | `examples/01-new-screen.md` | Creating a new screen from Stitch output. |
76
+ | `examples/02-update-existing-screen.md` | Patching an existing screen from updated Stitch artifacts. |
77
+ | `examples/03-mobile-handoff.md` | Translating Stitch into a mobile framework or native stack. |
78
+ | `examples/04-prompt-enhancement.md` | Turning a vague Stitch request into a concrete implementation brief before coding. |
79
+ | `examples/05-design-sync-loop.md` | Running an iterative Stitch refresh-and-patch loop for an existing product surface. |
80
+
81
+ ## Claude Stitch Flow
82
+
83
+ - Use `$ARGUMENTS` as the requested Stitch screen or implementation brief when this skill is invoked directly.
84
+ - Resolve any extra guidance from `${CLAUDE_SKILL_DIR}/references/platform-setup.md`, `${CLAUDE_SKILL_DIR}/references/implementation-patterns.md`, and `${CLAUDE_SKILL_DIR}/references/update-diff-workflow.md`.
85
+ - Start with Foundry gateway + Stitch status checks, then hand the concrete implementation work to the frontend-specialist fork only after the target artifact and destination surface are clear.
86
+
87
+ ## Claude Platform Notes
88
+
89
+ - Use `$ARGUMENTS` to access user-provided arguments passed when the skill is invoked.
90
+ - Reference skill-local files with `${CLAUDE_SKILL_DIR}/references/<file>` for portable paths.
91
+ - When `context: fork` is set, the skill runs in an isolated subagent context; the `agent` field names the fork target.
92
+ - MCP skill tools (`skill_search`, `skill_get`, `skill_validate`, `skill_get_reference`) are available for dynamic skill discovery and loading.
93
+ - Use `allowed-tools` in frontmatter to restrict tool access for security-sensitive skills.
@@ -0,0 +1,45 @@
1
+ # Stitch Eval Assertions
2
+
3
+ ## Eval 1: New Screen From Stitch Artifact
4
+
5
+ This eval checks the default Stitch-first implementation loop for a new web screen: verify availability, inspect enabled tools, fetch the real artifact, then map it into the current stack and design system.
6
+
7
+ ### Assertions
8
+
9
+ | # | Type | What it checks | Why it matters |
10
+ | --- | --- | --- | --- |
11
+ | 1 | contains | `stitch_get_status` | A Stitch workflow that does not verify reachability first can fabricate screen details or assume the wrong profile. |
12
+ | 2 | contains | `mcp_gateway_status` | Cubis Foundry is the client-facing runtime, so the skill must confirm the MCP gateway is healthy before depending on Stitch passthrough tools. |
13
+ | 3 | contains | `stitch_list_enabled_tools` | Stitch environments can expose different upstream capabilities; the skill should discover those instead of hardcoding an assumed toolset. |
14
+ | 4 | pattern | `PageShell|Card|Button|design system|token` | The implementation must reuse the repo's existing primitives or tokens rather than dumping raw generated markup into production. |
15
+ | 5 | pattern | `responsive|mobile|desktop|accessib` | Production-ready Stitch usage still has to preserve accessibility and responsive behavior. |
16
+
17
+ ### What a passing response looks like
18
+
19
+ - Starts with Stitch and gateway preflight instead of guessing the artifact.
20
+ - Mentions enabled Stitch tool discovery before choosing a retrieval path.
21
+ - Maps the design into the existing Next.js route and shared primitives.
22
+ - Calls out responsive and accessibility verification as part of the implementation.
23
+
24
+ ---
25
+
26
+ ## Eval 2: Minimal-Diff Stitch Sync For Existing Screen
27
+
28
+ This eval checks the update workflow: use the latest Stitch artifact as a diff source, preserve working local logic, and patch only the changed UI surface in a mobile implementation.
29
+
30
+ ### Assertions
31
+
32
+ | # | Type | What it checks | Why it matters |
33
+ | --- | --- | --- | --- |
34
+ | 1 | contains | `stitch_get_status` | The skill must verify that the refreshed Stitch artifact is actually reachable before claiming design parity. |
35
+ | 2 | contains | `stitch_list_enabled_tools` | Tool discovery matters for update flows too, especially when comparing local UI against the current Stitch surface. |
36
+ | 3 | pattern | `minimal diff|patch only|changed only|diff` | Refreshing from Stitch should not default to a full rewrite when an implementation already exists. |
37
+ | 4 | pattern | `analytics|feature flag|business logic|preserve` | Existing instrumentation and product logic are usually validated already and should survive the UI sync. |
38
+ | 5 | pattern | `React Native|mobile|component|accessib|token` | The final patch must respect the target mobile stack and retain design-system and accessibility quality. |
39
+
40
+ ### What a passing response looks like
41
+
42
+ - Treats Stitch as the source of truth for changed UI details, not for reauthoring the whole screen.
43
+ - Preserves analytics hooks, feature flags, and business logic.
44
+ - Describes a targeted patch path in React Native or another mobile stack.
45
+ - Mentions accessibility, component reuse, and design-token consistency in the final implementation notes.