workspace-architect 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (354) hide show
  1. package/.env.example +1 -0
  2. package/.gitattributes +1 -0
  3. package/.github/workflows/manual-publish.yml +36 -0
  4. package/.github/workflows/sync-and-publish.yml +58 -0
  5. package/.release-it.json +20 -0
  6. package/CHANGELOG.md +43 -0
  7. package/README.md +62 -0
  8. package/assets/chatmodes/4.1-Beast.chatmode.md +152 -0
  9. package/assets/chatmodes/Thinking-Beast-Mode.chatmode.md +337 -0
  10. package/assets/chatmodes/Ultimate-Transparent-Thinking-Beast-Mode.chatmode.md +644 -0
  11. package/assets/chatmodes/accessibility.chatmode.md +298 -0
  12. package/assets/chatmodes/address-comments.chatmode.md +59 -0
  13. package/assets/chatmodes/aem-frontend-specialist.chatmode.md +385 -0
  14. package/assets/chatmodes/api-architect.chatmode.md +40 -0
  15. package/assets/chatmodes/atlassian-requirements-to-jira.chatmode.md +444 -0
  16. package/assets/chatmodes/azure-logic-apps-expert.chatmode.md +100 -0
  17. package/assets/chatmodes/azure-principal-architect.chatmode.md +58 -0
  18. package/assets/chatmodes/azure-saas-architect.chatmode.md +118 -0
  19. package/assets/chatmodes/azure-verified-modules-bicep.chatmode.md +44 -0
  20. package/assets/chatmodes/azure-verified-modules-terraform.chatmode.md +58 -0
  21. package/assets/chatmodes/bicep-implement.chatmode.md +40 -0
  22. package/assets/chatmodes/bicep-plan.chatmode.md +112 -0
  23. package/assets/chatmodes/blueprint-mode-codex.chatmode.md +110 -0
  24. package/assets/chatmodes/blueprint-mode.chatmode.md +171 -0
  25. package/assets/chatmodes/clojure-interactive-programming.chatmode.md +174 -0
  26. package/assets/chatmodes/code-tour.chatmode.md +205 -0
  27. package/assets/chatmodes/critical-thinking.chatmode.md +23 -0
  28. package/assets/chatmodes/csharp-dotnet-janitor.chatmode.md +83 -0
  29. package/assets/chatmodes/csharp-mcp-expert.chatmode.md +69 -0
  30. package/assets/chatmodes/debug.chatmode.md +79 -0
  31. package/assets/chatmodes/declarative-agents-architect.chatmode.md +76 -0
  32. package/assets/chatmodes/demonstrate-understanding.chatmode.md +60 -0
  33. package/assets/chatmodes/dotnet-upgrade.chatmode.md +222 -0
  34. package/assets/chatmodes/drupal-expert.chatmode.md +687 -0
  35. package/assets/chatmodes/electron-angular-native.chatmode.md +285 -0
  36. package/assets/chatmodes/expert-cpp-software-engineer.chatmode.md +27 -0
  37. package/assets/chatmodes/expert-dotnet-software-engineer.chatmode.md +22 -0
  38. package/assets/chatmodes/expert-nextjs-developer.chatmode.md +477 -0
  39. package/assets/chatmodes/expert-react-frontend-engineer.chatmode.md +738 -0
  40. package/assets/chatmodes/gilfoyle.chatmode.md +66 -0
  41. package/assets/chatmodes/go-mcp-expert.chatmode.md +122 -0
  42. package/assets/chatmodes/gpt-5-beast-mode.chatmode.md +109 -0
  43. package/assets/chatmodes/hlbpa.chatmode.md +232 -0
  44. package/assets/chatmodes/implementation-plan.chatmode.md +159 -0
  45. package/assets/chatmodes/janitor.chatmode.md +89 -0
  46. package/assets/chatmodes/java-mcp-expert.chatmode.md +325 -0
  47. package/assets/chatmodes/kotlin-mcp-expert.chatmode.md +181 -0
  48. package/assets/chatmodes/kusto-assistant.chatmode.md +143 -0
  49. package/assets/chatmodes/laravel-expert-agent.chatmode.md +628 -0
  50. package/assets/chatmodes/mentor.chatmode.md +32 -0
  51. package/assets/chatmodes/meta-agentic-project-scaffold.chatmode.md +15 -0
  52. package/assets/chatmodes/microsoft-agent-framework-dotnet.chatmode.md +62 -0
  53. package/assets/chatmodes/microsoft-agent-framework-python.chatmode.md +62 -0
  54. package/assets/chatmodes/microsoft-study-mode.chatmode.md +32 -0
  55. package/assets/chatmodes/microsoft_learn_contributor.chatmode.md +388 -0
  56. package/assets/chatmodes/ms-sql-dba.chatmode.md +25 -0
  57. package/assets/chatmodes/php-mcp-expert.chatmode.md +498 -0
  58. package/assets/chatmodes/pimcore-expert.chatmode.md +869 -0
  59. package/assets/chatmodes/plan.chatmode.md +114 -0
  60. package/assets/chatmodes/planner.chatmode.md +14 -0
  61. package/assets/chatmodes/playwright-tester.chatmode.md +13 -0
  62. package/assets/chatmodes/postgresql-dba.chatmode.md +17 -0
  63. package/assets/chatmodes/power-bi-data-modeling-expert.chatmode.md +319 -0
  64. package/assets/chatmodes/power-bi-dax-expert.chatmode.md +334 -0
  65. package/assets/chatmodes/power-bi-performance-expert.chatmode.md +533 -0
  66. package/assets/chatmodes/power-bi-visualization-expert.chatmode.md +549 -0
  67. package/assets/chatmodes/power-platform-expert.chatmode.md +116 -0
  68. package/assets/chatmodes/power-platform-mcp-integration-expert.chatmode.md +149 -0
  69. package/assets/chatmodes/prd.chatmode.md +201 -0
  70. package/assets/chatmodes/principal-software-engineer.chatmode.md +41 -0
  71. package/assets/chatmodes/prompt-builder.chatmode.md +352 -0
  72. package/assets/chatmodes/prompt-engineer.chatmode.md +72 -0
  73. package/assets/chatmodes/python-mcp-expert.chatmode.md +99 -0
  74. package/assets/chatmodes/refine-issue.chatmode.md +34 -0
  75. package/assets/chatmodes/research-technical-spike.chatmode.md +169 -0
  76. package/assets/chatmodes/ruby-mcp-expert.chatmode.md +346 -0
  77. package/assets/chatmodes/rust-gpt-4.1-beast-mode.chatmode.md +197 -0
  78. package/assets/chatmodes/rust-mcp-expert.chatmode.md +465 -0
  79. package/assets/chatmodes/search-ai-optimization-expert.chatmode.md +227 -0
  80. package/assets/chatmodes/semantic-kernel-dotnet.chatmode.md +31 -0
  81. package/assets/chatmodes/semantic-kernel-python.chatmode.md +28 -0
  82. package/assets/chatmodes/shopify-expert.chatmode.md +681 -0
  83. package/assets/chatmodes/simple-app-idea-generator.chatmode.md +134 -0
  84. package/assets/chatmodes/software-engineer-agent-v1.chatmode.md +164 -0
  85. package/assets/chatmodes/specification.chatmode.md +127 -0
  86. package/assets/chatmodes/swift-mcp-expert.chatmode.md +240 -0
  87. package/assets/chatmodes/task-planner.chatmode.md +374 -0
  88. package/assets/chatmodes/task-researcher.chatmode.md +254 -0
  89. package/assets/chatmodes/tdd-green.chatmode.md +59 -0
  90. package/assets/chatmodes/tdd-red.chatmode.md +59 -0
  91. package/assets/chatmodes/tdd-refactor.chatmode.md +84 -0
  92. package/assets/chatmodes/tech-debt-remediation-plan.chatmode.md +49 -0
  93. package/assets/chatmodes/terraform-azure-implement.chatmode.md +104 -0
  94. package/assets/chatmodes/terraform-azure-planning.chatmode.md +157 -0
  95. package/assets/chatmodes/typescript-mcp-expert.chatmode.md +91 -0
  96. package/assets/chatmodes/voidbeast-gpt41enhanced.chatmode.md +230 -0
  97. package/assets/chatmodes/wg-code-alchemist.chatmode.md +61 -0
  98. package/assets/chatmodes/wg-code-sentinel.chatmode.md +55 -0
  99. package/assets/collections/ai-prompt-engineering.json +18 -0
  100. package/assets/collections/angular-development.json +7 -0
  101. package/assets/collections/azure-cloud-architect.json +29 -0
  102. package/assets/collections/cpp-development.json +6 -0
  103. package/assets/collections/database-administration.json +8 -0
  104. package/assets/collections/devops-sre.json +11 -0
  105. package/assets/collections/dotnet-development.json +22 -0
  106. package/assets/collections/general-productivity.json +9 -0
  107. package/assets/collections/go-development.json +7 -0
  108. package/assets/collections/java-spring-developer.json +26 -0
  109. package/assets/collections/learning-mentoring.json +10 -0
  110. package/assets/collections/legacy-migration.json +4 -0
  111. package/assets/collections/mcp-specialist.json +41 -0
  112. package/assets/collections/mobile-development.json +4 -0
  113. package/assets/collections/php-cms-development.json +11 -0
  114. package/assets/collections/power-platform-specialist.json +31 -0
  115. package/assets/collections/project-management.json +12 -0
  116. package/assets/collections/python-development.json +13 -0
  117. package/assets/collections/quality-assurance.json +13 -0
  118. package/assets/collections/ruby-development.json +9 -0
  119. package/assets/collections/rust-development.json +10 -0
  120. package/assets/collections/security-specialist.json +8 -0
  121. package/assets/collections/software-architect.json +25 -0
  122. package/assets/collections/technical-writing.json +9 -0
  123. package/assets/collections/web-frontend-development.json +14 -0
  124. package/assets/instructions/a11y.instructions.md +369 -0
  125. package/assets/instructions/ai-prompt-engineering-safety-best-practices.instructions.md +867 -0
  126. package/assets/instructions/angular.instructions.md +104 -0
  127. package/assets/instructions/ansible.instructions.md +88 -0
  128. package/assets/instructions/aspnet-rest-apis.instructions.md +110 -0
  129. package/assets/instructions/astro.instructions.md +182 -0
  130. package/assets/instructions/azure-devops-pipelines.instructions.md +185 -0
  131. package/assets/instructions/azure-functions-typescript.instructions.md +14 -0
  132. package/assets/instructions/azure-logic-apps-power-automate.instructions.md +1943 -0
  133. package/assets/instructions/azure-verified-modules-terraform.instructions.md +229 -0
  134. package/assets/instructions/bicep-code-best-practices.instructions.md +54 -0
  135. package/assets/instructions/blazor.instructions.md +77 -0
  136. package/assets/instructions/clojure.instructions.md +349 -0
  137. package/assets/instructions/cmake-vcpkg.instructions.md +10 -0
  138. package/assets/instructions/codexer.instructions.md +428 -0
  139. package/assets/instructions/coldfusion-cfc.instructions.md +30 -0
  140. package/assets/instructions/coldfusion-cfm.instructions.md +28 -0
  141. package/assets/instructions/collections.instructions.md +54 -0
  142. package/assets/instructions/containerization-docker-best-practices.instructions.md +681 -0
  143. package/assets/instructions/convert-jpa-to-spring-data-cosmos.instructions.md +949 -0
  144. package/assets/instructions/copilot-thought-logging.instructions.md +62 -0
  145. package/assets/instructions/csharp-ja.instructions.md +114 -0
  146. package/assets/instructions/csharp-ko.instructions.md +77 -0
  147. package/assets/instructions/csharp-mcp-server.instructions.md +95 -0
  148. package/assets/instructions/csharp.instructions.md +114 -0
  149. package/assets/instructions/dart-n-flutter.instructions.md +447 -0
  150. package/assets/instructions/declarative-agents-microsoft365.instructions.md +316 -0
  151. package/assets/instructions/devbox-image-definition.instructions.md +302 -0
  152. package/assets/instructions/devops-core-principles.instructions.md +167 -0
  153. package/assets/instructions/dotnet-architecture-good-practices.instructions.md +279 -0
  154. package/assets/instructions/dotnet-framework.instructions.md +113 -0
  155. package/assets/instructions/dotnet-maui-9-to-dotnet-maui-10-upgrade.instructions.md +1922 -0
  156. package/assets/instructions/dotnet-maui.instructions.md +69 -0
  157. package/assets/instructions/dotnet-upgrade.instructions.md +287 -0
  158. package/assets/instructions/dotnet-wpf.instructions.md +79 -0
  159. package/assets/instructions/genaiscript.instructions.md +21 -0
  160. package/assets/instructions/generate-modern-terraform-code-for-azure.instructions.md +82 -0
  161. package/assets/instructions/gilfoyle-code-review.instructions.md +114 -0
  162. package/assets/instructions/github-actions-ci-cd-best-practices.instructions.md +607 -0
  163. package/assets/instructions/go-mcp-server.instructions.md +346 -0
  164. package/assets/instructions/go.instructions.md +373 -0
  165. package/assets/instructions/instructions.instructions.md +256 -0
  166. package/assets/instructions/java-11-to-java-17-upgrade.instructions.md +793 -0
  167. package/assets/instructions/java-17-to-java-21-upgrade.instructions.md +464 -0
  168. package/assets/instructions/java-21-to-java-25-upgrade.instructions.md +311 -0
  169. package/assets/instructions/java-mcp-server.instructions.md +553 -0
  170. package/assets/instructions/java.instructions.md +81 -0
  171. package/assets/instructions/joyride-user-project.instructions.md +206 -0
  172. package/assets/instructions/joyride-workspace-automation.instructions.md +46 -0
  173. package/assets/instructions/kotlin-mcp-server.instructions.md +481 -0
  174. package/assets/instructions/kubernetes-deployment-best-practices.instructions.md +307 -0
  175. package/assets/instructions/langchain-python.instructions.md +229 -0
  176. package/assets/instructions/localization.instructions.md +39 -0
  177. package/assets/instructions/makefile.instructions.md +410 -0
  178. package/assets/instructions/markdown.instructions.md +52 -0
  179. package/assets/instructions/memory-bank.instructions.md +299 -0
  180. package/assets/instructions/mongo-dba.instructions.md +25 -0
  181. package/assets/instructions/ms-sql-dba.instructions.md +25 -0
  182. package/assets/instructions/nestjs.instructions.md +406 -0
  183. package/assets/instructions/nextjs-tailwind.instructions.md +72 -0
  184. package/assets/instructions/nextjs.instructions.md +143 -0
  185. package/assets/instructions/nodejs-javascript-vitest.instructions.md +30 -0
  186. package/assets/instructions/object-calisthenics.instructions.md +302 -0
  187. package/assets/instructions/oqtane.instructions.md +86 -0
  188. package/assets/instructions/performance-optimization.instructions.md +420 -0
  189. package/assets/instructions/php-mcp-server.instructions.md +809 -0
  190. package/assets/instructions/playwright-dotnet.instructions.md +101 -0
  191. package/assets/instructions/playwright-python.instructions.md +62 -0
  192. package/assets/instructions/playwright-typescript.instructions.md +86 -0
  193. package/assets/instructions/power-apps-canvas-yaml.instructions.md +827 -0
  194. package/assets/instructions/power-apps-code-apps.instructions.md +601 -0
  195. package/assets/instructions/power-bi-custom-visuals-development.instructions.md +810 -0
  196. package/assets/instructions/power-bi-data-modeling-best-practices.instructions.md +639 -0
  197. package/assets/instructions/power-bi-dax-best-practices.instructions.md +795 -0
  198. package/assets/instructions/power-bi-devops-alm-best-practices.instructions.md +623 -0
  199. package/assets/instructions/power-bi-report-design-best-practices.instructions.md +752 -0
  200. package/assets/instructions/power-bi-security-rls-best-practices.instructions.md +504 -0
  201. package/assets/instructions/power-platform-connector.instructions.md +430 -0
  202. package/assets/instructions/power-platform-mcp-development.instructions.md +88 -0
  203. package/assets/instructions/powershell-pester-5.instructions.md +197 -0
  204. package/assets/instructions/powershell.instructions.md +356 -0
  205. package/assets/instructions/prompt.instructions.md +73 -0
  206. package/assets/instructions/python-mcp-server.instructions.md +204 -0
  207. package/assets/instructions/python.instructions.md +56 -0
  208. package/assets/instructions/quarkus-mcp-server-sse.instructions.md +49 -0
  209. package/assets/instructions/quarkus.instructions.md +98 -0
  210. package/assets/instructions/r.instructions.md +116 -0
  211. package/assets/instructions/reactjs.instructions.md +162 -0
  212. package/assets/instructions/ruby-mcp-server.instructions.md +629 -0
  213. package/assets/instructions/ruby-on-rails.instructions.md +124 -0
  214. package/assets/instructions/rust-mcp-server.instructions.md +715 -0
  215. package/assets/instructions/rust.instructions.md +135 -0
  216. package/assets/instructions/security-and-owasp.instructions.md +51 -0
  217. package/assets/instructions/self-explanatory-code-commenting.instructions.md +162 -0
  218. package/assets/instructions/shell.instructions.md +132 -0
  219. package/assets/instructions/spec-driven-workflow-v1.instructions.md +323 -0
  220. package/assets/instructions/springboot.instructions.md +68 -0
  221. package/assets/instructions/sql-sp-generation.instructions.md +74 -0
  222. package/assets/instructions/svelte.instructions.md +161 -0
  223. package/assets/instructions/swift-mcp-server.instructions.md +498 -0
  224. package/assets/instructions/taming-copilot.instructions.md +40 -0
  225. package/assets/instructions/tanstack-start-shadcn-tailwind.instructions.md +212 -0
  226. package/assets/instructions/task-implementation.instructions.md +190 -0
  227. package/assets/instructions/tasksync.instructions.md +352 -0
  228. package/assets/instructions/terraform-azure.instructions.md +254 -0
  229. package/assets/instructions/terraform-sap-btp.instructions.md +195 -0
  230. package/assets/instructions/terraform.instructions.md +113 -0
  231. package/assets/instructions/typescript-5-es2022.instructions.md +114 -0
  232. package/assets/instructions/typescript-mcp-server.instructions.md +228 -0
  233. package/assets/instructions/update-code-from-shorthand.instructions.md +130 -0
  234. package/assets/instructions/vuejs3.instructions.md +153 -0
  235. package/assets/instructions/wordpress.instructions.md +186 -0
  236. package/assets/prompts/add-educational-comments.prompt.md +129 -0
  237. package/assets/prompts/ai-prompt-engineering-safety-review.prompt.md +230 -0
  238. package/assets/prompts/architecture-blueprint-generator.prompt.md +322 -0
  239. package/assets/prompts/aspnet-minimal-api-openapi.prompt.md +42 -0
  240. package/assets/prompts/az-cost-optimize.prompt.md +305 -0
  241. package/assets/prompts/azure-resource-health-diagnose.prompt.md +290 -0
  242. package/assets/prompts/boost-prompt.prompt.md +25 -0
  243. package/assets/prompts/breakdown-epic-arch.prompt.md +66 -0
  244. package/assets/prompts/breakdown-epic-pm.prompt.md +58 -0
  245. package/assets/prompts/breakdown-feature-implementation.prompt.md +128 -0
  246. package/assets/prompts/breakdown-feature-prd.prompt.md +61 -0
  247. package/assets/prompts/breakdown-plan.prompt.md +509 -0
  248. package/assets/prompts/breakdown-test.prompt.md +365 -0
  249. package/assets/prompts/code-exemplars-blueprint-generator.prompt.md +126 -0
  250. package/assets/prompts/comment-code-generate-a-tutorial.prompt.md +26 -0
  251. package/assets/prompts/containerize-aspnet-framework.prompt.md +455 -0
  252. package/assets/prompts/containerize-aspnetcore.prompt.md +393 -0
  253. package/assets/prompts/conventional-commit.prompt.md +73 -0
  254. package/assets/prompts/copilot-instructions-blueprint-generator.prompt.md +294 -0
  255. package/assets/prompts/cosmosdb-datamodeling.prompt.md +1045 -0
  256. package/assets/prompts/create-agentsmd.prompt.md +249 -0
  257. package/assets/prompts/create-architectural-decision-record.prompt.md +97 -0
  258. package/assets/prompts/create-github-action-workflow-specification.prompt.md +276 -0
  259. package/assets/prompts/create-github-issue-feature-from-specification.prompt.md +28 -0
  260. package/assets/prompts/create-github-issues-feature-from-implementation-plan.prompt.md +28 -0
  261. package/assets/prompts/create-github-issues-for-unmet-specification-requirements.prompt.md +35 -0
  262. package/assets/prompts/create-github-pull-request-from-specification.prompt.md +24 -0
  263. package/assets/prompts/create-implementation-plan.prompt.md +157 -0
  264. package/assets/prompts/create-llms.prompt.md +210 -0
  265. package/assets/prompts/create-oo-component-documentation.prompt.md +193 -0
  266. package/assets/prompts/create-readme.prompt.md +21 -0
  267. package/assets/prompts/create-specification.prompt.md +127 -0
  268. package/assets/prompts/create-spring-boot-java-project.prompt.md +163 -0
  269. package/assets/prompts/create-spring-boot-kotlin-project.prompt.md +147 -0
  270. package/assets/prompts/create-technical-spike.prompt.md +231 -0
  271. package/assets/prompts/csharp-async.prompt.md +50 -0
  272. package/assets/prompts/csharp-docs.prompt.md +63 -0
  273. package/assets/prompts/csharp-mcp-server-generator.prompt.md +59 -0
  274. package/assets/prompts/csharp-mstest.prompt.md +67 -0
  275. package/assets/prompts/csharp-nunit.prompt.md +72 -0
  276. package/assets/prompts/csharp-tunit.prompt.md +101 -0
  277. package/assets/prompts/csharp-xunit.prompt.md +69 -0
  278. package/assets/prompts/declarative-agents.prompt.md +93 -0
  279. package/assets/prompts/documentation-writer.prompt.md +46 -0
  280. package/assets/prompts/dotnet-best-practices.prompt.md +84 -0
  281. package/assets/prompts/dotnet-design-pattern-review.prompt.md +41 -0
  282. package/assets/prompts/dotnet-upgrade.prompt.md +116 -0
  283. package/assets/prompts/editorconfig.prompt.md +64 -0
  284. package/assets/prompts/ef-core.prompt.md +76 -0
  285. package/assets/prompts/finalize-agent-prompt.prompt.md +27 -0
  286. package/assets/prompts/first-ask.prompt.md +29 -0
  287. package/assets/prompts/folder-structure-blueprint-generator.prompt.md +405 -0
  288. package/assets/prompts/gen-specs-as-issues.prompt.md +165 -0
  289. package/assets/prompts/generate-custom-instructions-from-codebase.prompt.md +240 -0
  290. package/assets/prompts/git-flow-branch-creator.prompt.md +293 -0
  291. package/assets/prompts/github-copilot-starter.prompt.md +372 -0
  292. package/assets/prompts/go-mcp-server-generator.prompt.md +334 -0
  293. package/assets/prompts/java-docs.prompt.md +24 -0
  294. package/assets/prompts/java-junit.prompt.md +64 -0
  295. package/assets/prompts/java-mcp-server-generator.prompt.md +756 -0
  296. package/assets/prompts/java-refactoring-extract-method.prompt.md +105 -0
  297. package/assets/prompts/java-refactoring-remove-parameter.prompt.md +85 -0
  298. package/assets/prompts/java-springboot.prompt.md +66 -0
  299. package/assets/prompts/javascript-typescript-jest.prompt.md +44 -0
  300. package/assets/prompts/kotlin-mcp-server-generator.prompt.md +449 -0
  301. package/assets/prompts/kotlin-springboot.prompt.md +71 -0
  302. package/assets/prompts/mcp-copilot-studio-server-generator.prompt.md +118 -0
  303. package/assets/prompts/memory-merger.prompt.md +107 -0
  304. package/assets/prompts/mkdocs-translations.prompt.md +110 -0
  305. package/assets/prompts/model-recommendation.prompt.md +677 -0
  306. package/assets/prompts/multi-stage-dockerfile.prompt.md +47 -0
  307. package/assets/prompts/my-issues.prompt.md +9 -0
  308. package/assets/prompts/my-pull-requests.prompt.md +15 -0
  309. package/assets/prompts/next-intl-add-language.prompt.md +20 -0
  310. package/assets/prompts/php-mcp-server-generator.prompt.md +522 -0
  311. package/assets/prompts/playwright-automation-fill-in-form.prompt.md +30 -0
  312. package/assets/prompts/playwright-explore-website.prompt.md +19 -0
  313. package/assets/prompts/playwright-generate-test.prompt.md +19 -0
  314. package/assets/prompts/postgresql-code-review.prompt.md +214 -0
  315. package/assets/prompts/postgresql-optimization.prompt.md +406 -0
  316. package/assets/prompts/power-apps-code-app-scaffold.prompt.md +150 -0
  317. package/assets/prompts/power-bi-dax-optimization.prompt.md +175 -0
  318. package/assets/prompts/power-bi-model-design-review.prompt.md +405 -0
  319. package/assets/prompts/power-bi-performance-troubleshooting.prompt.md +384 -0
  320. package/assets/prompts/power-bi-report-design-consultation.prompt.md +353 -0
  321. package/assets/prompts/power-platform-mcp-connector-suite.prompt.md +156 -0
  322. package/assets/prompts/project-workflow-analysis-blueprint-generator.prompt.md +294 -0
  323. package/assets/prompts/prompt-builder.prompt.md +142 -0
  324. package/assets/prompts/pytest-coverage.prompt.md +28 -0
  325. package/assets/prompts/python-mcp-server-generator.prompt.md +105 -0
  326. package/assets/prompts/readme-blueprint-generator.prompt.md +79 -0
  327. package/assets/prompts/remember-interactive-programming.prompt.md +13 -0
  328. package/assets/prompts/remember.prompt.md +125 -0
  329. package/assets/prompts/repo-story-time.prompt.md +156 -0
  330. package/assets/prompts/review-and-refactor.prompt.md +15 -0
  331. package/assets/prompts/ruby-mcp-server-generator.prompt.md +660 -0
  332. package/assets/prompts/rust-mcp-server-generator.prompt.md +578 -0
  333. package/assets/prompts/shuffle-json-data.prompt.md +151 -0
  334. package/assets/prompts/sql-code-review.prompt.md +303 -0
  335. package/assets/prompts/sql-optimization.prompt.md +298 -0
  336. package/assets/prompts/suggest-awesome-github-copilot-agents.prompt.md +72 -0
  337. package/assets/prompts/suggest-awesome-github-copilot-chatmodes.prompt.md +71 -0
  338. package/assets/prompts/suggest-awesome-github-copilot-collections.prompt.md +149 -0
  339. package/assets/prompts/suggest-awesome-github-copilot-instructions.prompt.md +88 -0
  340. package/assets/prompts/suggest-awesome-github-copilot-prompts.prompt.md +71 -0
  341. package/assets/prompts/swift-mcp-server-generator.prompt.md +669 -0
  342. package/assets/prompts/technology-stack-blueprint-generator.prompt.md +242 -0
  343. package/assets/prompts/typescript-mcp-server-generator.prompt.md +90 -0
  344. package/assets/prompts/update-avm-modules-in-bicep.prompt.md +60 -0
  345. package/assets/prompts/update-implementation-plan.prompt.md +157 -0
  346. package/assets/prompts/update-llms.prompt.md +216 -0
  347. package/assets/prompts/update-markdown-file-index.prompt.md +76 -0
  348. package/assets/prompts/update-oo-component-documentation.prompt.md +162 -0
  349. package/assets/prompts/update-specification.prompt.md +127 -0
  350. package/assets/prompts/write-coding-standards-from-file.prompt.md +316 -0
  351. package/bin/cli.js +200 -0
  352. package/package.json +53 -0
  353. package/scripts/sync.js +99 -0
  354. package/verdaccio/config.yaml +202 -0
