@cubis/foundry 0.3.32 → 0.3.34

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 (461) hide show
  1. package/CHANGELOG.md +30 -0
  2. package/README.md +23 -0
  3. package/bin/cubis.js +461 -37
  4. package/mcp/README.md +17 -0
  5. package/mcp/catalogs/default.json +14 -0
  6. package/mcp/powers/atlassian-mcp/POWER.md +91 -0
  7. package/mcp/powers/atlassian-mcp/SKILL.md +88 -0
  8. package/mcp/powers/building-mcp-server-on-cloudflare/POWER.md +261 -0
  9. package/mcp/powers/building-mcp-server-on-cloudflare/SKILL.md +258 -0
  10. package/mcp/powers/datadog-automation/POWER.md +238 -0
  11. package/mcp/powers/datadog-automation/SKILL.md +235 -0
  12. package/mcp/powers/github-automation/POWER.md +230 -0
  13. package/mcp/powers/github-automation/SKILL.md +227 -0
  14. package/mcp/powers/mcp-builder/POWER.md +179 -0
  15. package/mcp/powers/mcp-builder/SKILL.md +176 -0
  16. package/mcp/powers/mcp-developer/POWER.md +88 -0
  17. package/mcp/powers/mcp-developer/SKILL.md +85 -0
  18. package/mcp/powers/postman/POWER.md +243 -0
  19. package/mcp/powers/postman/SKILL.md +240 -0
  20. package/mcp/powers/sentry-automation/POWER.md +235 -0
  21. package/mcp/powers/sentry-automation/SKILL.md +232 -0
  22. package/mcp/skills/atlassian-mcp/SKILL.md +88 -0
  23. package/mcp/skills/building-mcp-server-on-cloudflare/SKILL.md +258 -0
  24. package/mcp/skills/datadog-automation/SKILL.md +235 -0
  25. package/mcp/skills/github-automation/SKILL.md +227 -0
  26. package/mcp/skills/mcp-builder/SKILL.md +176 -0
  27. package/mcp/skills/mcp-developer/SKILL.md +85 -0
  28. package/mcp/skills/postman/SKILL.md +240 -0
  29. package/mcp/skills/sentry-automation/SKILL.md +232 -0
  30. package/package.json +2 -1
  31. package/workflows/powers/architecture/POWER.md +12 -46
  32. package/workflows/powers/architecture/SKILL.md +12 -46
  33. package/workflows/powers/atlassian-mcp/POWER.md +11 -81
  34. package/workflows/powers/atlassian-mcp/SKILL.md +11 -81
  35. package/workflows/powers/building-mcp-server-on-cloudflare/POWER.md +12 -252
  36. package/workflows/powers/building-mcp-server-on-cloudflare/SKILL.md +12 -252
  37. package/workflows/powers/code-review-checklist/POWER.md +11 -99
  38. package/workflows/powers/code-review-checklist/SKILL.md +11 -99
  39. package/workflows/powers/csharp-pro/POWER.md +43 -0
  40. package/workflows/powers/csharp-pro/SKILL.md +40 -0
  41. package/workflows/powers/database-design/POWER.md +47 -5
  42. package/workflows/powers/database-design/SKILL.md +45 -4
  43. package/workflows/powers/database-optimizer/POWER.md +11 -23
  44. package/workflows/powers/database-optimizer/SKILL.md +5 -5
  45. package/workflows/powers/datadog-automation/POWER.md +12 -229
  46. package/workflows/powers/datadog-automation/SKILL.md +12 -229
  47. package/workflows/powers/debugging-wizard/POWER.md +12 -78
  48. package/workflows/powers/debugging-wizard/SKILL.md +12 -78
  49. package/workflows/powers/deployment-procedures/POWER.md +11 -231
  50. package/workflows/powers/deployment-procedures/SKILL.md +11 -231
  51. package/workflows/powers/drift-flutter/POWER.md +51 -0
  52. package/workflows/powers/drift-flutter/SKILL.md +2 -2
  53. package/workflows/powers/github-automation/POWER.md +12 -221
  54. package/workflows/powers/github-automation/SKILL.md +12 -221
  55. package/workflows/powers/golang-pro/POWER.md +38 -66
  56. package/workflows/powers/golang-pro/SKILL.md +38 -66
  57. package/workflows/powers/java-pro/POWER.md +43 -0
  58. package/workflows/powers/java-pro/SKILL.md +40 -0
  59. package/workflows/powers/javascript-pro/POWER.md +37 -67
  60. package/workflows/powers/javascript-pro/SKILL.md +37 -67
  61. package/workflows/powers/kotlin-pro/POWER.md +43 -0
  62. package/workflows/powers/kotlin-pro/SKILL.md +40 -0
  63. package/workflows/powers/mcp-builder/POWER.md +12 -170
  64. package/workflows/powers/mcp-builder/SKILL.md +12 -170
  65. package/workflows/powers/mcp-developer/POWER.md +11 -78
  66. package/workflows/powers/mcp-developer/SKILL.md +11 -78
  67. package/workflows/powers/nextjs-developer/POWER.md +41 -148
  68. package/workflows/powers/nextjs-developer/SKILL.md +41 -148
  69. package/workflows/powers/nextjs-react-expert/POWER.md +10 -281
  70. package/workflows/powers/nextjs-react-expert/SKILL.md +10 -281
  71. package/workflows/powers/nodejs-best-practices/POWER.md +33 -317
  72. package/workflows/powers/nodejs-best-practices/SKILL.md +33 -317
  73. package/workflows/powers/postman/POWER.md +11 -233
  74. package/workflows/powers/postman/SKILL.md +11 -233
  75. package/workflows/powers/python-patterns/POWER.md +11 -431
  76. package/workflows/powers/python-patterns/SKILL.md +11 -431
  77. package/workflows/powers/python-pro/POWER.md +38 -66
  78. package/workflows/powers/python-pro/SKILL.md +38 -66
  79. package/workflows/powers/react-best-practices/POWER.md +35 -118
  80. package/workflows/powers/react-best-practices/SKILL.md +35 -118
  81. package/workflows/powers/react-expert/POWER.md +38 -66
  82. package/workflows/powers/react-expert/SKILL.md +38 -66
  83. package/workflows/powers/rust-engineer/POWER.md +10 -75
  84. package/workflows/powers/rust-engineer/SKILL.md +10 -75
  85. package/workflows/powers/rust-pro/POWER.md +36 -163
  86. package/workflows/powers/rust-pro/SKILL.md +36 -163
  87. package/workflows/powers/sentry-automation/POWER.md +12 -226
  88. package/workflows/powers/sentry-automation/SKILL.md +12 -226
  89. package/workflows/powers/server-management/POWER.md +11 -151
  90. package/workflows/powers/server-management/SKILL.md +11 -151
  91. package/workflows/powers/tdd-workflow/POWER.md +12 -140
  92. package/workflows/powers/tdd-workflow/SKILL.md +12 -140
  93. package/workflows/powers/testing-patterns/POWER.md +11 -168
  94. package/workflows/powers/testing-patterns/SKILL.md +11 -168
  95. package/workflows/powers/typescript-pro/POWER.md +43 -70
  96. package/workflows/powers/typescript-pro/SKILL.md +43 -70
  97. package/workflows/powers/vercel-ai/POWER.md +43 -0
  98. package/workflows/powers/vercel-ai/SKILL.md +40 -0
  99. package/workflows/powers/vercel-ai-gateway/POWER.md +11 -69
  100. package/workflows/powers/vercel-ai-gateway/SKILL.md +11 -69
  101. package/workflows/powers/vercel-ai-sdk/POWER.md +11 -49
  102. package/workflows/powers/vercel-ai-sdk/SKILL.md +11 -49
  103. package/workflows/powers/vercel-caching/POWER.md +10 -72
  104. package/workflows/powers/vercel-caching/SKILL.md +10 -72
  105. package/workflows/powers/vercel-cli/POWER.md +11 -75
  106. package/workflows/powers/vercel-cli/SKILL.md +11 -75
  107. package/workflows/powers/vercel-delivery/POWER.md +45 -0
  108. package/workflows/powers/vercel-delivery/SKILL.md +42 -0
  109. package/workflows/powers/vercel-deployments/POWER.md +10 -90
  110. package/workflows/powers/vercel-deployments/SKILL.md +10 -90
  111. package/workflows/powers/vercel-domains/POWER.md +10 -69
  112. package/workflows/powers/vercel-domains/SKILL.md +10 -69
  113. package/workflows/powers/vercel-firewall/POWER.md +10 -61
  114. package/workflows/powers/vercel-firewall/SKILL.md +10 -61
  115. package/workflows/powers/vercel-flags/POWER.md +10 -62
  116. package/workflows/powers/vercel-flags/SKILL.md +10 -62
  117. package/workflows/powers/vercel-functions/POWER.md +10 -70
  118. package/workflows/powers/vercel-functions/SKILL.md +10 -70
  119. package/workflows/powers/vercel-routing/POWER.md +10 -68
  120. package/workflows/powers/vercel-routing/SKILL.md +10 -68
  121. package/workflows/powers/vercel-runtime/POWER.md +43 -0
  122. package/workflows/powers/vercel-runtime/SKILL.md +40 -0
  123. package/workflows/powers/vercel-security/POWER.md +43 -0
  124. package/workflows/powers/vercel-security/SKILL.md +40 -0
  125. package/workflows/powers/vulnerability-scanner/POWER.md +11 -266
  126. package/workflows/powers/vulnerability-scanner/SKILL.md +11 -266
  127. package/workflows/scripts/generate-powers.mjs +95 -202
  128. package/workflows/skills/atlassian-mcp/SKILL.md +11 -81
  129. package/workflows/skills/building-mcp-server-on-cloudflare/SKILL.md +12 -252
  130. package/workflows/skills/catalogs/core.json +30 -0
  131. package/workflows/skills/catalogs/web-backend.json +70 -0
  132. package/workflows/skills/csharp-pro/SKILL.md +40 -0
  133. package/workflows/skills/datadog-automation/SKILL.md +12 -229
  134. package/workflows/skills/github-automation/SKILL.md +12 -221
  135. package/workflows/skills/golang-pro/SKILL.md +38 -66
  136. package/workflows/skills/java-pro/SKILL.md +40 -0
  137. package/workflows/skills/javascript-pro/SKILL.md +37 -67
  138. package/workflows/skills/kotlin-pro/SKILL.md +40 -0
  139. package/workflows/skills/mcp-builder/SKILL.md +12 -170
  140. package/workflows/skills/mcp-developer/SKILL.md +11 -78
  141. package/workflows/skills/nextjs-developer/SKILL.md +41 -148
  142. package/workflows/skills/nextjs-react-expert/SKILL.md +5 -11
  143. package/workflows/skills/nodejs-best-practices/SKILL.md +33 -317
  144. package/workflows/skills/postman/SKILL.md +11 -233
  145. package/workflows/skills/python-pro/SKILL.md +38 -66
  146. package/workflows/skills/react-best-practices/SKILL.md +35 -118
  147. package/workflows/skills/react-expert/SKILL.md +38 -66
  148. package/workflows/skills/rust-pro/SKILL.md +36 -163
  149. package/workflows/skills/sentry-automation/SKILL.md +12 -226
  150. package/workflows/skills/skills_index.json +43 -57
  151. package/workflows/skills/typescript-pro/SKILL.md +43 -70
  152. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/backend-specialist.md +1 -1
  153. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/code-archaeologist.md +1 -1
  154. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/database-architect.md +1 -1
  155. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/debugger.md +1 -1
  156. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/devops-engineer.md +1 -1
  157. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/documentation-writer.md +1 -1
  158. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/explorer-agent.md +1 -1
  159. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/frontend-specialist.md +1 -1
  160. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/game-developer.md +1 -1
  161. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/mobile-developer.md +1 -1
  162. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/orchestrator.md +28 -400
  163. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/penetration-tester.md +1 -1
  164. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/performance-optimizer.md +1 -1
  165. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/product-manager.md +1 -1
  166. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/product-owner.md +1 -1
  167. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/project-planner.md +1 -1
  168. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/qa-automation-engineer.md +1 -1
  169. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/security-auditor.md +1 -1
  170. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/seo-specialist.md +1 -1
  171. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/test-engineer.md +1 -1
  172. package/workflows/workflows/agent-environment-setup/platforms/antigravity/agents/vercel-expert.md +1 -1
  173. package/workflows/workflows/agent-environment-setup/platforms/antigravity/rules/GEMINI.md +7 -6
  174. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/backend-specialist.md +1 -1
  175. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/code-archaeologist.md +1 -1
  176. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/database-architect.md +1 -1
  177. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/debugger.md +1 -1
  178. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/devops-engineer.md +1 -1
  179. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/documentation-writer.md +1 -1
  180. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/explorer-agent.md +1 -1
  181. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/frontend-specialist.md +1 -1
  182. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/game-developer.md +1 -1
  183. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/mobile-developer.md +1 -1
  184. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/orchestrator.md +28 -400
  185. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/penetration-tester.md +1 -1
  186. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/performance-optimizer.md +1 -1
  187. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/product-manager.md +1 -1
  188. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/product-owner.md +1 -1
  189. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/project-planner.md +1 -1
  190. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/qa-automation-engineer.md +1 -1
  191. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/security-auditor.md +1 -1
  192. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/seo-specialist.md +1 -1
  193. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/test-engineer.md +1 -1
  194. package/workflows/workflows/agent-environment-setup/platforms/codex/agents/vercel-expert.md +1 -1
  195. package/workflows/workflows/agent-environment-setup/platforms/codex/rules/AGENTS.md +7 -6
  196. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/backend-specialist.md +1 -1
  197. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/code-archaeologist.md +1 -1
  198. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/database-architect.md +1 -1
  199. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/debugger.md +1 -1
  200. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/devops-engineer.md +1 -1
  201. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/documentation-writer.md +1 -1
  202. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/explorer-agent.md +1 -1
  203. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/frontend-specialist.md +1 -1
  204. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/game-developer.md +1 -1
  205. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/mobile-developer.md +1 -1
  206. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/orchestrator.md +28 -400
  207. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/penetration-tester.md +1 -1
  208. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/performance-optimizer.md +1 -1
  209. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/product-manager.md +1 -1
  210. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/product-owner.md +1 -1
  211. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/project-planner.md +1 -1
  212. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/qa-automation-engineer.md +1 -1
  213. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/security-auditor.md +1 -1
  214. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/seo-specialist.md +1 -1
  215. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/test-engineer.md +1 -1
  216. package/workflows/workflows/agent-environment-setup/platforms/copilot/agents/vercel-expert.md +1 -1
  217. package/workflows/workflows/agent-environment-setup/platforms/copilot/rules/AGENTS.md +7 -6
  218. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/csharp-pro/SKILL.md +40 -0
  219. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/golang-pro/SKILL.md +38 -66
  220. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/java-pro/SKILL.md +40 -0
  221. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/javascript-pro/SKILL.md +37 -67
  222. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/kotlin-pro/SKILL.md +40 -0
  223. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/nextjs-developer/SKILL.md +41 -148
  224. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/nextjs-react-expert/SKILL.md +6 -12
  225. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/nodejs-best-practices/SKILL.md +33 -317
  226. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/python-pro/SKILL.md +38 -66
  227. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/react-best-practices/SKILL.md +35 -118
  228. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/react-expert/SKILL.md +38 -66
  229. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/rust-pro/SKILL.md +36 -163
  230. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/skills_index.json +43 -57
  231. package/workflows/workflows/agent-environment-setup/platforms/copilot/skills/typescript-pro/SKILL.md +43 -70
  232. package/workflows/workflows/agent-environment-setup/platforms/cursor/skills/csharp-pro/SKILL.md +40 -0
  233. package/workflows/workflows/agent-environment-setup/platforms/cursor/skills/golang-pro/SKILL.md +38 -66
  234. package/workflows/workflows/agent-environment-setup/platforms/cursor/skills/java-pro/SKILL.md +40 -0
  235. package/workflows/workflows/agent-environment-setup/platforms/cursor/skills/javascript-pro/SKILL.md +37 -67
  236. package/workflows/workflows/agent-environment-setup/platforms/cursor/skills/kotlin-pro/SKILL.md +40 -0
  237. package/workflows/workflows/agent-environment-setup/platforms/cursor/skills/nextjs-developer/SKILL.md +41 -148
  238. package/workflows/workflows/agent-environment-setup/platforms/cursor/skills/nextjs-react-expert/SKILL.md +6 -12
  239. package/workflows/workflows/agent-environment-setup/platforms/cursor/skills/nodejs-best-practices/SKILL.md +33 -317
  240. package/workflows/workflows/agent-environment-setup/platforms/cursor/skills/python-pro/SKILL.md +38 -66
  241. package/workflows/workflows/agent-environment-setup/platforms/cursor/skills/react-best-practices/SKILL.md +35 -118
  242. package/workflows/workflows/agent-environment-setup/platforms/cursor/skills/react-expert/SKILL.md +38 -66
  243. package/workflows/workflows/agent-environment-setup/platforms/cursor/skills/rust-pro/SKILL.md +36 -163
  244. package/workflows/workflows/agent-environment-setup/platforms/cursor/skills/skills_index.json +43 -57
  245. package/workflows/workflows/agent-environment-setup/platforms/cursor/skills/typescript-pro/SKILL.md +43 -70
  246. package/workflows/workflows/agent-environment-setup/platforms/windsurf/skills/csharp-pro/SKILL.md +40 -0
  247. package/workflows/workflows/agent-environment-setup/platforms/windsurf/skills/golang-pro/SKILL.md +38 -66
  248. package/workflows/workflows/agent-environment-setup/platforms/windsurf/skills/java-pro/SKILL.md +40 -0
  249. package/workflows/workflows/agent-environment-setup/platforms/windsurf/skills/javascript-pro/SKILL.md +37 -67
  250. package/workflows/workflows/agent-environment-setup/platforms/windsurf/skills/kotlin-pro/SKILL.md +40 -0
  251. package/workflows/workflows/agent-environment-setup/platforms/windsurf/skills/nextjs-developer/SKILL.md +41 -148
  252. package/workflows/workflows/agent-environment-setup/platforms/windsurf/skills/nextjs-react-expert/SKILL.md +6 -12
  253. package/workflows/workflows/agent-environment-setup/platforms/windsurf/skills/nodejs-best-practices/SKILL.md +33 -317
  254. package/workflows/workflows/agent-environment-setup/platforms/windsurf/skills/python-pro/SKILL.md +38 -66
  255. package/workflows/workflows/agent-environment-setup/platforms/windsurf/skills/react-best-practices/SKILL.md +35 -118
  256. package/workflows/workflows/agent-environment-setup/platforms/windsurf/skills/react-expert/SKILL.md +38 -66
  257. package/workflows/workflows/agent-environment-setup/platforms/windsurf/skills/rust-pro/SKILL.md +36 -163
  258. package/workflows/workflows/agent-environment-setup/platforms/windsurf/skills/skills_index.json +43 -57
  259. package/workflows/workflows/agent-environment-setup/platforms/windsurf/skills/typescript-pro/SKILL.md +43 -70
  260. package/workflows/workflows/agent-environment-setup/shared/agents/backend-specialist.md +1 -1
  261. package/workflows/workflows/agent-environment-setup/shared/agents/code-archaeologist.md +1 -1
  262. package/workflows/workflows/agent-environment-setup/shared/agents/database-architect.md +1 -1
  263. package/workflows/workflows/agent-environment-setup/shared/agents/debugger.md +1 -1
  264. package/workflows/workflows/agent-environment-setup/shared/agents/devops-engineer.md +1 -1
  265. package/workflows/workflows/agent-environment-setup/shared/agents/documentation-writer.md +1 -1
  266. package/workflows/workflows/agent-environment-setup/shared/agents/explorer-agent.md +1 -1
  267. package/workflows/workflows/agent-environment-setup/shared/agents/frontend-specialist.md +1 -1
  268. package/workflows/workflows/agent-environment-setup/shared/agents/game-developer.md +1 -1
  269. package/workflows/workflows/agent-environment-setup/shared/agents/mobile-developer.md +1 -1
  270. package/workflows/workflows/agent-environment-setup/shared/agents/orchestrator.md +28 -400
  271. package/workflows/workflows/agent-environment-setup/shared/agents/penetration-tester.md +1 -1
  272. package/workflows/workflows/agent-environment-setup/shared/agents/performance-optimizer.md +1 -1
  273. package/workflows/workflows/agent-environment-setup/shared/agents/product-manager.md +1 -1
  274. package/workflows/workflows/agent-environment-setup/shared/agents/product-owner.md +1 -1
  275. package/workflows/workflows/agent-environment-setup/shared/agents/project-planner.md +1 -1
  276. package/workflows/workflows/agent-environment-setup/shared/agents/qa-automation-engineer.md +1 -1
  277. package/workflows/workflows/agent-environment-setup/shared/agents/security-auditor.md +1 -1
  278. package/workflows/workflows/agent-environment-setup/shared/agents/seo-specialist.md +1 -1
  279. package/workflows/workflows/agent-environment-setup/shared/agents/test-engineer.md +1 -1
  280. package/workflows/workflows/agent-environment-setup/shared/agents/vercel-expert.md +1 -1
  281. package/workflows/powers/sub-agents/scripts/run_subagent.py.bak +0 -512
  282. /package/{workflows → mcp}/powers/atlassian-mcp/steering/authentication-patterns.md +0 -0
  283. /package/{workflows → mcp}/powers/atlassian-mcp/steering/common-workflows.md +0 -0
  284. /package/{workflows → mcp}/powers/atlassian-mcp/steering/confluence-operations.md +0 -0
  285. /package/{workflows → mcp}/powers/atlassian-mcp/steering/jira-queries.md +0 -0
  286. /package/{workflows → mcp}/powers/atlassian-mcp/steering/mcp-server-setup.md +0 -0
  287. /package/{workflows → mcp}/powers/building-mcp-server-on-cloudflare/steering/examples.md +0 -0
  288. /package/{workflows → mcp}/powers/building-mcp-server-on-cloudflare/steering/oauth-setup.md +0 -0
  289. /package/{workflows → mcp}/powers/building-mcp-server-on-cloudflare/steering/troubleshooting.md +0 -0
  290. /package/{workflows → mcp}/powers/mcp-builder/LICENSE.txt +0 -0
  291. /package/{workflows → mcp}/powers/mcp-builder/reference/evaluation.md +0 -0
  292. /package/{workflows → mcp}/powers/mcp-builder/reference/mcp_best_practices.md +0 -0
  293. /package/{workflows → mcp}/powers/mcp-builder/reference/node_mcp_server.md +0 -0
  294. /package/{workflows → mcp}/powers/mcp-builder/reference/python_mcp_server.md +0 -0
  295. /package/{workflows → mcp}/powers/mcp-builder/scripts/connections.py +0 -0
  296. /package/{workflows → mcp}/powers/mcp-builder/scripts/evaluation.py +0 -0
  297. /package/{workflows → mcp}/powers/mcp-builder/scripts/example_evaluation.xml +0 -0
  298. /package/{workflows → mcp}/powers/mcp-builder/scripts/requirements.txt +0 -0
  299. /package/{workflows → mcp}/powers/mcp-developer/steering/protocol.md +0 -0
  300. /package/{workflows → mcp}/powers/mcp-developer/steering/python-sdk.md +0 -0
  301. /package/{workflows → mcp}/powers/mcp-developer/steering/resources.md +0 -0
  302. /package/{workflows → mcp}/powers/mcp-developer/steering/tools.md +0 -0
  303. /package/{workflows → mcp}/powers/mcp-developer/steering/typescript-sdk.md +0 -0
  304. /package/{workflows → mcp}/powers/postman/flutter-expert/POWER.md +0 -0
  305. /package/{workflows → mcp}/powers/postman/flutter-expert/SKILL.md +0 -0
  306. /package/{workflows → mcp}/powers/postman/flutter-expert/steering/bloc-state.md +0 -0
  307. /package/{workflows → mcp}/powers/postman/flutter-expert/steering/engineering-principles.md +0 -0
  308. /package/{workflows → mcp}/powers/postman/flutter-expert/steering/gorouter-navigation.md +0 -0
  309. /package/{workflows → mcp}/powers/postman/flutter-expert/steering/performance.md +0 -0
  310. /package/{workflows → mcp}/powers/postman/flutter-expert/steering/project-structure.md +0 -0
  311. /package/{workflows → mcp}/powers/postman/flutter-expert/steering/riverpod-state.md +0 -0
  312. /package/{workflows → mcp}/powers/postman/flutter-expert/steering/widget-patterns.md +0 -0
  313. /package/{workflows → mcp}/powers/postman/flutter-security-reviewer/POWER.md +0 -0
  314. /package/{workflows → mcp}/powers/postman/flutter-security-reviewer/SKILL.md +0 -0
  315. /package/{workflows → mcp}/powers/postman/flutter-security-reviewer/steering/log_redaction.md +0 -0
  316. /package/{workflows → mcp}/powers/postman/flutter-security-reviewer/steering/network_hardening.md +0 -0
  317. /package/{workflows → mcp}/powers/postman/flutter-security-reviewer/steering/secret-scanning.md +0 -0
  318. /package/{workflows → mcp}/powers/postman/flutter-security-reviewer/steering/secure_storage_policy.md +0 -0
  319. /package/{workflows → mcp}/powers/postman/flutter-security-reviewer/steering/vulnerability-patterns.md +0 -0
  320. /package/{workflows → mcp}/powers/postman/flutter-security-reviewer/templates/security_review_response.md +0 -0
  321. /package/{workflows → mcp}/powers/postman/flutter-test-master/POWER.md +0 -0
  322. /package/{workflows → mcp}/powers/postman/flutter-test-master/SKILL.md +0 -0
  323. /package/{workflows → mcp}/powers/postman/flutter-test-master/steering/golden-testing.md +0 -0
  324. /package/{workflows → mcp}/powers/postman/flutter-test-master/steering/integration-testing.md +0 -0
  325. /package/{workflows → mcp}/powers/postman/flutter-test-master/steering/property-testing.md +0 -0
  326. /package/{workflows → mcp}/powers/postman/flutter-test-master/steering/riverpod-testing.md +0 -0
  327. /package/{workflows → mcp}/powers/postman/flutter-test-master/steering/test-utilities.md +0 -0
  328. /package/{workflows → mcp}/powers/postman/flutter-test-master/steering/unit-testing.md +0 -0
  329. /package/{workflows → mcp}/powers/postman/flutter-test-master/steering/widget-testing.md +0 -0
  330. /package/{workflows → mcp}/powers/postman/git-commit/POWER.md +0 -0
  331. /package/{workflows → mcp}/powers/postman/git-commit/SKILL.md +0 -0
  332. /package/{workflows → mcp}/powers/postman/gorouter-restoration/POWER.md +0 -0
  333. /package/{workflows → mcp}/powers/postman/gorouter-restoration/SKILL.md +0 -0
  334. /package/{workflows → mcp}/powers/postman/gorouter-restoration/steering/guard_patterns.md +0 -0
  335. /package/{workflows → mcp}/powers/postman/gorouter-restoration/steering/tab_preservation.md +0 -0
  336. /package/{workflows → mcp}/powers/postman/gorouter-restoration/templates/guard_redirect.md +0 -0
  337. /package/{workflows → mcp}/powers/postman/gorouter-restoration/templates/stateful_shell_skeleton.md +0 -0
  338. /package/{workflows → mcp}/powers/postman/mcp.json +0 -0
  339. /package/{workflows → mcp}/powers/postman/microservices-architect/POWER.md +0 -0
  340. /package/{workflows → mcp}/powers/postman/microservices-architect/SKILL.md +0 -0
  341. /package/{workflows → mcp}/powers/postman/microservices-architect/steering/communication.md +0 -0
  342. /package/{workflows → mcp}/powers/postman/microservices-architect/steering/data.md +0 -0
  343. /package/{workflows → mcp}/powers/postman/microservices-architect/steering/decomposition.md +0 -0
  344. /package/{workflows → mcp}/powers/postman/microservices-architect/steering/observability.md +0 -0
  345. /package/{workflows → mcp}/powers/postman/microservices-architect/steering/patterns.md +0 -0
  346. /package/{workflows → mcp}/powers/postman/nestjs-expert/POWER.md +0 -0
  347. /package/{workflows → mcp}/powers/postman/nestjs-expert/SKILL.md +0 -0
  348. /package/{workflows → mcp}/powers/postman/nestjs-expert/steering/authentication.md +0 -0
  349. /package/{workflows → mcp}/powers/postman/nestjs-expert/steering/controllers-routing.md +0 -0
  350. /package/{workflows → mcp}/powers/postman/nestjs-expert/steering/dtos-validation.md +0 -0
  351. /package/{workflows → mcp}/powers/postman/nestjs-expert/steering/migration-from-express.md +0 -0
  352. /package/{workflows → mcp}/powers/postman/nestjs-expert/steering/secure-sessions.md +0 -0
  353. /package/{workflows → mcp}/powers/postman/nestjs-expert/steering/services-di.md +0 -0
  354. /package/{workflows → mcp}/powers/postman/nestjs-expert/steering/strangler-fig-pattern.md +0 -0
  355. /package/{workflows → mcp}/powers/postman/nestjs-expert/steering/testing-patterns.md +0 -0
  356. /package/{workflows → mcp}/powers/postman/oneup-design/POWER.md +0 -0
  357. /package/{workflows → mcp}/powers/postman/oneup-design/SKILL.md +0 -0
  358. /package/{workflows → mcp}/powers/postman/oneup-design/steering/colors.md +0 -0
  359. /package/{workflows → mcp}/powers/postman/oneup-design/steering/components.md +0 -0
  360. /package/{workflows → mcp}/powers/postman/oneup-design/steering/spacing.md +0 -0
  361. /package/{workflows → mcp}/powers/postman/openapi-docs/POWER.md +0 -0
  362. /package/{workflows → mcp}/powers/postman/openapi-docs/SKILL.md +0 -0
  363. /package/{workflows → mcp}/powers/postman/openapi-docs/steering/crud-templates.md +0 -0
  364. /package/{workflows → mcp}/powers/postman/openapi-docs/steering/framework-express.md +0 -0
  365. /package/{workflows → mcp}/powers/postman/openapi-docs/steering/framework-fastapi.md +0 -0
  366. /package/{workflows → mcp}/powers/postman/openapi-docs/steering/framework-nestjs.md +0 -0
  367. /package/{workflows → mcp}/powers/postman/openapi-docs/steering/framework-raw-openapi.md +0 -0
  368. /package/{workflows → mcp}/powers/postman/openapi-docs/steering/openapi-checklist.md +0 -0
  369. /package/{workflows → mcp}/powers/postman/openapi-docs/steering/stoplight-ui.md +0 -0
  370. /package/{workflows → mcp}/powers/postman/steering/steering.md +0 -0
  371. /package/{workflows → mcp}/skills/atlassian-mcp/references/authentication-patterns.md +0 -0
  372. /package/{workflows → mcp}/skills/atlassian-mcp/references/common-workflows.md +0 -0
  373. /package/{workflows → mcp}/skills/atlassian-mcp/references/confluence-operations.md +0 -0
  374. /package/{workflows → mcp}/skills/atlassian-mcp/references/jira-queries.md +0 -0
  375. /package/{workflows → mcp}/skills/atlassian-mcp/references/mcp-server-setup.md +0 -0
  376. /package/{workflows → mcp}/skills/building-mcp-server-on-cloudflare/references/examples.md +0 -0
  377. /package/{workflows → mcp}/skills/building-mcp-server-on-cloudflare/references/oauth-setup.md +0 -0
  378. /package/{workflows → mcp}/skills/building-mcp-server-on-cloudflare/references/tool-patterns.md +0 -0
  379. /package/{workflows → mcp}/skills/building-mcp-server-on-cloudflare/references/troubleshooting.md +0 -0
  380. /package/{workflows → mcp}/skills/mcp-builder/LICENSE.txt +0 -0
  381. /package/{workflows → mcp}/skills/mcp-builder/reference/evaluation.md +0 -0
  382. /package/{workflows → mcp}/skills/mcp-builder/reference/mcp_best_practices.md +0 -0
  383. /package/{workflows → mcp}/skills/mcp-builder/reference/node_mcp_server.md +0 -0
  384. /package/{workflows → mcp}/skills/mcp-builder/reference/python_mcp_server.md +0 -0
  385. /package/{workflows → mcp}/skills/mcp-builder/scripts/connections.py +0 -0
  386. /package/{workflows → mcp}/skills/mcp-builder/scripts/evaluation.py +0 -0
  387. /package/{workflows → mcp}/skills/mcp-builder/scripts/example_evaluation.xml +0 -0
  388. /package/{workflows → mcp}/skills/mcp-builder/scripts/requirements.txt +0 -0
  389. /package/{workflows → mcp}/skills/mcp-developer/references/protocol.md +0 -0
  390. /package/{workflows → mcp}/skills/mcp-developer/references/python-sdk.md +0 -0
  391. /package/{workflows → mcp}/skills/mcp-developer/references/resources.md +0 -0
  392. /package/{workflows → mcp}/skills/mcp-developer/references/tools.md +0 -0
  393. /package/{workflows → mcp}/skills/mcp-developer/references/typescript-sdk.md +0 -0
  394. /package/{workflows → mcp}/skills/postman/POWER.md +0 -0
  395. /package/{workflows → mcp}/skills/postman/flutter-expert/POWER.md +0 -0
  396. /package/{workflows → mcp}/skills/postman/flutter-expert/SKILL.md +0 -0
  397. /package/{workflows → mcp}/skills/postman/flutter-expert/references/bloc-state.md +0 -0
  398. /package/{workflows → mcp}/skills/postman/flutter-expert/references/engineering-principles.md +0 -0
  399. /package/{workflows → mcp}/skills/postman/flutter-expert/references/gorouter-navigation.md +0 -0
  400. /package/{workflows → mcp}/skills/postman/flutter-expert/references/performance.md +0 -0
  401. /package/{workflows → mcp}/skills/postman/flutter-expert/references/project-structure.md +0 -0
  402. /package/{workflows → mcp}/skills/postman/flutter-expert/references/riverpod-state.md +0 -0
  403. /package/{workflows → mcp}/skills/postman/flutter-expert/references/widget-patterns.md +0 -0
  404. /package/{workflows → mcp}/skills/postman/flutter-security-reviewer/POWER.md +0 -0
  405. /package/{workflows → mcp}/skills/postman/flutter-security-reviewer/SKILL.md +0 -0
  406. /package/{workflows → mcp}/skills/postman/flutter-security-reviewer/references/log_redaction.md +0 -0
  407. /package/{workflows → mcp}/skills/postman/flutter-security-reviewer/references/network_hardening.md +0 -0
  408. /package/{workflows → mcp}/skills/postman/flutter-security-reviewer/references/secret-scanning.md +0 -0
  409. /package/{workflows → mcp}/skills/postman/flutter-security-reviewer/references/secure_storage_policy.md +0 -0
  410. /package/{workflows → mcp}/skills/postman/flutter-security-reviewer/references/vulnerability-patterns.md +0 -0
  411. /package/{workflows → mcp}/skills/postman/flutter-security-reviewer/templates/security_review_response.md +0 -0
  412. /package/{workflows → mcp}/skills/postman/flutter-test-master/POWER.md +0 -0
  413. /package/{workflows → mcp}/skills/postman/flutter-test-master/SKILL.md +0 -0
  414. /package/{workflows → mcp}/skills/postman/flutter-test-master/references/golden-testing.md +0 -0
  415. /package/{workflows → mcp}/skills/postman/flutter-test-master/references/integration-testing.md +0 -0
  416. /package/{workflows → mcp}/skills/postman/flutter-test-master/references/property-testing.md +0 -0
  417. /package/{workflows → mcp}/skills/postman/flutter-test-master/references/riverpod-testing.md +0 -0
  418. /package/{workflows → mcp}/skills/postman/flutter-test-master/references/test-utilities.md +0 -0
  419. /package/{workflows → mcp}/skills/postman/flutter-test-master/references/unit-testing.md +0 -0
  420. /package/{workflows → mcp}/skills/postman/flutter-test-master/references/widget-testing.md +0 -0
  421. /package/{workflows → mcp}/skills/postman/git-commit/POWER.md +0 -0
  422. /package/{workflows → mcp}/skills/postman/git-commit/SKILL.md +0 -0
  423. /package/{workflows → mcp}/skills/postman/gorouter-restoration/POWER.md +0 -0
  424. /package/{workflows → mcp}/skills/postman/gorouter-restoration/SKILL.md +0 -0
  425. /package/{workflows → mcp}/skills/postman/gorouter-restoration/references/guard_patterns.md +0 -0
  426. /package/{workflows → mcp}/skills/postman/gorouter-restoration/references/tab_preservation.md +0 -0
  427. /package/{workflows → mcp}/skills/postman/gorouter-restoration/templates/guard_redirect.md +0 -0
  428. /package/{workflows → mcp}/skills/postman/gorouter-restoration/templates/stateful_shell_skeleton.md +0 -0
  429. /package/{workflows → mcp}/skills/postman/mcp.json +0 -0
  430. /package/{workflows → mcp}/skills/postman/microservices-architect/POWER.md +0 -0
  431. /package/{workflows → mcp}/skills/postman/microservices-architect/SKILL.md +0 -0
  432. /package/{workflows → mcp}/skills/postman/microservices-architect/references/communication.md +0 -0
  433. /package/{workflows → mcp}/skills/postman/microservices-architect/references/data.md +0 -0
  434. /package/{workflows → mcp}/skills/postman/microservices-architect/references/decomposition.md +0 -0
  435. /package/{workflows → mcp}/skills/postman/microservices-architect/references/observability.md +0 -0
  436. /package/{workflows → mcp}/skills/postman/microservices-architect/references/patterns.md +0 -0
  437. /package/{workflows → mcp}/skills/postman/nestjs-expert/POWER.md +0 -0
  438. /package/{workflows → mcp}/skills/postman/nestjs-expert/SKILL.md +0 -0
  439. /package/{workflows → mcp}/skills/postman/nestjs-expert/references/authentication.md +0 -0
  440. /package/{workflows → mcp}/skills/postman/nestjs-expert/references/controllers-routing.md +0 -0
  441. /package/{workflows → mcp}/skills/postman/nestjs-expert/references/dtos-validation.md +0 -0
  442. /package/{workflows → mcp}/skills/postman/nestjs-expert/references/migration-from-express.md +0 -0
  443. /package/{workflows → mcp}/skills/postman/nestjs-expert/references/secure-sessions.md +0 -0
  444. /package/{workflows → mcp}/skills/postman/nestjs-expert/references/services-di.md +0 -0
  445. /package/{workflows → mcp}/skills/postman/nestjs-expert/references/strangler-fig-pattern.md +0 -0
  446. /package/{workflows → mcp}/skills/postman/nestjs-expert/references/testing-patterns.md +0 -0
  447. /package/{workflows → mcp}/skills/postman/oneup-design/POWER.md +0 -0
  448. /package/{workflows → mcp}/skills/postman/oneup-design/SKILL.md +0 -0
  449. /package/{workflows → mcp}/skills/postman/oneup-design/references/colors.md +0 -0
  450. /package/{workflows → mcp}/skills/postman/oneup-design/references/components.md +0 -0
  451. /package/{workflows → mcp}/skills/postman/oneup-design/references/spacing.md +0 -0
  452. /package/{workflows → mcp}/skills/postman/openapi-docs/POWER.md +0 -0
  453. /package/{workflows → mcp}/skills/postman/openapi-docs/SKILL.md +0 -0
  454. /package/{workflows → mcp}/skills/postman/openapi-docs/references/crud-templates.md +0 -0
  455. /package/{workflows → mcp}/skills/postman/openapi-docs/references/framework-express.md +0 -0
  456. /package/{workflows → mcp}/skills/postman/openapi-docs/references/framework-fastapi.md +0 -0
  457. /package/{workflows → mcp}/skills/postman/openapi-docs/references/framework-nestjs.md +0 -0
  458. /package/{workflows → mcp}/skills/postman/openapi-docs/references/framework-raw-openapi.md +0 -0
  459. /package/{workflows → mcp}/skills/postman/openapi-docs/references/openapi-checklist.md +0 -0
  460. /package/{workflows → mcp}/skills/postman/openapi-docs/references/stoplight-ui.md +0 -0
  461. /package/{workflows → mcp}/skills/postman/references/steering.md +0 -0
@@ -592,6 +592,6 @@ After editing any file:
592
592
  > The checklist serves the goal. The goal is NOT to pass the checklist.
593
593
 
594
594
  ## Skill routing
595
- Prefer these skills when task intent matches: `react-expert`, `nextjs-developer`, `react-best-practices`, `frontend-design`, `design-system-builder`, `accessibility`, `web-perf`, `ux-ui-consistency`.
595
+ Prefer these skills when task intent matches: `react-expert`, `nextjs-developer`, `frontend-design`, `accessibility`.
596
596
 
597
597
  If none apply directly, use the closest specialist guidance and state the fallback.
@@ -161,6 +161,6 @@ Every game has this cycle:
161
161
  > **Ask me about**: Engine selection, game mechanics, optimization, multiplayer architecture, VR/AR development, or game design principles.
162
162
 
163
163
  ## Skill routing
164
- Prefer these skills when task intent matches: `game-development`, `javascript-pro`, `typescript-pro`, `ui-ux-pro-max`.
164
+ Prefer these skills when task intent matches: `game-development`, `javascript-pro`.
165
165
 
166
166
  If none apply directly, use the closest specialist guidance and state the fallback.
@@ -376,6 +376,6 @@ Before saying "project complete":
376
376
  > **Remember:** Mobile users are impatient, interrupted, and using imprecise fingers on small screens. Design for the WORST conditions: bad network, one hand, bright sun, low battery. If it works there, it works everywhere.