@@ -0,0 +1,294 @@
1
+ ---
2
+
3
+ description: 'Comprehensive technology-agnostic prompt generator for documenting end-to-end application workflows. Automatically detects project architecture patterns, technology stacks, and data flow patterns to generate detailed implementation blueprints covering entry points, service layers, data access, error handling, and testing approaches across multiple technologies including .NET, Java/Spring, React, and microservices architectures.'
4
+
5
+ mode: 'agent'
6
+ ---
7
+ # Project Workflow Documentation Generator
8
+
9
+ ## Configuration Variables
10
+
11
+ ```
12
+ ${PROJECT_TYPE="Auto-detect|.NET|Java|Spring|Node.js|Python|React|Angular|Microservices|Other"}
13
+ <!-- Primary technology stack -->
14
+
15
+ ${ENTRY_POINT="API|GraphQL|Frontend|CLI|Message Consumer|Scheduled Job|Custom"}
16
+ <!-- Starting point for the flow -->
17
+
18
+ ${PERSISTENCE_TYPE="Auto-detect|SQL Database|NoSQL Database|File System|External API|Message Queue|Cache|None"}
19
+ <!-- Data storage type -->
20
+
21
+ ${ARCHITECTURE_PATTERN="Auto-detect|Layered|Clean|CQRS|Microservices|MVC|MVVM|Serverless|Event-Driven|Other"}
22
+ <!-- Primary architecture pattern -->
23
+
24
+ ${WORKFLOW_COUNT=1-5}
25
+ <!-- Number of workflows to document -->
26
+
27
+ ${DETAIL_LEVEL="Standard|Implementation-Ready"}
28
+ <!-- Level of implementation detail to include -->
29
+
30
+ ${INCLUDE_SEQUENCE_DIAGRAM=true|false}
31
+ <!-- Generate sequence diagram -->
32
+
33
+ ${INCLUDE_TEST_PATTERNS=true|false}
34
+ <!-- Include testing approach -->
35
+ ```
36
+
37
+ ## Generated Prompt
38
+
39
+ ```
40
+ "Analyze the codebase and document ${WORKFLOW_COUNT} representative end-to-end workflows
41
+ that can serve as implementation templates for similar features. Use the following approach:
42
+ ```
43
+
44
+ ### Initial Detection Phase
45
+
46
+ ```
47
+ ${PROJECT_TYPE == "Auto-detect" ?
48
+ "Begin by examining the codebase structure to identify technologies:
49
+ - Check for .NET solutions/projects, Spring configurations, Node.js/Express files, etc.
50
+ - Identify the primary programming language(s) and frameworks in use
51
+ - Determine the architectural patterns based on folder structure and key components"
52
+ : "Focus on ${PROJECT_TYPE} patterns and conventions"}
53
+ ```
54
+
55
+ ```
56
+ ${ENTRY_POINT == "Auto-detect" ?
57
+ "Identify typical entry points by looking for:
58
+ - API controllers or route definitions
59
+ - GraphQL resolvers
60
+ - UI components that initiate network requests
61
+ - Message handlers or event subscribers
62
+ - Scheduled job definitions"
63
+ : "Focus on ${ENTRY_POINT} entry points"}
64
+ ```
65
+
66
+ ```
67
+ ${PERSISTENCE_TYPE == "Auto-detect" ?
68
+ "Determine persistence mechanisms by examining:
69
+ - Database context/connection configurations
70
+ - Repository implementations
71
+ - ORM mappings
72
+ - External API clients
73
+ - File system interactions"
74
+ : "Focus on ${PERSISTENCE_TYPE} interactions"}
75
+ ```
76
+
77
+ ### Workflow Documentation Instructions
78
+
79
+ For each of the `${WORKFLOW_COUNT}` most representative workflow(s) in the system:
80
+
81
+ #### 1. Workflow Overview
82
+ - Provide a name and brief description of the workflow
83
+ - Explain the business purpose it serves
84
+ - Identify the triggering action or event
85
+ - List all files/classes involved in the complete workflow
86
+
87
+ #### 2. Entry Point Implementation
88
+
89
+ **API Entry Points:**
90
+ ```
91
+ ${ENTRY_POINT == "API" || ENTRY_POINT == "Auto-detect" ?
92
+ "- Document the API controller class and method that receives the request
93
+ - Show the complete method signature including attributes/annotations
94
+ - Include the full request DTO/model class definition
95
+ - Document validation attributes and custom validators
96
+ - Show authentication/authorization attributes and checks" : ""}
97
+ ```
98
+
99
+ **GraphQL Entry Points:**
100
+ ```
101
+ ${ENTRY_POINT == "GraphQL" || ENTRY_POINT == "Auto-detect" ?
102
+ "- Document the GraphQL resolver class and method
103
+ - Show the complete schema definition for the query/mutation
104
+ - Include input type definitions
105
+ - Show resolver method implementation with parameter handling" : ""}
106
+ ```
107
+
108
+ **Frontend Entry Points:**
109
+ ```
110
+ ${ENTRY_POINT == "Frontend" || ENTRY_POINT == "Auto-detect" ?
111
+ "- Document the component that initiates the API call
112
+ - Show the event handler that triggers the request
113
+ - Include the API client service method
114
+ - Show state management code related to the request" : ""}
115
+ ```
116
+
117
+ **Message Consumer Entry Points:**
118
+ ```
119
+ ${ENTRY_POINT == "Message Consumer" || ENTRY_POINT == "Auto-detect" ?
120
+ "- Document the message handler class and method
121
+ - Show message subscription configuration
122
+ - Include the complete message model definition
123
+ - Show deserialization and validation logic" : ""}
124
+ ```
125
+
126
+ #### 3. Service Layer Implementation
127
+ - Document each service class involved with their dependencies
128
+ - Show the complete method signatures with parameters and return types
129
+ - Include actual method implementations with key business logic
130
+ - Document interface definitions where applicable
131
+ - Show dependency injection registration patterns
132
+
133
+ **CQRS Patterns:**
134
+ ```
135
+ ${ARCHITECTURE_PATTERN == "CQRS" || ARCHITECTURE_PATTERN == "Auto-detect" ?
136
+ "- Include complete command/query handler implementations" : ""}
137
+ ```
138
+
139
+ **Clean Architecture Patterns:**
140
+ ```
141
+ ${ARCHITECTURE_PATTERN == "Clean" || ARCHITECTURE_PATTERN == "Auto-detect" ?
142
+ "- Show use case/interactor implementations" : ""}
143
+ ```
144
+
145
+ #### 4. Data Mapping Patterns
146
+ - Document DTO to domain model mapping code
147
+ - Show object mapper configurations or manual mapping methods
148
+ - Include validation logic during mapping
149
+ - Document any domain events created during mapping
150
+
151
+ #### 5. Data Access Implementation
152
+ - Document repository interfaces and their implementations
153
+ - Show complete method signatures with parameters and return types
154
+ - Include actual query implementations
155
+ - Document entity/model class definitions with all properties
156
+ - Show transaction handling patterns
157
+
158
+ **SQL Database Patterns:**
159
+ ```
160
+ ${PERSISTENCE_TYPE == "SQL Database" || PERSISTENCE_TYPE == "Auto-detect" ?
161
+ "- Include ORM configurations, annotations, or Fluent API usage
162
+ - Show actual SQL queries or ORM statements" : ""}
163
+ ```
164
+
165
+ **NoSQL Database Patterns:**
166
+ ```
167
+ ${PERSISTENCE_TYPE == "NoSQL Database" || PERSISTENCE_TYPE == "Auto-detect" ?
168
+ "- Show document structure definitions
169
+ - Include document query/update operations" : ""}
170
+ ```
171
+
172
+ #### 6. Response Construction
173
+ - Document response DTO/model class definitions
174
+ - Show mapping from domain/entity models to response models
175
+ - Include status code selection logic
176
+ - Document error response structure and generation
177
+
178
+ #### 7. Error Handling Patterns
179
+ - Document exception types used in the workflow
180
+ - Show try/catch patterns at each layer
181
+ - Include global exception handler configurations
182
+ - Document error logging implementations
183
+ - Show retry policies or circuit breaker patterns
184
+ - Include compensating actions for failure scenarios
185
+
186
+ #### 8. Asynchronous Processing Patterns
187
+ - Document background job scheduling code
188
+ - Show event publication implementations
189
+ - Include message queue sending patterns
190
+ - Document callback or webhook implementations
191
+ - Show how async operations are tracked and monitored
192
+
193
+ **Testing Approach (Optional):**
194
+ ```
195
+ ${INCLUDE_TEST_PATTERNS ?
196
+ "9. **Testing Approach**
197
+ - Document unit test implementations for each layer
198
+ - Show mocking patterns and test fixture setup
199
+ - Include integration test implementations
200
+ - Document test data generation approaches
201
+ - Show API/controller test implementations" : ""}
202
+ ```
203
+
204
+ **Sequence Diagram (Optional):**
205
+ ```
206
+ ${INCLUDE_SEQUENCE_DIAGRAM ?
207
+ "10. **Sequence Diagram**
208
+ - Generate a detailed sequence diagram showing all components
209
+ - Include method calls with parameter types
210
+ - Show return values between components
211
+ - Document conditional flows and error paths" : ""}
212
+ ```
213
+
214
+ #### 11. Naming Conventions
215
+ Document consistent patterns for:
216
+ - Controller naming (e.g., `EntityNameController`)
217
+ - Service naming (e.g., `EntityNameService`)
218
+ - Repository naming (e.g., `IEntityNameRepository`)
219
+ - DTO naming (e.g., `EntityNameRequest`, `EntityNameResponse`)
220
+ - Method naming patterns for CRUD operations
221
+ - Variable naming conventions
222
+ - File organization patterns
223
+
224
+ #### 12. Implementation Templates
225
+ Provide reusable code templates for:
226
+ - Creating a new API endpoint following the pattern
227
+ - Implementing a new service method
228
+ - Adding a new repository method
229
+ - Creating new domain model classes
230
+ - Implementing proper error handling
231
+
232
+ ### Technology-Specific Implementation Patterns
233
+
234
+ **.NET Implementation Patterns (if detected):**
235
+ ```
236
+ ${PROJECT_TYPE == ".NET" || PROJECT_TYPE == "Auto-detect" ?
237
+ "- Complete controller class with attributes, filters, and dependency injection
238
+ - Service registration in Startup.cs or Program.cs
239
+ - Entity Framework DbContext configuration
240
+ - Repository implementation with EF Core or Dapper
241
+ - AutoMapper profile configurations
242
+ - Middleware implementations for cross-cutting concerns
243
+ - Extension method patterns
244
+ - Options pattern implementation for configuration
245
+ - Logging implementation with ILogger
246
+ - Authentication/authorization filter or policy implementations" : ""}
247
+ ```
248
+
249
+ **Spring Implementation Patterns (if detected):**
250
+ ```
251
+ ${PROJECT_TYPE == "Java" || PROJECT_TYPE == "Spring" || PROJECT_TYPE == "Auto-detect" ?
252
+ "- Complete controller class with annotations and dependency injection
253
+ - Service implementation with transaction boundaries
254
+ - Repository interface and implementation
255
+ - JPA entity definitions with relationships
256
+ - DTO class implementations
257
+ - Bean configuration and component scanning
258
+ - Exception handler implementations
259
+ - Custom validator implementations" : ""}
260
+ ```
261
+
262
+ **React Implementation Patterns (if detected):**
263
+ ```
264
+ ${PROJECT_TYPE == "React" || PROJECT_TYPE == "Auto-detect" ?
265
+ "- Component structure with props and state
266
+ - Hook implementation patterns (useState, useEffect, custom hooks)
267
+ - API service implementation
268
+ - State management patterns (Context, Redux)
269
+ - Form handling implementations
270
+ - Route configuration" : ""}
271
+ ```
272
+
273
+ ### Implementation Guidelines
274
+
275
+ Based on the documented workflows, provide specific guidance for implementing new features:
276
+
277
+ #### 1. Step-by-Step Implementation Process
278
+ - Where to start when adding a similar feature
279
+ - Order of implementation (e.g., model → repository → service → controller)
280
+ - How to integrate with existing cross-cutting concerns
281
+
282
+ #### 2. Common Pitfalls to Avoid
283
+ - Identify error-prone areas in the current implementation
284
+ - Note performance considerations
285
+ - List common bugs or issues encountered
286
+
287
+ #### 3. Extension Mechanisms
288
+ - Document how to plug into existing extension points
289
+ - Show how to add new behavior without modifying existing code
290
+ - Explain configuration-driven feature patterns
291
+
292
+ **Conclusion:**
293
+ Conclude with a summary of the most important patterns that should be followed when
294
+ implementing new features to maintain consistency with the codebase."
@@ -0,0 +1,142 @@
1
+ ---
2
+ mode: 'agent'
3
+ tools: ['search/codebase', 'edit/editFiles', 'search']
4
+ description: 'Guide users through creating high-quality GitHub Copilot prompts with proper structure, tools, and best practices.'
5
+ ---
6
+
7
+ # Professional Prompt Builder
8
+
9
+ You are an expert prompt engineer specializing in GitHub Copilot prompt development with deep knowledge of:
10
+ - Prompt engineering best practices and patterns
11
+ - VS Code Copilot customization capabilities
12
+ - Effective persona design and task specification
13
+ - Tool integration and front matter configuration
14
+ - Output format optimization for AI consumption
15
+
16
+ Your task is to guide me through creating a new `.prompt.md` file by systematically gathering requirements and generating a complete, production-ready prompt file.
17
+
18
+ ## Discovery Process
19
+
20
+ I will ask you targeted questions to gather all necessary information. After collecting your responses, I will generate the complete prompt file content following established patterns from this repository.
21
+
22
+ ### 1. **Prompt Identity & Purpose**
23
+ - What is the intended filename for your prompt (e.g., `generate-react-component.prompt.md`)?
24
+ - Provide a clear, one-sentence description of what this prompt accomplishes
25
+ - What category does this prompt fall into? (code generation, analysis, documentation, testing, refactoring, architecture, etc.)
26
+
27
+ ### 2. **Persona Definition**
28
+ - What role/expertise should Copilot embody? Be specific about:
29
+ - Technical expertise level (junior, senior, expert, specialist)
30
+ - Domain knowledge (languages, frameworks, tools)
31
+ - Years of experience or specific qualifications
32
+ - Example: "You are a senior .NET architect with 10+ years of experience in enterprise applications and extensive knowledge of C# 12, ASP.NET Core, and clean architecture patterns"
33
+
34
+ ### 3. **Task Specification**
35
+ - What is the primary task this prompt performs? Be explicit and measurable
36
+ - Are there secondary or optional tasks?
37
+ - What should the user provide as input? (selection, file, parameters, etc.)
38
+ - What constraints or requirements must be followed?
39
+
40
+ ### 4. **Context & Variable Requirements**
41
+ - Will it use `${selection}` (user's selected code)?
42
+ - Will it use `${file}` (current file) or other file references?
43
+ - Does it need input variables like `${input:variableName}` or `${input:variableName:placeholder}`?
44
+ - Will it reference workspace variables (`${workspaceFolder}`, etc.)?
45
+ - Does it need to access other files or prompt files as dependencies?
46
+
47
+ ### 5. **Detailed Instructions & Standards**
48
+ - What step-by-step process should Copilot follow?
49
+ - Are there specific coding standards, frameworks, or libraries to use?
50
+ - What patterns or best practices should be enforced?
51
+ - Are there things to avoid or constraints to respect?
52
+ - Should it follow any existing instruction files (`.instructions.md`)?
53
+
54
+ ### 6. **Output Requirements**
55
+ - What format should the output be? (code, markdown, JSON, structured data, etc.)
56
+ - Should it create new files? If so, where and with what naming convention?
57
+ - Should it modify existing files?
58
+ - Do you have examples of ideal output that can be used for few-shot learning?
59
+ - Are there specific formatting or structure requirements?
60
+
61
+ ### 7. **Tool & Capability Requirements**
62
+ Which tools does this prompt need? Common options include:
63
+ - **File Operations**: `codebase`, `editFiles`, `search`, `problems`
64
+ - **Execution**: `runCommands`, `runTasks`, `runTests`, `terminalLastCommand`
65
+ - **External**: `fetch`, `githubRepo`, `openSimpleBrowser`
66
+ - **Specialized**: `playwright`, `usages`, `vscodeAPI`, `extensions`
67
+ - **Analysis**: `changes`, `findTestFiles`, `testFailure`, `searchResults`
68
+
69
+ ### 8. **Technical Configuration**
70
+ - Should this run in a specific mode? (`agent`, `ask`, `edit`)
71
+ - Does it require a specific model? (usually auto-detected)
72
+ - Are there any special requirements or constraints?
73
+
74
+ ### 9. **Quality & Validation Criteria**
75
+ - How should success be measured?
76
+ - What validation steps should be included?
77
+ - Are there common failure modes to address?
78
+ - Should it include error handling or recovery steps?
79
+
80
+ ## Best Practices Integration
81
+
82
+ Based on analysis of existing prompts, I will ensure your prompt includes:
83
+
84
+ ✅ **Clear Structure**: Well-organized sections with logical flow
85
+ ✅ **Specific Instructions**: Actionable, unambiguous directions
86
+ ✅ **Proper Context**: All necessary information for task completion
87
+ ✅ **Tool Integration**: Appropriate tool selection for the task
88
+ ✅ **Error Handling**: Guidance for edge cases and failures
89
+ ✅ **Output Standards**: Clear formatting and structure requirements
90
+ ✅ **Validation**: Criteria for measuring success
91
+ ✅ **Maintainability**: Easy to update and extend
92
+
93
+ ## Next Steps
94
+
95
+ Please start by answering the questions in section 1 (Prompt Identity & Purpose). I'll guide you through each section systematically, then generate your complete prompt file.
96
+
97
+ ## Template Generation
98
+
99
+ After gathering all requirements, I will generate a complete `.prompt.md` file following this structure:
100
+
101
+ ```markdown
102
+ ---
103
+ description: "[Clear, concise description from requirements]"
104
+ mode: "[agent|ask|edit based on task type]"
105
+ tools: ["[appropriate tools based on functionality]"]
106
+ model: "[only if specific model required]"
107
+ ---
108
+
109
+ # [Prompt Title]
110
+
111
+ [Persona definition - specific role and expertise]
112
+
113
+ ## [Task Section]
114
+ [Clear task description with specific requirements]
115
+
116
+ ## [Instructions Section]
117
+ [Step-by-step instructions following established patterns]
118
+
119
+ ## [Context/Input Section]
120
+ [Variable usage and context requirements]
121
+
122
+ ## [Output Section]
123
+ [Expected output format and structure]
124
+
125
+ ## [Quality/Validation Section]
126
+ [Success criteria and validation steps]
127
+ ```
128
+
129
+ The generated prompt will follow patterns observed in high-quality prompts like:
130
+ - **Comprehensive blueprints** (architecture-blueprint-generator)
131
+ - **Structured specifications** (create-github-action-workflow-specification)
132
+ - **Best practice guides** (dotnet-best-practices, csharp-xunit)
133
+ - **Implementation plans** (create-implementation-plan)
134
+ - **Code generation** (playwright-generate-test)
135
+
136
+ Each prompt will be optimized for:
137
+ - **AI Consumption**: Token-efficient, structured content
138
+ - **Maintainability**: Clear sections, consistent formatting
139
+ - **Extensibility**: Easy to modify and enhance
140
+ - **Reliability**: Comprehensive instructions and error handling
141
+
142
+ Please start by telling me the name and description for the new prompt you want to build.
@@ -0,0 +1,28 @@
1
+ ---
2
+ agent: agent
3
+ description: 'Run pytest tests with coverage, discover lines missing coverage, and increase coverage to 100%.'
4
+ ---
5
+
6
+ The goal is for the tests to cover all lines of code.
7
+
8
+ Generate a coverage report with:
9
+
10
+ pytest --cov --cov-report=annotate:cov_annotate
11
+
12
+ If you are checking for coverage of a specific module, you can specify it like this:
13
+
14
+ pytest --cov=your_module_name --cov-report=annotate:cov_annotate
15
+
16
+ You can also specify specific tests to run, for example:
17
+
18
+ pytest tests/test_your_module.py --cov=your_module_name --cov-report=annotate:cov_annotate
19
+
20
+ Open the cov_annotate directory to view the annotated source code.
21
+ There will be one file per source file. If a file has 100% source coverage, it means all lines are covered by tests, so you do not need to open the file.
22
+
23
+ For each file that has less than 100% test coverage, find the matching file in cov_annotate and review the file.
24
+
25
+ If a line starts with a ! (exclamation mark), it means that the line is not covered by tests.
26
+ Add tests to cover the missing lines.
27
+
28
+ Keep running the tests and improving coverage until all lines are covered.
@@ -0,0 +1,105 @@
1
+ ---
2
+ mode: 'agent'
3
+ description: 'Generate a complete MCP server project in Python with tools, resources, and proper configuration'
4
+ ---
5
+
6
+ # Generate Python MCP Server
7
+
8
+ Create a complete Model Context Protocol (MCP) server in Python with the following specifications:
9
+
10
+ ## Requirements
11
+
12
+ 1. **Project Structure**: Create a new Python project with proper structure using uv
13
+ 2. **Dependencies**: Include mcp[cli] package with uv
14
+ 3. **Transport Type**: Choose between stdio (for local) or streamable-http (for remote)
15
+ 4. **Tools**: Create at least one useful tool with proper type hints
16
+ 5. **Error Handling**: Include comprehensive error handling and validation
17
+
18
+ ## Implementation Details
19
+
20
+ ### Project Setup
21
+ - Initialize with `uv init project-name`
22
+ - Add MCP SDK: `uv add "mcp[cli]"`
23
+ - Create main server file (e.g., `server.py`)
24
+ - Add `.gitignore` for Python projects
25
+ - Configure for direct execution with `if __name__ == "__main__"`
26
+
27
+ ### Server Configuration
28
+ - Use `FastMCP` class from `mcp.server.fastmcp`
29
+ - Set server name and optional instructions
30
+ - Choose transport: stdio (default) or streamable-http
31
+ - For HTTP: optionally configure host, port, and stateless mode
32
+
33
+ ### Tool Implementation
34
+ - Use `@mcp.tool()` decorator on functions
35
+ - Always include type hints - they generate schemas automatically
36
+ - Write clear docstrings - they become tool descriptions
37
+ - Use Pydantic models or TypedDicts for structured outputs
38
+ - Support async operations for I/O-bound tasks
39
+ - Include proper error handling
40
+
41
+ ### Resource/Prompt Setup (Optional)
42
+ - Add resources with `@mcp.resource()` decorator
43
+ - Use URI templates for dynamic resources: `"resource://{param}"`
44
+ - Add prompts with `@mcp.prompt()` decorator
45
+ - Return strings or Message lists from prompts
46
+
47
+ ### Code Quality
48
+ - Use type hints for all function parameters and returns
49
+ - Write docstrings for tools, resources, and prompts
50
+ - Follow PEP 8 style guidelines
51
+ - Use async/await for asynchronous operations
52
+ - Implement context managers for resource cleanup
53
+ - Add inline comments for complex logic
54
+
55
+ ## Example Tool Types to Consider
56
+ - Data processing and transformation
57
+ - File system operations (read, analyze, search)
58
+ - External API integrations
59
+ - Database queries
60
+ - Text analysis or generation (with sampling)
61
+ - System information retrieval
62
+ - Math or scientific calculations
63
+
64
+ ## Configuration Options
65
+ - **For stdio Servers**:
66
+ - Simple direct execution
67
+ - Test with `uv run mcp dev server.py`
68
+ - Install to Claude: `uv run mcp install server.py`
69
+
70
+ - **For HTTP Servers**:
71
+ - Port configuration via environment variables
72
+ - Stateless mode for scalability: `stateless_http=True`
73
+ - JSON response mode: `json_response=True`
74
+ - CORS configuration for browser clients
75
+ - Mounting to existing ASGI servers (Starlette/FastAPI)
76
+
77
+ ## Testing Guidance
78
+ - Explain how to run the server:
79
+ - stdio: `python server.py` or `uv run server.py`
80
+ - HTTP: `python server.py` then connect to `http://localhost:PORT/mcp`
81
+ - Test with MCP Inspector: `uv run mcp dev server.py`
82
+ - Install to Claude Desktop: `uv run mcp install server.py`
83
+ - Include example tool invocations
84
+ - Add troubleshooting tips
85
+
86
+ ## Additional Features to Consider
87
+ - Context usage for logging, progress, and notifications
88
+ - LLM sampling for AI-powered tools
89
+ - User input elicitation for interactive workflows
90
+ - Lifespan management for shared resources (databases, connections)
91
+ - Structured output with Pydantic models
92
+ - Icons for UI display
93
+ - Image handling with Image class
94
+ - Completion support for better UX
95
+
96
+ ## Best Practices
97
+ - Use type hints everywhere - they're not optional
98
+ - Return structured data when possible
99
+ - Log to stderr (or use Context logging) to avoid stdout pollution
100
+ - Clean up resources properly
101
+ - Validate inputs early
102
+ - Provide clear error messages
103
+ - Test tools independently before LLM integration
104
+
105
+ Generate a complete, production-ready MCP server with type safety, proper error handling, and comprehensive documentation.
@@ -0,0 +1,79 @@
1
+ ---
2
+ description: 'Intelligent README.md generation prompt that analyzes project documentation structure and creates comprehensive repository documentation. Scans .github/copilot directory files and copilot-instructions.md to extract project information, technology stack, architecture, development workflow, coding standards, and testing approaches while generating well-structured markdown documentation with proper formatting, cross-references, and developer-focused content.'
3
+
4
+ mode: 'agent'
5
+ ---
6
+
7
+ # README Generator Prompt
8
+
9
+ Generate a comprehensive README.md for this repository by analyzing the documentation files in the .github/copilot directory and the copilot-instructions.md file. Follow these steps:
10
+
11
+ 1. Scan all the files in the .github/copilot folder, like:
12
+ - Architecture
13
+ - Code_Exemplars
14
+ - Coding_Standards
15
+ - Project_Folder_Structure
16
+ - Technology_Stack
17
+ - Unit_Tests
18
+ - Workflow_Analysis
19
+
20
+ 2. Also review the copilot-instructions.md file in the .github folder
21
+
22
+ 3. Create a README.md with the following sections:
23
+
24
+ ## Project Name and Description
25
+ - Extract the project name and primary purpose from the documentation
26
+ - Include a concise description of what the project does
27
+
28
+ ## Technology Stack
29
+ - List the primary technologies, languages, and frameworks used
30
+ - Include version information when available
31
+ - Source this information primarily from the Technology_Stack file
32
+
33
+ ## Project Architecture
34
+ - Provide a high-level overview of the architecture
35
+ - Consider including a simple diagram if described in the documentation
36
+ - Source from the Architecture file
37
+
38
+ ## Getting Started
39
+ - Include installation instructions based on the technology stack
40
+ - Add setup and configuration steps
41
+ - Include any prerequisites
42
+
43
+ ## Project Structure
44
+ - Brief overview of the folder organization
45
+ - Source from Project_Folder_Structure file
46
+
47
+ ## Key Features
48
+ - List main functionality and features of the project
49
+ - Extract from various documentation files
50
+
51
+ ## Development Workflow
52
+ - Summarize the development process
53
+ - Include information about branching strategy if available
54
+ - Source from Workflow_Analysis file
55
+
56
+ ## Coding Standards
57
+ - Summarize key coding standards and conventions
58
+ - Source from the Coding_Standards file
59
+
60
+ ## Testing
61
+ - Explain testing approach and tools
62
+ - Source from Unit_Tests file
63
+
64
+ ## Contributing
65
+ - Guidelines for contributing to the project
66
+ - Reference any code exemplars for guidance
67
+ - Source from Code_Exemplars and copilot-instructions
68
+
69
+ ## License
70
+ - Include license information if available
71
+
72
+ Format the README with proper Markdown, including:
73
+ - Clear headings and subheadings
74
+ - Code blocks where appropriate
75
+ - Lists for better readability
76
+ - Links to other documentation files
77
+ - Badges for build status, version, etc. if information is available
78
+
79
+ Keep the README concise yet informative, focusing on what new developers or users would need to know about the project.
@@ -0,0 +1,13 @@
1
+ ---
2
+ description: 'A micro-prompt that reminds the agent that it is an interactive programmer. Works great in Clojure when Copilot has access to the REPL (probably via Backseat Driver). Will work with any system that has a live REPL that the agent can use. Adapt the prompt with any specific reminders in your workflow and/or workspace.'
3
+ title: 'Interactive Programming Nudge'
4
+ ---
5
+
6
+ Remember that you are an interactive programmer with the system itself as your source of truth. You use the REPL to explore the current system and to modify the current system in order to understand what changes need to be made.
7
+
8
+ Remember that the human does not see what you evaluate with the tool:
9
+ * If you evaluate a large amount of code: describe in a succinct way what is being evaluated.
10
+
11
+ When editing files you prefer to use the structural editing tools.
12
+
13
+ Also remember to tend your todo list.