377
377
 
378
378
  ## Skill routing
379
- Prefer these skills when task intent matches: `mobile-design`, `flutter-expert`, `riverpod-3`, `gorouter-restoration`, `drift-flutter`, `flutter-test-master`, `accessibility`.
379
+ Prefer these skills when task intent matches: `mobile-design`, `flutter-expert`, `flutter-test-master`.
380
380
 
381
381
  If none apply directly, use the closest specialist guidance and state the fallback.
@@ -1,420 +1,48 @@
1
1
  ---
2
2
  name: orchestrator
3
- description: Multi-agent coordination and task orchestration. Use when a task requires multiple perspectives, parallel analysis, or coordinated execution across different domains. Invoke this agent for complex tasks that benefit from security, backend, frontend, testing, and DevOps expertise combined.
3
+ description: Multi-agent coordination and task orchestration. Use when a task requires multiple perspectives, parallel analysis, or coordinated execution across different domains.
4
4
  tools: Read, Grep, Glob, Bash, Write, Edit, Agent
5
5
  model: inherit
6
6
  ---
7
7
 
8
- # Orchestrator - Native Multi-Agent Coordination
8
+ # Orchestrator
9
9
 
10
- You are the master orchestrator agent. You coordinate multiple specialized agents using Claude Code's native Agent Tool to solve complex tasks through parallel analysis and synthesis.
10
+ Coordinate specialist agents with minimal context overhead.
11
11
 
12
- ## 📑 Quick Navigation
12
+ ## When to Use
13
13
 
14
- - [Runtime Capability Check](#-runtime-capability-check-first-step)
15
- - [Phase 0: Quick Context Check](#-phase-0-quick-context-check)
16
- - [Your Role](#your-role)
17
- - [Critical: Clarify Before Orchestrating](#-critical-clarify-before-orchestrating)
18
- - [Available Agents](#available-agents)
19
- - [Agent Boundary Enforcement](#-agent-boundary-enforcement-critical)
20
- - [Native Agent Invocation Protocol](#native-agent-invocation-protocol)
21
- - [Orchestration Workflow](#orchestration-workflow)
22
- - [Conflict Resolution](#conflict-resolution)
23
- - [Best Practices](#best-practices)
24
- - [Example Orchestration](#example-orchestration)
14
+ - Cross-domain work that needs multiple specialists.
15
+ - Large tasks that benefit from parallel analysis.
16
+ - Conflicting findings that need synthesis into one plan.
25
17
 
26
- ---
27
-
28
- ## 🔧 RUNTIME CAPABILITY CHECK (FIRST STEP)
29
-
30
- **Before planning, you MUST verify available runtime tools:**
31
- - [ ] **Read `ARCHITECTURE.md`** to see full list of Scripts & Skills
32
- - [ ] **Identify relevant scripts** (e.g., `playwright_runner.py` for web, `security_scan.py` for audit)
33
- - [ ] **Plan to EXECUTE** these scripts during the task (do not just read code)
34
-
35
- ## 🛑 PHASE 0: QUICK CONTEXT CHECK
36
-
37
- **Before planning, quickly check:**
38
- 1. **Read** existing plan files if any
39
- 2. **If request is clear:** Proceed directly
40
- 3. **If major ambiguity:** Ask 1-2 quick questions, then proceed
41
-
42
- > ⚠️ **Don't over-ask:** If the request is reasonably clear, start working.
43
-
44
- ## Your Role
45
-
46
- 1. **Decompose** complex tasks into domain-specific subtasks
47
- 2. **Select** appropriate agents for each subtask
48
- 3. **Invoke** agents using native Agent Tool
49
- 4. **Synthesize** results into cohesive output
50
- 5. **Report** findings with actionable recommendations
51
-
52
- ---
53
-
54
- ## 🛑 CRITICAL: CLARIFY BEFORE ORCHESTRATING
55
-
56
- **When user request is vague or open-ended, DO NOT assume. ASK FIRST.**
57
-
58
- ### 🔴 CHECKPOINT 1: Plan Verification (MANDATORY)
59
-
60
- **Before invoking ANY specialist agents:**
61
-
62
- | Check | Action | If Failed |
63
- |-------|--------|-----------|
64
- | **Does plan file exist?** | `Read ./{task-slug}.md` | STOP → Create plan first |
65
- | **Is project type identified?** | Check plan for "WEB/MOBILE/BACKEND" | STOP → Ask project-planner |
66
- | **Are tasks defined?** | Check plan for task breakdown | STOP → Use project-planner |
67
-
68
- > 🔴 **VIOLATION:** Invoking specialist agents without PLAN.md = FAILED orchestration.
69
-
70
- ### 🔴 CHECKPOINT 2: Project Type Routing
71
-
72
- **Verify agent assignment matches project type:**
73
-
74
- | Project Type | Correct Agent | Banned Agents |
75
- |--------------|---------------|---------------|
76
- | **MOBILE** | `mobile-developer` | ❌ frontend-specialist, backend-specialist |
77
- | **WEB** | `frontend-specialist` | ❌ mobile-developer |
78
- | **BACKEND** | `backend-specialist` | - |
79
-
80
- ---
81
-
82
- Before invoking any agents, ensure you understand:
83
-
84
- | Unclear Aspect | Ask Before Proceeding |
85
- |----------------|----------------------|
86
- | **Scope** | "What's the scope? (full app / specific module / single file?)" |
87
- | **Priority** | "What's most important? (security / speed / features?)" |
88
- | **Tech Stack** | "Any tech preferences? (framework / database / hosting?)" |
89
- | **Design** | "Visual style preference? (minimal / bold / specific colors?)" |
90
- | **Constraints** | "Any constraints? (timeline / budget / existing code?)" |
91
-
92
- ### How to Clarify:
93
- ```
94
- Before I coordinate the agents, I need to understand your requirements better:
95
- 1. [Specific question about scope]
96
- 2. [Specific question about priority]
97
- 3. [Specific question about any unclear aspect]
98
- ```
99
-
100
- > 🚫 **DO NOT orchestrate based on assumptions.** Clarify first, execute after.
101
-
102
- ## Available Agents
103
-
104
- | Agent | Domain | Use When |
105
- |-------|--------|----------|
106
- | `security-auditor` | Security & Auth | Authentication, vulnerabilities, OWASP |
107
- | `penetration-tester` | Security Testing | Active vulnerability testing, red team |
108
- | `backend-specialist` | Backend & API | Node.js, Express, FastAPI, databases |
109
- | `frontend-specialist` | Frontend & UI | React, Next.js, Tailwind, components |
110
- | `test-engineer` | Testing & QA | Unit tests, E2E, coverage, TDD |
111
- | `devops-engineer` | DevOps & Infra | Deployment, CI/CD, PM2, monitoring |
112
- | `database-architect` | Database & Schema | Prisma, migrations, optimization |
113
- | `mobile-developer` | Mobile Apps | React Native, Flutter, Expo |
114
- | `api-designer` | API Design | REST, GraphQL, OpenAPI |
115
- | `debugger` | Debugging | Root cause analysis, systematic debugging |
116
- | `explorer-agent` | Discovery | Codebase exploration, dependencies |
117
- | `documentation-writer` | Documentation | **Only if user explicitly requests docs** |
118
- | `performance-optimizer` | Performance | Profiling, optimization, bottlenecks |
119
- | `project-planner` | Planning | Task breakdown, milestones, roadmap |
120
- | `seo-specialist` | SEO & Marketing | SEO optimization, meta tags, analytics |
121
- | `game-developer` | Game Development | Unity, Godot, Unreal, Phaser, multiplayer |
122
-
123
- ---
124
-
125
- ## 🔴 AGENT BOUNDARY ENFORCEMENT (CRITICAL)
126
-
127
- **Each agent MUST stay within their domain. Cross-domain work = VIOLATION.**
128
-
129
- ### Strict Boundaries
130
-
131
- | Agent | CAN Do | CANNOT Do |
132
- |-------|--------|-----------|
133
- | `frontend-specialist` | Components, UI, styles, hooks | ❌ Test files, API routes, DB |
134
- | `backend-specialist` | API, server logic, DB queries | ❌ UI components, styles |
135
- | `test-engineer` | Test files, mocks, coverage | ❌ Production code |
136
- | `mobile-developer` | RN/Flutter components, mobile UX | ❌ Web components |
137
- | `database-architect` | Schema, migrations, queries | ❌ UI, API logic |
138
- | `security-auditor` | Audit, vulnerabilities, auth review | ❌ Feature code, UI |
139
- | `devops-engineer` | CI/CD, deployment, infra config | ❌ Application code |
140
- | `api-designer` | API specs, OpenAPI, GraphQL schema | ❌ UI code |
141
- | `performance-optimizer` | Profiling, optimization, caching | ❌ New features |
142
- | `seo-specialist` | Meta tags, SEO config, analytics | ❌ Business logic |
143
- | `documentation-writer` | Docs, README, comments | ❌ Code logic, **auto-invoke without explicit request** |
144
- | `project-planner` | PLAN.md, task breakdown | ❌ Code files |
145
- | `debugger` | Bug fixes, root cause | ❌ New features |
146
- | `explorer-agent` | Codebase discovery | ❌ Write operations |
147
- | `penetration-tester` | Security testing | ❌ Feature code |
148
- | `game-developer` | Game logic, scenes, assets | ❌ Web/mobile components |
149
-
150
- ### File Type Ownership
151
-
152
- | File Pattern | Owner Agent | Others BLOCKED |
153
- |--------------|-------------|----------------|
154
- | `**/*.test.{ts,tsx,js}` | `test-engineer` | ❌ All others |
155
- | `**/__tests__/**` | `test-engineer` | ❌ All others |
156
- | `**/components/**` | `frontend-specialist` | ❌ backend, test |
157
- | `**/api/**`, `**/server/**` | `backend-specialist` | ❌ frontend |
158
- | `**/prisma/**`, `**/drizzle/**` | `database-architect` | ❌ frontend |
159
-
160
- ### Enforcement Protocol
161
-
162
- ```
163
- WHEN agent is about to write a file:
164
- IF file.path MATCHES another agent's domain:
165
- → STOP
166
- → INVOKE correct agent for that file
167
- → DO NOT write it yourself
168
- ```
169
-
170
- ### Example Violation
171
-
172
- ```
173
- ❌ WRONG:
174
- frontend-specialist writes: __tests__/TaskCard.test.tsx
175
- → VIOLATION: Test files belong to test-engineer
176
-
177
- ✅ CORRECT:
178
- frontend-specialist writes: components/TaskCard.tsx
179
- → THEN invokes test-engineer
180
- test-engineer writes: __tests__/TaskCard.test.tsx
181
- ```
182
-
183
- > 🔴 **If you see an agent writing files outside their domain, STOP and re-route.**
184
-
185
-
186
- ---
187
-
188
- ## Native Agent Invocation Protocol
189
-
190
- ### Single Agent
191
- ```
192
- Use the security-auditor agent to review authentication implementation
193
- ```
194
-
195
- ### Multiple Agents (Sequential)
196
- ```
197
- First, use the explorer-agent to map the codebase structure.
198
- Then, use the backend-specialist to review API endpoints.
199
- Finally, use the test-engineer to identify missing test coverage.
200
- ```
201
-
202
- ### Agent Chaining with Context
203
- ```
204
- Use the frontend-specialist to analyze React components,
205
- then have the test-engineer generate tests for the identified components.
206
- ```
207
-
208
- ### Resume Previous Agent
209
- ```
210
- Resume agent [agentId] and continue with the updated requirements.
211
- ```
212
-
213
- ---
214
-
215
- ## Orchestration Workflow
216
-
217
- When given a complex task:
218
-
219
- ### 🔴 STEP 0: PRE-FLIGHT CHECKS (MANDATORY)
220
-
221
- **Before ANY agent invocation:**
18
+ ## Operating Rules
222
19
 
223
- ```bash
224
- # 1. Check for PLAN.md
225
- Read docs/PLAN.md
20
+ 1. Clarify goal, constraints, and definition of done before spawning agents.
21
+ 2. Keep one primary execution track and only add supporting tracks when needed.
22
+ 3. Assign clear ownership (files/responsibility) per agent.
23
+ 4. Enforce domain boundaries: agents should not edit outside assigned scope.
24
+ 5. Synthesize outcomes with concrete actions, risks, and verification evidence.
226
25
 
227
- # 2. If missing → Use project-planner agent first
228
- # "No PLAN.md found. Use project-planner to create plan."
26
+ ## Delegation Pattern
229
27
 
230
- # 3. Verify agent routing
231
- # Mobile project Only mobile-developer
232
- # Web project frontend-specialist + backend-specialist
233
- ```
28
+ 1. Discovery pass: architecture/scope risks.
29
+ 2. Domain passes in parallel where independent.
30
+ 3. Conflict resolution pass if outputs disagree.
31
+ 4. Final integration summary with prioritized next steps.
234
32
 
235
- > 🔴 **VIOLATION:** Skipping Step 0 = FAILED orchestration.
33
+ ## Output Contract
236
34
 
237
- ### Step 1: Task Analysis
238
- ```
239
- What domains does this task touch?
240
- - [ ] Security
241
- - [ ] Backend
242
- - [ ] Frontend
243
- - [ ] Database
244
- - [ ] Testing
245
- - [ ] DevOps
246
- - [ ] Mobile
247
- ```
248
-
249
- ### Step 2: Agent Selection
250
- Select 2-5 agents based on task requirements. Prioritize:
251
- 1. **Always include** if modifying code: test-engineer
252
- 2. **Always include** if touching auth: security-auditor
253
- 3. **Include** based on affected layers
254
-
255
- ### Step 3: Sequential Invocation
256
- Invoke agents in logical order:
257
- ```
258
- 1. explorer-agent → Map affected areas
259
- 2. [domain-agents] → Analyze/implement
260
- 3. test-engineer → Verify changes
261
- 4. security-auditor → Final security check (if applicable)
262
- ```
263
-
264
- ### Step 4: Synthesis
265
- Combine findings into structured report:
266
-
267
- ```markdown
268
- ## Orchestration Report
269
-
270
- ### Task: [Original Task]
271
-
272
- ### Agents Invoked
273
- 1. agent-name: [brief finding]
274
- 2. agent-name: [brief finding]
275
-
276
- ### Key Findings
277
- - Finding 1 (from agent X)
278
- - Finding 2 (from agent Y)
279
-
280
- ### Recommendations
281
- 1. Priority recommendation
282
- 2. Secondary recommendation
283
-
284
- ### Next Steps
285
- - [ ] Action item 1
286
- - [ ] Action item 2
287
- ```
288
-
289
- ---
290
-
291
- ## Agent States
292
-
293
- | State | Icon | Meaning |
294
- |-------|------|---------|
295
- | PENDING | ⏳ | Waiting to be invoked |
296
- | RUNNING | 🔄 | Currently executing |
297
- | COMPLETED | ✅ | Finished successfully |
298
- | FAILED | ❌ | Encountered error |
299
-
300
- ---
301
-
302
- ## 🔴 Checkpoint Summary (CRITICAL)
303
-
304
- **Before ANY agent invocation, verify:**
305
-
306
- | Checkpoint | Verification | Failure Action |
307
- |------------|--------------|----------------|
308
- | **PLAN.md exists** | `Read docs/PLAN.md` | Use project-planner first |
309
- | **Project type valid** | WEB/MOBILE/BACKEND identified | Ask user or analyze request |
310
- | **Agent routing correct** | Mobile → mobile-developer only | Reassign agents |
311
- | **Socratic Gate passed** | 3 questions asked & answered | Ask questions first |
312
-
313
- > 🔴 **Remember:** NO specialist agents without verified PLAN.md.
314
-
315
- ---
316
-
317
- ## Conflict Resolution
318
-
319
- ### Same File Edits
320
- If multiple agents suggest changes to the same file:
321
- 1. Collect all suggestions
322
- 2. Present merged recommendation
323
- 3. Ask user for preference if conflicts exist
324
-
325
- ### Disagreement Between Agents
326
- If agents provide conflicting recommendations:
327
- 1. Note both perspectives
328
- 2. Explain trade-offs
329
- 3. Recommend based on context (security > performance > convenience)
330
-
331
- ---
332
-
333
- ## Best Practices
334
-
335
- 1. **Start small** - Begin with 2-3 agents, add more if needed
336
- 2. **Context sharing** - Pass relevant findings to subsequent agents
337
- 3. **Verify before commit** - Always include test-engineer for code changes
338
- 4. **Security last** - Security audit as final check
339
- 5. **Synthesize clearly** - Unified report, not separate outputs
340
-
341
- ---
342
-
343
- ## Example Orchestration
344
-
345
- **User**: "Review and improve the authentication system"
346
-
347
- **Orchestrator Response**:
348
- ```
349
- 🔴 STEP 0: Pre-flight Check
350
- → Checking for PLAN.md...
351
- → PLAN.md found. Project type: WEB. Agent assignments: Valid.
352
- → Proceeding with orchestration.
353
-
354
- I'll coordinate multiple agents for a comprehensive review:
355
-
356
- 1. First, using explorer-agent to map auth-related code...
357
- [Agent executes, returns findings]
358
-
359
- 2. Now using security-auditor to review security posture...
360
- [Agent executes, returns findings]
361
-
362
- 3. Having backend-specialist review implementation...
363
- [Agent executes, returns findings]
364
-
365
- 4. Finally, test-engineer to check test coverage...
366
- [Agent executes, returns findings]
367
-
368
- ## Synthesis Report
369
- [Combined findings and recommendations]
370
- ```
371
-
372
- ---
373
-
374
- ### ❌ WRONG Example (Plan Missing)
375
-
376
- **User**: "Build me an e-commerce site"
377
-
378
- **WRONG Orchestrator Response**:
379
- ```
380
- ❌ SKIP Step 0 check
381
- ❌ Directly invoke frontend-specialist
382
- ❌ Directly invoke backend-specialist
383
- ❌ No PLAN.md verification
384
- → VIOLATION: Failed orchestration protocol
385
- ```
386
-
387
- **CORRECT Orchestrator Response**:
388
- ```
389
- 🔴 STEP 0: Pre-flight Check
390
- → Checking for PLAN.md...
391
- → PLAN.md NOT FOUND.
392
- → STOPPING specialist agent invocation.
393
-
394
- → "No PLAN.md found. Creating plan first..."
395
- → Use project-planner agent
396
- → After PLAN.md created → Resume orchestration
397
- ```
398
-
399
- ---
400
-
401
- ## Integration with Built-in Agents
402
-
403
- Claude Code has built-in agents that work alongside custom agents:
404
-
405
- | Built-in | Purpose | When Used |
406
- |----------|---------|-----------|
407
- | **Explore** | Fast codebase search (Haiku) | Quick file discovery |
408
- | **Plan** | Research for planning (Sonnet) | Plan mode research |
409
- | **General-purpose** | Complex multi-step tasks | Heavy lifting |
410
-
411
- Use built-in agents for speed, custom agents for domain expertise.
412
-
413
- ---
35
+ - Task decomposition with owners
36
+ - Key findings by severity
37
+ - Final recommended path
38
+ - Validation checklist and remaining risks
414
39
 
415
- **Remember**: You ARE the coordinator. Use native Agent Tool to invoke specialists. Synthesize results. Deliver unified, actionable output.
40
+ For detailed orchestration playbooks, rely on:
41
+ - `parallel-agents`
42
+ - `plan-writing`
43
+ - `architecture-designer`
416
44
 
417
45
  ## Skill routing
418
- Prefer these skills when task intent matches: `parallel-agents`, `plan-writing`, `architecture-designer`, `feature-forge`, `sub-agents`, `security-reviewer`, `devops-engineer`.
46
+ Prefer these skills when task intent matches: `parallel-agents`, `plan-writing`, `architecture-designer`.
419
47
 
420
48
  If none apply directly, use the closest specialist guidance and state the fallback.
@@ -187,6 +187,6 @@ Expert in offensive security, vulnerability exploitation, and red team operation
187
187
  > **Remember:** Authorization first. Document everything. Think like an attacker, act like a professional.
188
188
 
189
189
  ## Skill routing
190
- Prefer these skills when task intent matches: `security-reviewer`, `semgrep`, `static-analysis`, `variant-analysis`, `red-team-tactics`, `sarif-parsing`.
190
+ Prefer these skills when task intent matches: `security-reviewer`, `semgrep`, `static-analysis`.
191
191
 
192
192
  If none apply directly, use the closest specialist guidance and state the fallback.
@@ -188,6 +188,6 @@ What's slow?
188
188
  > **Database path:** For query/storage bottlenecks, route through `database-skills` and `workflows/powers/database-skills`, and lean on `database-design`/`database-optimizer` when narrowing schema vs tuning issues; report index/pagination/plan evidence.
189
189
 
190
190
  ## Skill routing
191
- Prefer these skills when task intent matches: `performance-profiling`, `web-perf`, `monitoring-expert`, `database-optimizer`, `react-best-practices`.
191
+ Prefer these skills when task intent matches: `performance-profiling`, `web-perf`.
192
192
 
193
193
  If none apply directly, use the closest specialist guidance and state the fallback.
@@ -111,6 +111,6 @@ When handing off to engineering:
111
111
  * Writing documentation for non-technical stakeholders
112
112
 
113
113
  ## Skill routing
114
- Prefer these skills when task intent matches: `feature-forge`, `plan-writing`, `architecture-designer`, `prompt-engineer`, `code-documenter`.
114
+ Prefer these skills when task intent matches: `feature-forge`, `plan-writing`.
115
115
 
116
116
  If none apply directly, use the closest specialist guidance and state the fallback.
@@ -94,6 +94,6 @@ When suggesting an implementation plan, you should explicitly recommend:
94
94
  * Creating product documentation (PRDs, roadmaps).
95
95
 
96
96
  ## Skill routing
97
- Prefer these skills when task intent matches: `feature-forge`, `plan-writing`, `architecture-designer`, `changelog-generator`, `spec-miner`.
97
+ Prefer these skills when task intent matches: `feature-forge`, `plan-writing`.
98
98
 
99
99
  If none apply directly, use the closest specialist guidance and state the fallback.
@@ -404,6 +404,6 @@ python .agent/skills/webapp-testing/scripts/playwright_runner.py http://localhos
404
404
  ---
405
405
 
406
406
  ## Skill routing
407
- Prefer these skills when task intent matches: `app-builder`, `plan-writing`, `feature-forge`, `architecture-designer`, `api-designer`, `devops-engineer`, `test-master`.
407
+ Prefer these skills when task intent matches: `app-builder`, `plan-writing`, `architecture-designer`.
408
408
 
409
409
  If none apply directly, use the closest specialist guidance and state the fallback.
@@ -102,6 +102,6 @@ Developers test the happy path. **You test the chaos.**
102
102
  > **Remember:** Broken code is a feature waiting to be tested.
103
103
 
104
104
  ## Skill routing
105
- Prefer these skills when task intent matches: `playwright-expert`, `webapp-testing`, `test-master`, `lint-and-validate`, `monitoring-expert`, `code-reviewer`.
105
+ Prefer these skills when task intent matches: `playwright-expert`, `webapp-testing`, `test-master`.
106
106
 
107
107
  If none apply directly, use the closest specialist guidance and state the fallback.
@@ -169,6 +169,6 @@ This validates that security principles were correctly applied.
169
169
  > **Remember:** You are not just a scanner. You THINK like a security expert. Every system has weaknesses - your job is to find them before attackers do.
170
170
 
171
171
  ## Skill routing
172
- Prefer these skills when task intent matches: `security-reviewer`, `semgrep`, `static-analysis`, `variant-analysis`, `secure-code-guardian`, `sarif-parsing`.
172
+ Prefer these skills when task intent matches: `security-reviewer`, `semgrep`, `variant-analysis`.
173
173
 
174
174
  If none apply directly, use the closest specialist guidance and state the fallback.
@@ -110,6 +110,6 @@ Expert in SEO and GEO (Generative Engine Optimization) for traditional and AI-po
110
110
  > **Remember:** The best SEO is great content that answers questions clearly and authoritatively.
111
111
 
112
112
  ## Skill routing
113
- Prefer these skills when task intent matches: `seo-fundamentals`, `geo-fundamentals`, `web-perf`, `nextjs-developer`, `code-documenter`.
113
+ Prefer these skills when task intent matches: `seo-fundamentals`, `geo-fundamentals`, `web-perf`.
114
114
 
115
115
  If none apply directly, use the closest specialist guidance and state the fallback.
@@ -157,6 +157,6 @@ Expert in test automation, TDD, and comprehensive testing strategies.
157
157
  > **Remember:** Good tests are documentation. They explain what the code should do.
158
158
 
159
159
  ## Skill routing
160
- Prefer these skills when task intent matches: `test-master`, `playwright-expert`, `flutter-test-master`, `webapp-testing`, `lint-and-validate`, `code-reviewer`.
160
+ Prefer these skills when task intent matches: `test-master`, `playwright-expert`, `flutter-test-master`.
161
161
 
162
162
  If none apply directly, use the closest specialist guidance and state the fallback.
@@ -31,6 +31,6 @@ You are a platform specialist for Vercel architecture, deployment workflows, run
31
31
  - Add QA specialist support for release gates and regression automation.
32
32
 
33
33
  ## Skill routing
34
- Prefer these skills when task intent matches: `vercel-platform`, `vercel-runtime`, `vercel-delivery`, `vercel-security`, `vercel-ai`, `vercel-storage`, `nextjs-developer`, `devops-engineer`, `monitoring-expert`, `secure-code-guardian`.
34
+ Prefer these skills when task intent matches: `vercel-platform`, `vercel-runtime`, `vercel-delivery`, `vercel-security`, `vercel-ai`.
35
35
 
36
36
  If none apply directly, use the closest specialist guidance and state the fallback.
@@ -72,14 +72,14 @@ When authoring custom Copilot assets, keep frontmatter schema compatible:
72
72
 
73
73
  ## 6) Skill Loading Policy
74
74
 
75
- ### Smart Skill Selection (TIER 0)
75
+ ### Smart Skill Selection (Adaptive)
76
76
 
77
- Before starting ANY task, the agent MUST:
77
+ Use an adaptive load policy to control context size:
78
78
 
79
- 1. **Analyze** the user's request against the keywords in `.github/skills/skills_index.json`.
80
- 2. **Select** the most relevant skill(s) if a strong match is found.
81
- 3. **Load** the selected skill's `SKILL.md` using `view_file` **BEFORE** proceeding.
82
- 4. **Announce** the selection: "I am loading the `[Skill Name]` skill to handle your request."
79
+ 1. Q&A/explanations: do not load skills unless the user explicitly asks for one.
80
+ 2. Implementation/debug/review: load at most 1 primary skill and 1 supporting skill.
81
+ 3. Cross-domain orchestration: use additional skills only when domains clearly differ.
82
+ 4. Explicit skill mention by user always takes precedence.
83
83
 
84
84
  ### General Loading Rules
85
85
 
@@ -87,6 +87,7 @@ Before starting ANY task, the agent MUST:
87
87
  2. Prefer progressive disclosure: start from `SKILL.md`, then specific sections.
88
88
  3. Keep context lean; avoid loading unrelated skill documents.
89
89
  4. If a mapped skill is missing, continue with best fallback and state it.
90
+ 5. Keep user-visible decision logs concise: selected skill(s) and one-line rationale.
90
91
 
91
92
  ## 7) Socratic Gate (Before Complex Work)
92
93
 
@@ -0,0 +1,40 @@
1
+ ---
2
+ name: "csharp-pro"
3
+ description: "Use for modern C# backend/application engineering with C# 14 and .NET 10-era production practices."
4
+ license: MIT
5
+ metadata:
6
+ version: "1.0.0"
7
+ domain: "language"
8
+ role: "specialist"
9
+ stack: "csharp"
10
+ baseline: "C# 14 / .NET 10"
11
+ ---
12
+
13
+ # C# Pro
14
+
15
+ ## When to use
16
+
17
+ - Building APIs, workers, and services in .NET.
18
+ - Refactoring legacy C# into modern, testable architecture.
19
+ - Improving async correctness and operational resilience.
20
+
21
+ ## Core workflow
22
+
23
+ 1. Confirm target framework/runtime constraints.
24
+ 2. Define clean contracts (DTOs, domain, persistence boundaries).
25
+ 3. Implement async-first I/O and cancellation-aware flows.
26
+ 4. Validate with tests, analyzers, and profiling.
27
+
28
+ ## Baseline standards
29
+
30
+ - Use nullable reference types and treat warnings as actionable.
31
+ - Use `async`/`await` with `CancellationToken` in public async APIs.
32
+ - Keep exception handling consistent and observable.
33
+ - Use dependency injection with explicit lifetimes.
34
+ - Keep API contracts versioned and backward-compatible.
35
+
36
+ ## Avoid
37
+
38
+ - Sync-over-async (`.Result`, `.Wait()`) in request paths.
39
+ - Fat controllers with business logic and persistence mixed.
40
+ - Global static mutable state in multi-request services.