shmakk 1.1.0 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (450) hide show
  1. package/README.md +16 -1
  2. package/package.json +6 -3
  3. package/scripts/import-skills.js +536 -0
  4. package/scripts/install-skills.js +64 -0
  5. package/skills/ai-elements.md +482 -0
  6. package/skills/architecture.md +151 -0
  7. package/skills/backend-adapter-aws-lambda.md +204 -0
  8. package/skills/backend-adapter-express.md +177 -0
  9. package/skills/backend-adapter-fastify.md +222 -0
  10. package/skills/backend-adapter-fetch.md +200 -0
  11. package/skills/backend-api-docs.md +22 -0
  12. package/skills/backend-aspire.md +232 -0
  13. package/skills/backend-aspnet-core.md +62 -0
  14. package/skills/backend-build-chatgpt-app.md +321 -0
  15. package/skills/backend-build-mcp-app.md +393 -0
  16. package/skills/backend-build-mcp-server.md +222 -0
  17. package/skills/backend-build-mcpb.md +200 -0
  18. package/skills/backend-building-ai-agent-on-cloudflare.md +401 -0
  19. package/skills/backend-caching.md +206 -0
  20. package/skills/backend-chatgpt-app-submission.md +157 -0
  21. package/skills/backend-chatgpt-apps.md +321 -0
  22. package/skills/backend-client-setup.md +318 -0
  23. package/skills/backend-containerize-aspnet-framework.md +455 -0
  24. package/skills/backend-create-spring-boot-java-project.md +164 -0
  25. package/skills/backend-create-spring-boot-kotlin-project.md +148 -0
  26. package/skills/backend-csharp-async.md +50 -0
  27. package/skills/backend-csharp-docs.md +63 -0
  28. package/skills/backend-csharp-mcp-server-generator.md +60 -0
  29. package/skills/backend-dotenv.md +201 -0
  30. package/skills/backend-dotenvx.md +119 -0
  31. package/skills/backend-env-vars.md +259 -0
  32. package/skills/backend-error-handling.md +254 -0
  33. package/skills/backend-fastapi.md +437 -0
  34. package/skills/backend-go-mcp-server-generator.md +335 -0
  35. package/skills/backend-java-mcp-server-generator.md +757 -0
  36. package/skills/backend-kotlin-mcp-server-generator.md +450 -0
  37. package/skills/backend-middlewares.md +243 -0
  38. package/skills/backend-multi-stage-dockerfile.md +47 -0
  39. package/skills/backend-nestjs.md +192 -0
  40. package/skills/backend-next-forge.md +375 -0
  41. package/skills/backend-nextjs.md +746 -0
  42. package/skills/backend-openapi-to-application-code.md +113 -0
  43. package/skills/backend-php-mcp-server-generator.md +523 -0
  44. package/skills/backend-python-mcp-server-generator.md +106 -0
  45. package/skills/backend-routing-middleware.md +251 -0
  46. package/skills/backend-ruby-mcp-server-generator.md +661 -0
  47. package/skills/backend-rust-mcp-server-generator.md +578 -0
  48. package/skills/backend-semantic-kernel.md +57 -0
  49. package/skills/backend-server-setup.md +379 -0
  50. package/skills/backend-server-side-calls.md +250 -0
  51. package/skills/backend-subscriptions.md +407 -0
  52. package/skills/backend-swift-mcp-server-generator.md +670 -0
  53. package/skills/backend-trpc-router.md +152 -0
  54. package/skills/backend-typescript-mcp-server-generator.md +91 -0
  55. package/skills/backend-validators.md +229 -0
  56. package/skills/backend.md +76 -0
  57. package/skills/backup.md +165 -0
  58. package/skills/budget.md +140 -0
  59. package/skills/business-gtm-0-to-1-launch.md +322 -0
  60. package/skills/business-gtm-operating-cadence.md +421 -0
  61. package/skills/business-gtm-positioning-strategy.md +439 -0
  62. package/skills/business-gtm-product-led-growth.md +340 -0
  63. package/skills/calendar.md +95 -0
  64. package/skills/code-review.md +130 -0
  65. package/skills/compliance.md +168 -0
  66. package/skills/contracts.md +130 -0
  67. package/skills/daily-job-run.md +46 -0
  68. package/skills/daily-webdesign.md +187 -0
  69. package/skills/database-bigquery-pipeline-audit.md +130 -0
  70. package/skills/database-cosmosdb-datamodeling.md +1046 -0
  71. package/skills/database-durable-objects.md +187 -0
  72. package/skills/database-ef-core.md +76 -0
  73. package/skills/database-fabric-lakehouse.md +107 -0
  74. package/skills/database-neon-postgres-egress-optimizer.md +213 -0
  75. package/skills/database-neon-postgres.md +218 -0
  76. package/skills/database-postgresql-code-review.md +213 -0
  77. package/skills/database-postgresql-optimization.md +405 -0
  78. package/skills/database-sql-code-review.md +302 -0
  79. package/skills/database-sql-optimization.md +297 -0
  80. package/skills/dependency-audit.md +165 -0
  81. package/skills/design-kami-landing.md +234 -0
  82. package/skills/design.md +221 -0
  83. package/skills/dev-acquire-codebase-knowledge.md +175 -0
  84. package/skills/dev-add-educational-comments.md +129 -0
  85. package/skills/dev-add-model-descriptions.md +74 -0
  86. package/skills/dev-adr-review.md +56 -0
  87. package/skills/dev-boost-prompt.md +26 -0
  88. package/skills/dev-build-run-debug.md +130 -0
  89. package/skills/dev-chunk.md +49 -0
  90. package/skills/dev-claude-md-improver.md +180 -0
  91. package/skills/dev-code-exemplars-blueprint-generator.md +127 -0
  92. package/skills/dev-code-tour.md +434 -0
  93. package/skills/dev-comment-code-generate-a-tutorial.md +27 -0
  94. package/skills/dev-commit.md +81 -0
  95. package/skills/dev-context-map.md +53 -0
  96. package/skills/dev-conventional-commit.md +73 -0
  97. package/skills/dev-create-architectural-decision-record.md +98 -0
  98. package/skills/dev-create-draft-pr.md +17 -0
  99. package/skills/dev-create-pr.md +17 -0
  100. package/skills/dev-create-readme.md +22 -0
  101. package/skills/dev-csharp-mstest.md +479 -0
  102. package/skills/dev-csharp-nunit.md +72 -0
  103. package/skills/dev-csharp-tunit.md +101 -0
  104. package/skills/dev-csharp-xunit.md +69 -0
  105. package/skills/dev-debug-failing-test.md +90 -0
  106. package/skills/dev-diff-analyze.md +32 -0
  107. package/skills/dev-diffs.md +24 -0
  108. package/skills/dev-dotnet-best-practices.md +86 -0
  109. package/skills/dev-dotnet-design-pattern-review.md +43 -0
  110. package/skills/dev-dotnet-timezone.md +110 -0
  111. package/skills/dev-dotnet-upgrade.md +117 -0
  112. package/skills/dev-doublecheck.md +278 -0
  113. package/skills/dev-explain-error.md +15 -0
  114. package/skills/dev-finding-discovery.md +164 -0
  115. package/skills/dev-fix-finding.md +111 -0
  116. package/skills/dev-full-file-edit.md +25 -0
  117. package/skills/dev-git-commit.md +125 -0
  118. package/skills/dev-git-flow-branch-creator.md +293 -0
  119. package/skills/dev-git-workflow.md +46 -0
  120. package/skills/dev-github-automation.md +64 -0
  121. package/skills/dev-github-code-review.md +1140 -0
  122. package/skills/dev-github-issues.md +202 -0
  123. package/skills/dev-gpt-5-4-prompting.md +55 -0
  124. package/skills/dev-investigation-mode.md +277 -0
  125. package/skills/dev-java-add-graalvm-native-image-support.md +450 -0
  126. package/skills/dev-java-docs.md +24 -0
  127. package/skills/dev-java-refactoring-extract-method.md +105 -0
  128. package/skills/dev-java-refactoring-remove-parameter.md +85 -0
  129. package/skills/dev-merge.md +73 -0
  130. package/skills/dev-migrate-create.md +36 -0
  131. package/skills/dev-migrate-validate.md +36 -0
  132. package/skills/dev-my-issues.md +9 -0
  133. package/skills/dev-my-pull-requests.md +15 -0
  134. package/skills/dev-planning-oracle-to-postgres-migration-integration-testing.md +45 -0
  135. package/skills/dev-playwright-generate-test.md +18 -0
  136. package/skills/dev-playwright.md +148 -0
  137. package/skills/dev-prompt-builder.md +142 -0
  138. package/skills/dev-pytest-coverage.md +29 -0
  139. package/skills/dev-python-manager-discovery.md +330 -0
  140. package/skills/dev-python-pypi-package-builder.md +445 -0
  141. package/skills/dev-readme-blueprint-generator.md +79 -0
  142. package/skills/dev-refactor-method-complexity-reduce.md +99 -0
  143. package/skills/dev-refactor-plan.md +66 -0
  144. package/skills/dev-refactor.md +646 -0
  145. package/skills/dev-review-and-refactor.md +16 -0
  146. package/skills/dev-reviewing-oracle-to-postgres-migration.md +68 -0
  147. package/skills/dev-ruff-recursive-fix.md +201 -0
  148. package/skills/dev-run-e2e-tests.md +126 -0
  149. package/skills/dev-run-pre-commit-checks.md +133 -0
  150. package/skills/dev-run-smoke-tests.md +127 -0
  151. package/skills/dev-scaffolding-oracle-to-postgres-migration-test-project.md +55 -0
  152. package/skills/dev-spring-boot-testing.md +190 -0
  153. package/skills/dev-sync-upstream.md +32 -0
  154. package/skills/dev-sync.md +74 -0
  155. package/skills/dev-tdd-workflow.md +23 -0
  156. package/skills/dev-terraform-azurerm-set-diff-analyzer.md +49 -0
  157. package/skills/dev-test-driven-development.md +372 -0
  158. package/skills/dev-test-gaps.md +18 -0
  159. package/skills/dev-test-triage.md +55 -0
  160. package/skills/dev-typer.md +267 -0
  161. package/skills/dev-typescript-setup.md +25 -0
  162. package/skills/dev-unified-diff-edit.md +16 -0
  163. package/skills/dev-unit-test-vue-pinia.md +198 -0
  164. package/skills/dev-using-git-worktrees.md +216 -0
  165. package/skills/dev-validation.md +99 -0
  166. package/skills/dev-verification.md +168 -0
  167. package/skills/dev-webapp-testing.md +134 -0
  168. package/skills/dev-write-coding-standards-from-file.md +317 -0
  169. package/skills/dev-write-tests.md +16 -0
  170. package/skills/devops-appinsights-instrumentation.md +49 -0
  171. package/skills/devops-az-cost-optimize.md +306 -0
  172. package/skills/devops-chronicle.md +154 -0
  173. package/skills/devops-deployments-cicd.md +331 -0
  174. package/skills/devops-devops-rollout-plan.md +118 -0
  175. package/skills/devops-geistdocs.md +276 -0
  176. package/skills/devops-observability.md +774 -0
  177. package/skills/devops-observe-metrics.md +35 -0
  178. package/skills/devops-observe-trace.md +30 -0
  179. package/skills/devops-phoenix-cli.md +163 -0
  180. package/skills/devops-phoenix-tracing.md +140 -0
  181. package/skills/devops-publish-to-pages.md +108 -0
  182. package/skills/devops-telemetry.md +87 -0
  183. package/skills/devops-update-avm-modules-in-bicep.md +61 -0
  184. package/skills/devops.md +81 -0
  185. package/skills/diagrams-canvas.md +204 -0
  186. package/skills/diagrams-draw-io-diagram-generator.md +463 -0
  187. package/skills/diagrams-excalidraw-diagram-generator.md +614 -0
  188. package/skills/diagrams-graphify.md +1277 -0
  189. package/skills/docs-bear-notes.md +108 -0
  190. package/skills/docs-create-llms.md +211 -0
  191. package/skills/docs-doc-gen.md +20 -0
  192. package/skills/docs-documentation-writer.md +46 -0
  193. package/skills/docs-llm-config.md +33 -0
  194. package/skills/docs-mkdocs-translations.md +109 -0
  195. package/skills/docs-obsidian-vault-maintainer.md +14 -0
  196. package/skills/docs-obsidian.md +82 -0
  197. package/skills/docs-prose.md +324 -0
  198. package/skills/docs-update-llms.md +217 -0
  199. package/skills/docs-update-markdown-file-index.md +77 -0
  200. package/skills/docs-wiki-maintainer.md +20 -0
  201. package/skills/documents.md +120 -0
  202. package/skills/email.md +113 -0
  203. package/skills/expenses.md +140 -0
  204. package/skills/file-ops.md +149 -0
  205. package/skills/files-convert-plaintext-to-md.md +363 -0
  206. package/skills/files-doc.md +81 -0
  207. package/skills/files-docx.md +594 -0
  208. package/skills/files-markdown-to-html.md +917 -0
  209. package/skills/files-nano-pdf.md +39 -0
  210. package/skills/files-pdf.md +315 -0
  211. package/skills/files-pdftk-server.md +163 -0
  212. package/skills/files-pptx-html-fidelity-audit.md +255 -0
  213. package/skills/files-pptx.md +231 -0
  214. package/skills/files-xlsx.md +301 -0
  215. package/skills/find-jobs.md +78 -0
  216. package/skills/format-conversion.md +157 -0
  217. package/skills/frontend-ai-elements.md +483 -0
  218. package/skills/frontend-ai-gateway.md +563 -0
  219. package/skills/frontend-ai-generation-persistence.md +242 -0
  220. package/skills/frontend-ai-sdk.md +799 -0
  221. package/skills/frontend-ai-visibility.md +127 -0
  222. package/skills/frontend-angular-developer.md +130 -0
  223. package/skills/frontend-aspnet-minimal-api-openapi.md +42 -0
  224. package/skills/frontend-bencium-innovative-ux-designer.md +719 -0
  225. package/skills/frontend-chat-sdk.md +666 -0
  226. package/skills/frontend-chrome-devtools.md +98 -0
  227. package/skills/frontend-frontend-app-builder.md +186 -0
  228. package/skills/frontend-frontend-design.md +43 -0
  229. package/skills/frontend-frontend-testing-debugging.md +143 -0
  230. package/skills/frontend-gsap-framer-scroll-animation.md +152 -0
  231. package/skills/frontend-internal-linking.md +109 -0
  232. package/skills/frontend-json-render.md +335 -0
  233. package/skills/frontend-keyword-clustering.md +118 -0
  234. package/skills/frontend-next-intl-add-language.md +20 -0
  235. package/skills/frontend-on-page-seo.md +112 -0
  236. package/skills/frontend-premium-frontend-ui.md +114 -0
  237. package/skills/frontend-react-best-practices.md +143 -0
  238. package/skills/frontend-schema-markup.md +160 -0
  239. package/skills/frontend-seo-audit.md +110 -0
  240. package/skills/frontend-swr.md +215 -0
  241. package/skills/frontend-technical-seo.md +162 -0
  242. package/skills/frontend-use-dom.md +418 -0
  243. package/skills/frontend-web-coder.md +564 -0
  244. package/skills/frontend-web-design-reviewer.md +369 -0
  245. package/skills/frontend-web-perf.md +202 -0
  246. package/skills/frontend.md +125 -0
  247. package/skills/general-adapter-standalone.md +199 -0
  248. package/skills/general-auth.md +356 -0
  249. package/skills/general-containerize-aspnetcore.md +393 -0
  250. package/skills/general-create-technical-spike.md +231 -0
  251. package/skills/general-cron-jobs.md +72 -0
  252. package/skills/general-ddd-aggregate.md +52 -0
  253. package/skills/general-ddd-context.md +46 -0
  254. package/skills/general-ddd-validate.md +51 -0
  255. package/skills/general-dependency-check.md +26 -0
  256. package/skills/general-email-marketing.md +86 -0
  257. package/skills/general-healthcheck.md +246 -0
  258. package/skills/general-import-infrastructure-as-code.md +368 -0
  259. package/skills/general-init.md +49 -0
  260. package/skills/general-java-junit.md +64 -0
  261. package/skills/general-java-springboot.md +66 -0
  262. package/skills/general-javascript-typescript-jest.md +45 -0
  263. package/skills/general-kotlin-springboot.md +71 -0
  264. package/skills/general-make-repo-contribution.md +91 -0
  265. package/skills/general-market-research.md +78 -0
  266. package/skills/general-marketplace.md +468 -0
  267. package/skills/general-model-recommendation.md +673 -0
  268. package/skills/general-payments.md +352 -0
  269. package/skills/general-quality-playbook.md +480 -0
  270. package/skills/general-run-integration-tests.md +113 -0
  271. package/skills/general-superjson.md +274 -0
  272. package/skills/general-swiftpm-macos.md +51 -0
  273. package/skills/general-threat-model.md +61 -0
  274. package/skills/invoices.md +167 -0
  275. package/skills/licenses.md +159 -0
  276. package/skills/logs.md +156 -0
  277. package/skills/marketing.md +139 -0
  278. package/skills/media-image-manipulation-image-magick.md +253 -0
  279. package/skills/media-imagegen.md +357 -0
  280. package/skills/media-openai-whisper-api.md +63 -0
  281. package/skills/media-openai-whisper.md +39 -0
  282. package/skills/media-peekaboo.md +191 -0
  283. package/skills/media-screenshot.md +268 -0
  284. package/skills/media-speech.md +145 -0
  285. package/skills/media-transcribe.md +82 -0
  286. package/skills/media-video-frames.md +47 -0
  287. package/skills/mobile-android-emulator-qa.md +81 -0
  288. package/skills/mobile-android-performance.md +280 -0
  289. package/skills/mobile-building-mcp-server-on-cloudflare.md +267 -0
  290. package/skills/mobile-building-native-ui.md +322 -0
  291. package/skills/mobile-expo-api-routes.md +369 -0
  292. package/skills/mobile-expo-cicd-workflows.md +92 -0
  293. package/skills/mobile-expo-deployment.md +191 -0
  294. package/skills/mobile-expo-dev-client.md +165 -0
  295. package/skills/mobile-expo-module.md +177 -0
  296. package/skills/mobile-expo-tailwind-setup.md +481 -0
  297. package/skills/mobile-expo-ui-jetpack-compose.md +41 -0
  298. package/skills/mobile-expo-ui-swift-ui.md +40 -0
  299. package/skills/mobile-ios-app-intents.md +78 -0
  300. package/skills/mobile-ios-debugger-agent.md +52 -0
  301. package/skills/mobile-ios-ettrace-performance.md +198 -0
  302. package/skills/mobile-ios-memgraph-leaks.md +77 -0
  303. package/skills/mobile-native-data-fetching.md +508 -0
  304. package/skills/mobile-packaging-notarization.md +48 -0
  305. package/skills/mobile-react-native-architecture.md +672 -0
  306. package/skills/mobile-react-native-mobile-design.md +438 -0
  307. package/skills/mobile-signing-entitlements.md +59 -0
  308. package/skills/mobile-swiftui-liquid-glass.md +91 -0
  309. package/skills/mobile-swiftui-patterns.md +210 -0
  310. package/skills/mobile-swiftui-performance-audit.md +108 -0
  311. package/skills/mobile-swiftui-ui-patterns.md +97 -0
  312. package/skills/mobile-swiftui-view-refactor.md +204 -0
  313. package/skills/mobile-upgrading-expo.md +134 -0
  314. package/skills/mobile.md +183 -0
  315. package/skills/notes.md +106 -0
  316. package/skills/planning-adr-create.md +62 -0
  317. package/skills/planning-adr-index.md +67 -0
  318. package/skills/planning-architecture-blueprint-generator.md +323 -0
  319. package/skills/planning-brainstorming.md +165 -0
  320. package/skills/planning-breakdown-epic-arch.md +67 -0
  321. package/skills/planning-breakdown-epic-pm.md +59 -0
  322. package/skills/planning-breakdown-feature-implementation.md +129 -0
  323. package/skills/planning-breakdown-feature-prd.md +62 -0
  324. package/skills/planning-breakdown-plan.md +510 -0
  325. package/skills/planning-breakdown-test.md +366 -0
  326. package/skills/planning-cloud-design-patterns.md +63 -0
  327. package/skills/planning-content-brief.md +128 -0
  328. package/skills/planning-content-strategy.md +138 -0
  329. package/skills/planning-content-translation.md +143 -0
  330. package/skills/planning-create-github-action-workflow-specification.md +277 -0
  331. package/skills/planning-create-github-issues-feature-from-implementation-plan.md +29 -0
  332. package/skills/planning-create-github-issues-for-unmet-specification-requirements.md +36 -0
  333. package/skills/planning-create-github-pull-request-from-specification.md +25 -0
  334. package/skills/planning-create-implementation-plan.md +158 -0
  335. package/skills/planning-create-specification.md +128 -0
  336. package/skills/planning-first-ask.md +31 -0
  337. package/skills/planning-folder-structure-blueprint-generator.md +406 -0
  338. package/skills/planning-gen-specs-as-issues.md +166 -0
  339. package/skills/planning-generate-snapshot.md +144 -0
  340. package/skills/planning-generate-status-report.md +336 -0
  341. package/skills/planning-metric-pack-designer.md +27 -0
  342. package/skills/planning-pm-spec.md +53 -0
  343. package/skills/planning-prd.md +144 -0
  344. package/skills/planning-project-assessment.md +182 -0
  345. package/skills/planning-project-setup-info-local.md +128 -0
  346. package/skills/planning-project-workflow-analysis-blueprint-generator.md +294 -0
  347. package/skills/planning-service-oriented-architecture.md +248 -0
  348. package/skills/planning-spec-to-backlog.md +544 -0
  349. package/skills/planning-technology-stack-blueprint-generator.md +243 -0
  350. package/skills/planning-update-implementation-plan.md +158 -0
  351. package/skills/planning-update-specification.md +128 -0
  352. package/skills/planning-what-context-needed.md +40 -0
  353. package/skills/planning-writing-plans.md +153 -0
  354. package/skills/prepare-application.md +81 -0
  355. package/skills/productivity-apple-notes.md +78 -0
  356. package/skills/productivity-apple-reminders.md +119 -0
  357. package/skills/productivity-capture-tasks-from-meeting-notes.md +680 -0
  358. package/skills/productivity-daily-prep.md +156 -0
  359. package/skills/productivity-email-drafter.md +101 -0
  360. package/skills/productivity-hr-onboarding.md +53 -0
  361. package/skills/productivity-things-mac.md +87 -0
  362. package/skills/productivity-update.md +169 -0
  363. package/skills/reminders.md +109 -0
  364. package/skills/research-dossier-collect.md +71 -0
  365. package/skills/research-kg-extract.md +37 -0
  366. package/skills/research-openai-docs.md +89 -0
  367. package/skills/research-research-add-items.md +31 -0
  368. package/skills/research-research-report.md +94 -0
  369. package/skills/research-research-synthesize.md +63 -0
  370. package/skills/research-summarize.md +88 -0
  371. package/skills/research-transformers-js.md +635 -0
  372. package/skills/research.md +119 -0
  373. package/skills/security-ai-prompt-engineering-safety-review.md +231 -0
  374. package/skills/security-attack-path-analysis.md +182 -0
  375. package/skills/security-gdpr-compliant.md +284 -0
  376. package/skills/security-mcp-security-audit.md +279 -0
  377. package/skills/security-pii-detect.md +31 -0
  378. package/skills/security-secret-scanning.md +243 -0
  379. package/skills/security-security-best-practices.md +87 -0
  380. package/skills/security-security-ownership-map.md +207 -0
  381. package/skills/security-security-review.md +169 -0
  382. package/skills/security-security-scan.md +138 -0
  383. package/skills/security-security-threat-model.md +82 -0
  384. package/skills/security-threat-model-analyst.md +76 -0
  385. package/skills/sysmon.md +181 -0
  386. package/skills/system-arch-linux-triage.md +32 -0
  387. package/skills/system-centos-linux-triage.md +32 -0
  388. package/skills/system-debian-linux-triage.md +32 -0
  389. package/skills/system-fedora-linux-triage.md +32 -0
  390. package/skills/system-geofeed-tuner.md +865 -0
  391. package/skills/system-iot-anomalies.md +15 -0
  392. package/skills/system-iot-firmware.md +16 -0
  393. package/skills/system-iot-fleet.md +14 -0
  394. package/skills/system-iot-register.md +19 -0
  395. package/skills/system-iot-witness-verify.md +15 -0
  396. package/skills/system-tmux.md +171 -0
  397. package/skills/system-window-management.md +228 -0
  398. package/skills/task-management.md +90 -0
  399. package/skills/tasks.md +102 -0
  400. package/skills/test-coverage.md +188 -0
  401. package/skills/ux-ui.md +128 -0
  402. package/skills/web.md +186 -0
  403. package/skills/workflow-act-on-feedback.md +15 -0
  404. package/skills/workflow-automate-this.md +245 -0
  405. package/skills/workflow-autoresearch.md +276 -0
  406. package/skills/workflow-coding-agent.md +317 -0
  407. package/skills/workflow-deep-research.md +44 -0
  408. package/skills/workflow-dispatching-parallel-agents.md +183 -0
  409. package/skills/workflow-eval-driven-dev.md +148 -0
  410. package/skills/workflow-executing-plans.md +71 -0
  411. package/skills/workflow-mentoring-juniors.md +311 -0
  412. package/skills/workflow-receiving-code-review.md +214 -0
  413. package/skills/workflow-repo-story-time.md +155 -0
  414. package/skills/workflow-requesting-code-review.md +104 -0
  415. package/skills/workflow-session-report.md +43 -0
  416. package/skills/workflow-structured-autonomy-generate.md +126 -0
  417. package/skills/workflow-subagent-driven-development.md +280 -0
  418. package/skills/writing.md +106 -0
  419. package/src/agent.js +0 -0
  420. package/src/browser.js +297 -0
  421. package/src/cli.js +25 -4
  422. package/src/code-reviewer.js +119 -0
  423. package/src/completions.js +1 -1
  424. package/src/control.js +222 -30
  425. package/src/coordinator.js +303 -0
  426. package/src/correction.js +29 -8
  427. package/src/edit-tracker.js +21 -0
  428. package/src/edit-viewer.js +414 -0
  429. package/src/endpoints.js +64 -15
  430. package/src/index.js +45 -11
  431. package/src/llm.js +86 -2
  432. package/src/mcp-client.js +416 -0
  433. package/src/memory.js +182 -0
  434. package/src/planner.js +216 -0
  435. package/src/rules.js +90 -0
  436. package/src/self-commands.js +757 -0
  437. package/src/services/voice.js +10 -7
  438. package/src/session-search.js +427 -0
  439. package/src/session.js +487 -99
  440. package/src/shmakk-server.js +91 -0
  441. package/src/skills.js +410 -3
  442. package/src/subagent.js +4 -1
  443. package/src/system-prompt.js +13 -5
  444. package/src/task-file.js +114 -0
  445. package/src/taskClassifier.js +246 -0
  446. package/src/team.js +752 -0
  447. package/src/tools.js +142 -21
  448. package/src/web.js +35 -5
  449. package/src/workflows.js +261 -0
  450. package/src/workspace-index.js +25 -6
@@ -0,0 +1,393 @@
1
+ ---
2
+ name: containerize-aspnetcore
3
+ description: 'Containerize an ASP.NET Core project by creating Dockerfile and .dockerfile files customized for the project.'
4
+ category: general
5
+ ---
6
+
7
+ # ASP.NET Core Docker Containerization Prompt
8
+
9
+ ## Containerization Request
10
+
11
+ Containerize the ASP.NET Core (.NET) project specified in the settings below, focusing **exclusively** on changes required for the application to run in a Linux Docker container. Containerization should consider all settings specified here.
12
+
13
+ Abide by best practices for containerizing .NET Core applications, ensuring that the container is optimized for performance, security, and maintainability.
14
+
15
+ ## Containerization Settings
16
+
17
+ This section of the prompt contains the specific settings and configurations required for containerizing the ASP.NET Core application. Prior to running this prompt, ensure that the settings are filled out with the necessary information. Note that in many cases, only the first few settings are required. Later settings can be left as defaults if they do not apply to the project being containerized.
18
+
19
+ Any settings that are not specified will be set to default values. The default values are provided in `[square brackets]`.
20
+
21
+ ### Basic Project Information
22
+ 1. Project to containerize:
23
+ - `[ProjectName (provide path to .csproj file)]`
24
+
25
+ 2. .NET version to use:
26
+ - `[8.0 or 9.0 (Default 8.0)]`
27
+
28
+ 3. Linux distribution to use:
29
+ - `[debian, alpine, ubuntu, chiseled, or Azure Linux (mariner) (Default debian)]`
30
+
31
+ 4. Custom base image for the build stage of the Docker image ("None" to use standard Microsoft base image):
32
+ - `[Specify base image to use for build stage (Default None)]`
33
+
34
+ 5. Custom base image for the run stage of the Docker image ("None" to use standard Microsoft base image):
35
+ - `[Specify base image to use for run stage (Default None)]`
36
+
37
+ ### Container Configuration
38
+ 1. Ports that must be exposed in the container image:
39
+ - Primary HTTP port: `[e.g., 8080]`
40
+ - Additional ports: `[List any additional ports, or "None"]`
41
+
42
+ 2. User account the container should run as:
43
+ - `[User account, or default to "$APP_UID"]`
44
+
45
+ 3. Application URL configuration:
46
+ - `[Specify ASPNETCORE_URLS, or default to "http://+:8080"]`
47
+
48
+ ### Build configuration
49
+ 1. Custom build steps that must be performed before building the container image:
50
+ - `[List any specific build steps, or "None"]`
51
+
52
+ 2. Custom build steps that must be performed after building the container image:
53
+ - `[List any specific build steps, or "None"]`
54
+
55
+ 3. NuGet package sources that must be configured:
56
+ - `[List any private NuGet feeds with authentication details, or "None"]`
57
+
58
+ ### Dependencies
59
+ 1. System packages that must be installed in the container image:
60
+ - `[Package names for the chosen Linux distribution, or "None"]`
61
+
62
+ 2. Native libraries that must be copied to the container image:
63
+ - `[Library names and paths, or "None"]`
64
+
65
+ 3. Additional .NET tools that must be installed:
66
+ - `[Tool names and versions, or "None"]`
67
+
68
+ ### System Configuration
69
+ 1. Environment variables that must be set in the container image:
70
+ - `[Variable names and values, or "Use defaults"]`
71
+
72
+ ### File System
73
+ 1. Files/directories that need to be copied to the container image:
74
+ - `[Paths relative to project root, or "None"]`
75
+ - Target location in container: `[Container paths, or "Not applicable"]`
76
+
77
+ 2. Files/directories to exclude from containerization:
78
+ - `[Paths to exclude, or "None"]`
79
+
80
+ 3. Volume mount points that should be configured:
81
+ - `[Volume paths for persistent data, or "None"]`
82
+
83
+ ### .dockerignore Configuration
84
+ 1. Patterns to include in the `.dockerignore` file (.dockerignore will already have common defaults; these are additional patterns):
85
+ - Additional patterns: `[List any additional patterns, or "None"]`
86
+
87
+ ### Health Check Configuration
88
+ 1. Health check endpoint:
89
+ - `[Health check URL path, or "None"]`
90
+
91
+ 2. Health check interval and timeout:
92
+ - `[Interval and timeout values, or "Use defaults"]`
93
+
94
+ ### Additional Instructions
95
+ 1. Other instructions that must be followed to containerize the project:
96
+ - `[Specific requirements, or "None"]`
97
+
98
+ 2. Known issues to address:
99
+ - `[Describe any known issues, or "None"]`
100
+
101
+ ## Scope
102
+
103
+ - ✅ App configuration modification to ensure application settings and connection strings can be read from environment variables
104
+ - ✅ Dockerfile creation and configuration for an ASP.NET Core application
105
+ - ✅ Specifying multiple stages in the Dockerfile to build/publish the application and copy the output to the final image
106
+ - ✅ Configuration of Linux container platform compatibility (Alpine, Ubuntu, Chiseled, or Azure Linux (Mariner))
107
+ - ✅ Proper handling of dependencies (system packages, native libraries, additional tools)
108
+ - ❌ No infrastructure setup (assumed to be handled separately)
109
+ - ❌ No code changes beyond those required for containerization
110
+
111
+ ## Execution Process
112
+
113
+ 1. Review the containerization settings above to understand the containerization requirements
114
+ 2. Create a `progress.md` file to track changes with check marks
115
+ 3. Determine the .NET version from the project's .csproj file by checking the `TargetFramework` element
116
+ 4. Select the appropriate Linux container image based on:
117
+ - The .NET version detected from the project
118
+ - The Linux distribution specified in containerization settings (Alpine, Ubuntu, Chiseled, or Azure Linux (Mariner))
119
+ - If the user does not request specific base images in the containerization settings, then the base images MUST be valid mcr.microsoft.com/dotnet images with a tag as shown in the example Dockerfile, below, or in documentation
120
+ - Official Microsoft .NET images for build and runtime stages:
121
+ - SDK image tags (for build stage): https://github.com/dotnet/dotnet-docker/blob/main/README.sdk.md
122
+ - ASP.NET Core runtime image tags: https://github.com/dotnet/dotnet-docker/blob/main/README.aspnet.md
123
+ - .NET runtime image tags: https://github.com/dotnet/dotnet-docker/blob/main/README.runtime.md
124
+ 5. Create a Dockerfile in the root of the project directory to containerize the application
125
+ - The Dockerfile should use multiple stages:
126
+ - Build stage: Use a .NET SDK image to build the application
127
+ - Copy csproj file(s) first
128
+ - Copy NuGet.config if one exists and configure any private feeds
129
+ - Restore NuGet packages
130
+ - Then, copy the rest of the source code and build and publish the application to /app/publish
131
+ - Final stage: Use the selected .NET runtime image to run the application
132
+ - Set the working directory to /app
133
+ - Set the user as directed (by default, to a non-root user (e.g., `$APP_UID`))
134
+ - Unless directed otherwise in containerization settings, a new user does *not* need to be created. Use the `$APP_UID` variable to specify the user account.
135
+ - Copy the published output from the build stage to the final image
136
+ - Be sure to consider all requirements in the containerization settings:
137
+ - .NET version and Linux distribution
138
+ - Exposed ports
139
+ - User account for container
140
+ - ASPNETCORE_URLS configuration
141
+ - System package installation
142
+ - Native library dependencies
143
+ - Additional .NET tools
144
+ - Environment variables
145
+ - File/directory copying
146
+ - Volume mount points
147
+ - Health check configuration
148
+ 6. Create a `.dockerignore` file in the root of the project directory to exclude unnecessary files from the Docker image. The `.dockerignore` file **MUST** include at least the following elements as well as additional patterns as specified in the containerization settings:
149
+ - bin/
150
+ - obj/
151
+ - .dockerignore
152
+ - Dockerfile
153
+ - .git/
154
+ - .github/
155
+ - .vs/
156
+ - .vscode/
157
+ - **/node_modules/
158
+ - *.user
159
+ - *.suo
160
+ - **/.DS_Store
161
+ - **/Thumbs.db
162
+ - Any additional patterns specified in the containerization settings
163
+ 7. Configure health checks if specified in the containerization settings:
164
+ - Add HEALTHCHECK instruction to Dockerfile if health check endpoint is provided
165
+ - Use curl or wget to check the health endpoint
166
+ 8. Mark tasks as completed: [ ] → [✓]
167
+ 9. Continue until all tasks are complete and Docker build succeeds
168
+
169
+ ## Build and Runtime Verification
170
+
171
+ Confirm that Docker build succeeds once the Dockerfile is completed. Use the following command to build the Docker image:
172
+
173
+ ```bash
174
+ docker build -t aspnetcore-app:latest .
175
+ ```
176
+
177
+ If the build fails, review the error messages and make necessary adjustments to the Dockerfile or project configuration. Report success/failure.
178
+
179
+ ## Progress Tracking
180
+
181
+ Maintain a `progress.md` file with the following structure:
182
+ ```markdown
183
+ # Containerization Progress
184
+
185
+ ## Environment Detection
186
+ - [ ] .NET version detection (version: ___)
187
+ - [ ] Linux distribution selection (distribution: ___)
188
+
189
+ ## Configuration Changes
190
+ - [ ] Application configuration verification for environment variable support
191
+ - [ ] NuGet package source configuration (if applicable)
192
+
193
+ ## Containerization
194
+ - [ ] Dockerfile creation
195
+ - [ ] .dockerignore file creation
196
+ - [ ] Build stage created with SDK image
197
+ - [ ] csproj file(s) copied for package restore
198
+ - [ ] NuGet.config copied if applicable
199
+ - [ ] Runtime stage created with runtime image
200
+ - [ ] Non-root user configuration
201
+ - [ ] Dependency handling (system packages, native libraries, tools, etc.)
202
+ - [ ] Health check configuration (if applicable)
203
+ - [ ] Special requirements implementation
204
+
205
+ ## Verification
206
+ - [ ] Review containerization settings and make sure that all requirements are met
207
+ - [ ] Docker build success
208
+ ```
209
+
210
+ Do not pause for confirmation between steps. Continue methodically until the application has been containerized and Docker build succeeds.
211
+
212
+ **YOU ARE NOT DONE UNTIL ALL CHECKBOXES ARE MARKED!** This includes building the Docker image successfully and addressing any issues that arise during the build process.
213
+
214
+ ## Example Dockerfile
215
+
216
+ An example Dockerfile for an ASP.NET Core (.NET) application using a Linux base image.
217
+
218
+ ```dockerfile
219
+ # ============================================================
220
+ # Stage 1: Build and publish the application
221
+ # ============================================================
222
+
223
+ # Base Image - Select the appropriate .NET SDK version and Linux distribution
224
+ # Possible tags include:
225
+ # - 8.0-bookworm-slim (Debian 12)
226
+ # - 8.0-noble (Ubuntu 24.04)
227
+ # - 8.0-alpine (Alpine Linux)
228
+ # - 9.0-bookworm-slim (Debian 12)
229
+ # - 9.0-noble (Ubuntu 24.04)
230
+ # - 9.0-alpine (Alpine Linux)
231
+ # Uses the .NET SDK image for building the application
232
+ FROM mcr.microsoft.com/dotnet/sdk:8.0-bookworm-slim AS build
233
+ ARG BUILD_CONFIGURATION=Release
234
+
235
+ WORKDIR /src
236
+
237
+ # Copy project files first for better caching
238
+ COPY ["YourProject/YourProject.csproj", "YourProject/"]
239
+ COPY ["YourOtherProject/YourOtherProject.csproj", "YourOtherProject/"]
240
+
241
+ # Copy NuGet configuration if it exists
242
+ COPY ["NuGet.config", "."]
243
+
244
+ # Restore NuGet packages
245
+ RUN dotnet restore "YourProject/YourProject.csproj"
246
+
247
+ # Copy source code
248
+ COPY . .
249
+
250
+ # Perform custom pre-build steps here, if needed
251
+ # RUN echo "Running pre-build steps..."
252
+
253
+ # Build and publish the application
254
+ WORKDIR "/src/YourProject"
255
+ RUN dotnet build "YourProject.csproj" -c $BUILD_CONFIGURATION -o /app/build
256
+
257
+ # Publish the application
258
+ RUN dotnet publish "YourProject.csproj" -c $BUILD_CONFIGURATION -o /app/publish /p:UseAppHost=false
259
+
260
+ # Perform custom post-build steps here, if needed
261
+ # RUN echo "Running post-build steps..."
262
+
263
+ # ============================================================
264
+ # Stage 2: Final runtime image
265
+ # ============================================================
266
+
267
+ # Base Image - Select the appropriate .NET runtime version and Linux distribution
268
+ # Possible tags include:
269
+ # - 8.0-bookworm-slim (Debian 12)
270
+ # - 8.0-noble (Ubuntu 24.04)
271
+ # - 8.0-alpine (Alpine Linux)
272
+ # - 8.0-noble-chiseled (Ubuntu 24.04 Chiseled)
273
+ # - 8.0-azurelinux3.0 (Azure Linux)
274
+ # - 9.0-bookworm-slim (Debian 12)
275
+ # - 9.0-noble (Ubuntu 24.04)
276
+ # - 9.0-alpine (Alpine Linux)
277
+ # - 9.0-noble-chiseled (Ubuntu 24.04 Chiseled)
278
+ # - 9.0-azurelinux3.0 (Azure Linux)
279
+ # Uses the .NET runtime image for running the application
280
+ FROM mcr.microsoft.com/dotnet/aspnet:8.0-bookworm-slim AS final
281
+
282
+ # Install system packages if needed (uncomment and modify as needed)
283
+ # RUN apt-get update && apt-get install -y \
284
+ # curl \
285
+ # wget \
286
+ # ca-certificates \
287
+ # libgdiplus \
288
+ # && rm -rf /var/lib/apt/lists/*
289
+
290
+ # Install additional .NET tools if needed (uncomment and modify as needed)
291
+ # RUN dotnet tool install --global dotnet-ef --version 8.0.0
292
+ # ENV PATH="$PATH:/root/.dotnet/tools"
293
+
294
+ WORKDIR /app
295
+
296
+ # Copy published application from build stage
297
+ COPY --from=build /app/publish .
298
+
299
+ # Copy additional files if needed (uncomment and modify as needed)
300
+ # COPY ./config/appsettings.Production.json .
301
+ # COPY ./certificates/ ./certificates/
302
+
303
+ # Set environment variables
304
+ ENV ASPNETCORE_ENVIRONMENT=Production
305
+ ENV ASPNETCORE_URLS=http://+:8080
306
+
307
+ # Add custom environment variables if needed (uncomment and modify as needed)
308
+ # ENV CONNECTIONSTRINGS__DEFAULTCONNECTION="your-connection-string"
309
+ # ENV FEATURE_FLAG_ENABLED=true
310
+
311
+ # Configure SSL/TLS certificates if needed (uncomment and modify as needed)
312
+ # ENV ASPNETCORE_Kestrel__Certificates__Default__Path=/app/certificates/app.pfx
313
+ # ENV ASPNETCORE_Kestrel__Certificates__Default__Password=your_password
314
+
315
+ # Expose the port the application listens on
316
+ EXPOSE 8080
317
+ # EXPOSE 8081 # Uncomment if using HTTPS
318
+
319
+ # Install curl for health checks if not already present
320
+ RUN apt-get update && apt-get install -y curl && rm -rf /var/lib/apt/lists/*
321
+
322
+ # Configure health check
323
+ HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
324
+ CMD curl -f http://localhost:8080/health || exit 1
325
+
326
+ # Create volumes for persistent data if needed (uncomment and modify as needed)
327
+ # VOLUME ["/app/data", "/app/logs"]
328
+
329
+ # Switch to non-root user for security
330
+ USER $APP_UID
331
+
332
+ # Set the entry point for the application
333
+ ENTRYPOINT ["dotnet", "YourProject.dll"]
334
+ ```
335
+
336
+ ## Adapting this Example
337
+
338
+ **Note:** Customize this template based on the specific requirements in containerization settings.
339
+
340
+ When adapting this example Dockerfile:
341
+
342
+ 1. Replace `YourProject.csproj`, `YourProject.dll`, etc. with your actual project names
343
+ 2. Adjust the .NET version and Linux distribution as needed
344
+ 3. Modify the dependency installation steps based on your requirements and remove any unnecessary ones
345
+ 4. Configure environment variables specific to your application
346
+ 5. Add or remove stages as needed for your specific workflow
347
+ 6. Update the health check endpoint to match your application's health check route
348
+
349
+ ## Linux Distribution Variations
350
+
351
+ ### Alpine Linux
352
+ For smaller image sizes, you can use Alpine Linux:
353
+
354
+ ```dockerfile
355
+ FROM mcr.microsoft.com/dotnet/sdk:8.0-alpine AS build
356
+ # ... build steps ...
357
+
358
+ FROM mcr.microsoft.com/dotnet/aspnet:8.0-alpine AS final
359
+ # Install packages using apk
360
+ RUN apk update && apk add --no-cache curl ca-certificates
361
+ ```
362
+
363
+ ### Ubuntu Chiseled
364
+ For minimal attack surface, consider using chiseled images:
365
+
366
+ ```dockerfile
367
+ FROM mcr.microsoft.com/dotnet/aspnet:8.0-jammy-chiseled AS final
368
+ # Note: Chiseled images have minimal packages, so you may need to use a different base for additional dependencies
369
+ ```
370
+
371
+ ### Azure Linux (Mariner)
372
+ For Azure-optimized containers:
373
+
374
+ ```dockerfile
375
+ FROM mcr.microsoft.com/dotnet/aspnet:8.0-azurelinux3.0 AS final
376
+ # Install packages using tdnf
377
+ RUN tdnf update -y && tdnf install -y curl ca-certificates && tdnf clean all
378
+ ```
379
+
380
+ ## Notes on Stage Naming
381
+
382
+ - The `AS stage-name` syntax gives each stage a name
383
+ - Use `--from=stage-name` to copy files from a previous stage
384
+ - You can have multiple intermediate stages that aren't used in the final image
385
+ - The `final` stage is the one that becomes the final container image
386
+
387
+ ## Security Best Practices
388
+
389
+ - Always run as a non-root user in production
390
+ - Use specific image tags instead of `latest`
391
+ - Minimize the number of installed packages
392
+ - Keep base images updated
393
+ - Use multi-stage builds to exclude build dependencies from the final image
@@ -0,0 +1,231 @@
1
+ ---
2
+ name: create-technical-spike
3
+ description: 'Create time-boxed technical spike documents for researching and resolving critical development decisions before implementation.'
4
+ category: general
5
+ ---
6
+
7
+ # Create Technical Spike Document
8
+
9
+ Create time-boxed technical spike documents for researching critical questions that must be answered before development can proceed. Each spike focuses on a specific technical decision with clear deliverables and timelines.
10
+
11
+ ## Document Structure
12
+
13
+ Create individual files in `${input:FolderPath|docs/spikes}` directory. Name each file using the pattern: `[category]-[short-description]-spike.md` (e.g., `api-copilot-integration-spike.md`, `performance-realtime-audio-spike.md`).
14
+
15
+ ```md
16
+ ---
17
+ title: "${input:SpikeTitle}"
18
+ category: "${input:Category|Technical}"
19
+ status: "🔴 Not Started"
20
+ priority: "${input:Priority|High}"
21
+ timebox: "${input:Timebox|1 week}"
22
+ created: [YYYY-MM-DD]
23
+ updated: [YYYY-MM-DD]
24
+ owner: "${input:Owner}"
25
+ tags: ["technical-spike", "${input:Category|technical}", "research"]
26
+ ---
27
+
28
+ # ${input:SpikeTitle}
29
+
30
+ ## Summary
31
+
32
+ **Spike Objective:** [Clear, specific question or decision that needs resolution]
33
+
34
+ **Why This Matters:** [Impact on development/architecture decisions]
35
+
36
+ **Timebox:** [How much time allocated to this spike]
37
+
38
+ **Decision Deadline:** [When this must be resolved to avoid blocking development]
39
+
40
+ ## Research Question(s)
41
+
42
+ **Primary Question:** [Main technical question that needs answering]
43
+
44
+ **Secondary Questions:**
45
+
46
+ - [Related question 1]
47
+ - [Related question 2]
48
+ - [Related question 3]
49
+
50
+ ## Investigation Plan
51
+
52
+ ### Research Tasks
53
+
54
+ - [ ] [Specific research task 1]
55
+ - [ ] [Specific research task 2]
56
+ - [ ] [Specific research task 3]
57
+ - [ ] [Create proof of concept/prototype]
58
+ - [ ] [Document findings and recommendations]
59
+
60
+ ### Success Criteria
61
+
62
+ **This spike is complete when:**
63
+
64
+ - [ ] [Specific criteria 1]
65
+ - [ ] [Specific criteria 2]
66
+ - [ ] [Clear recommendation documented]
67
+ - [ ] [Proof of concept completed (if applicable)]
68
+
69
+ ## Technical Context
70
+
71
+ **Related Components:** [List system components affected by this decision]
72
+
73
+ **Dependencies:** [What other spikes or decisions depend on resolving this]
74
+
75
+ **Constraints:** [Known limitations or requirements that affect the solution]
76
+
77
+ ## Research Findings
78
+
79
+ ### Investigation Results
80
+
81
+ [Document research findings, test results, and evidence gathered]
82
+
83
+ ### Prototype/Testing Notes
84
+
85
+ [Results from any prototypes, spikes, or technical experiments]
86
+
87
+ ### External Resources
88
+
89
+ - [Link to relevant documentation]
90
+ - [Link to API references]
91
+ - [Link to community discussions]
92
+ - [Link to examples/tutorials]
93
+
94
+ ## Decision
95
+
96
+ ### Recommendation
97
+
98
+ [Clear recommendation based on research findings]
99
+
100
+ ### Rationale
101
+
102
+ [Why this approach was chosen over alternatives]
103
+
104
+ ### Implementation Notes
105
+
106
+ [Key considerations for implementation]
107
+
108
+ ### Follow-up Actions
109
+
110
+ - [ ] [Action item 1]
111
+ - [ ] [Action item 2]
112
+ - [ ] [Update architecture documents]
113
+ - [ ] [Create implementation tasks]
114
+
115
+ ## Status History
116
+
117
+ | Date | Status | Notes |
118
+ | ------ | -------------- | -------------------------- |
119
+ | [Date] | 🔴 Not Started | Spike created and scoped |
120
+ | [Date] | 🟡 In Progress | Research commenced |
121
+ | [Date] | 🟢 Complete | [Resolution summary] |
122
+
123
+ ---
124
+
125
+ _Last updated: [Date] by [Name]_
126
+ ```
127
+
128
+ ## Categories for Technical Spikes
129
+
130
+ ### API Integration
131
+
132
+ - Third-party API capabilities and limitations
133
+ - Integration patterns and authentication
134
+ - Rate limits and performance characteristics
135
+
136
+ ### Architecture & Design
137
+
138
+ - System architecture decisions
139
+ - Design pattern applicability
140
+ - Component interaction models
141
+
142
+ ### Performance & Scalability
143
+
144
+ - Performance requirements and constraints
145
+ - Scalability bottlenecks and solutions
146
+ - Resource utilization patterns
147
+
148
+ ### Platform & Infrastructure
149
+
150
+ - Platform capabilities and limitations
151
+ - Infrastructure requirements
152
+ - Deployment and hosting considerations
153
+
154
+ ### Security & Compliance
155
+
156
+ - Security requirements and implementations
157
+ - Compliance constraints
158
+ - Authentication and authorization approaches
159
+
160
+ ### User Experience
161
+
162
+ - User interaction patterns
163
+ - Accessibility requirements
164
+ - Interface design decisions
165
+
166
+ ## File Naming Conventions
167
+
168
+ Use descriptive, kebab-case names that indicate the category and specific unknown:
169
+
170
+ **API/Integration Examples:**
171
+
172
+ - `api-copilot-chat-integration-spike.md`
173
+ - `api-azure-speech-realtime-spike.md`
174
+ - `api-vscode-extension-capabilities-spike.md`
175
+
176
+ **Performance Examples:**
177
+
178
+ - `performance-audio-processing-latency-spike.md`
179
+ - `performance-extension-host-limitations-spike.md`
180
+ - `performance-webrtc-reliability-spike.md`
181
+
182
+ **Architecture Examples:**
183
+
184
+ - `architecture-voice-pipeline-design-spike.md`
185
+ - `architecture-state-management-spike.md`
186
+ - `architecture-error-handling-strategy-spike.md`
187
+
188
+ ## Best Practices for AI Agents
189
+
190
+ 1. **One Question Per Spike:** Each document focuses on a single technical decision or research question
191
+
192
+ 2. **Time-Boxed Research:** Define specific time limits and deliverables for each spike
193
+
194
+ 3. **Evidence-Based Decisions:** Require concrete evidence (tests, prototypes, documentation) before marking as complete
195
+
196
+ 4. **Clear Recommendations:** Document specific recommendations and rationale for implementation
197
+
198
+ 5. **Dependency Tracking:** Identify how spikes relate to each other and impact project decisions
199
+
200
+ 6. **Outcome-Focused:** Every spike must result in an actionable decision or recommendation
201
+
202
+ ## Research Strategy
203
+
204
+ ### Phase 1: Information Gathering
205
+
206
+ 1. **Search existing documentation** using search/fetch tools
207
+ 2. **Analyze codebase** for existing patterns and constraints
208
+ 3. **Research external resources** (APIs, libraries, examples)
209
+
210
+ ### Phase 2: Validation & Testing
211
+
212
+ 1. **Create focused prototypes** to test specific hypotheses
213
+ 2. **Run targeted experiments** to validate assumptions
214
+ 3. **Document test results** with supporting evidence
215
+
216
+ ### Phase 3: Decision & Documentation
217
+
218
+ 1. **Synthesize findings** into clear recommendations
219
+ 2. **Document implementation guidance** for development team
220
+ 3. **Create follow-up tasks** for implementation
221
+
222
+ ## Tools Usage
223
+
224
+ - **search/searchResults:** Research existing solutions and documentation
225
+ - **fetch/githubRepo:** Analyze external APIs, libraries, and examples
226
+ - **codebase:** Understand existing system constraints and patterns
227
+ - **runTasks:** Execute prototypes and validation tests
228
+ - **editFiles:** Update research progress and findings
229
+ - **vscodeAPI:** Test VS Code extension capabilities and limitations
230
+
231
+ Focus on time-boxed research that resolves critical technical decisions and unblocks development progress.
@@ -0,0 +1,72 @@
1
+ ---
2
+ name: cron-jobs
3
+ description: Vercel Cron Jobs configuration and best practices. Use when adding, editing, or debugging scheduled tasks in vercel.json.
4
+ metadata:
5
+ priority: 6
6
+ docs:
7
+ - "https://vercel.com/docs/cron-jobs"
8
+ sitemap: "https://vercel.com/sitemap/docs.xml"
9
+ pathPatterns:
10
+ - 'vercel.json'
11
+ - 'apps/*/vercel.json'
12
+ bashPatterns: []
13
+ category: general
14
+ ---
15
+
16
+ # Vercel Cron Jobs
17
+
18
+ You are an expert in Vercel Cron Jobs — scheduled serverless function invocations configured in `vercel.json`.
19
+
20
+ ## Configuration
21
+
22
+ Cron jobs are defined in the `crons` array of `vercel.json`:
23
+
24
+ ```json
25
+ {
26
+ "crons": [
27
+ {
28
+ "path": "/api/cron/daily-digest",
29
+ "schedule": "0 8 * * *"
30
+ }
31
+ ]
32
+ }
33
+ ```
34
+
35
+ ## Key Rules
36
+
37
+ 1. **Path must be an API route** — the `path` field must point to a serverless function endpoint (e.g., `/api/cron/...`)
38
+ 2. **Schedule uses standard cron syntax** — five-field format: `minute hour day-of-month month day-of-week`
39
+ 3. **Verify the request origin** — always check the `Authorization` header matches `CRON_SECRET`:
40
+
41
+ ```ts
42
+ // app/api/cron/route.ts
43
+ export async function GET(request: Request) {
44
+ const authHeader = request.headers.get("authorization");
45
+ if (authHeader !== `Bearer ${process.env.CRON_SECRET}`) {
46
+ return new Response("Unauthorized", { status: 401 });
47
+ }
48
+ // ... your scheduled logic
49
+ return Response.json({ ok: true });
50
+ }
51
+ ```
52
+
53
+ 4. **Hobby plan limits** — max 2 cron jobs, minimum interval of once per day
54
+ 5. **Pro plan** — up to 40 cron jobs, minimum interval of once per minute
55
+ 6. **Max duration** — cron-triggered functions follow normal function duration limits
56
+
57
+ ## Common Patterns
58
+
59
+ - **Daily digest**: `"0 8 * * *"` (8:00 AM UTC daily)
60
+ - **Every hour**: `"0 * * * *"`
61
+ - **Every 5 minutes** (Pro): `"*/5 * * * *"`
62
+ - **Weekdays only**: `"0 9 * * 1-5"`
63
+
64
+ ## Debugging
65
+
66
+ - Check deployment logs for cron execution results
67
+ - Use `vercel logs --follow` to watch cron invocations in real time
68
+ - Cron jobs only run on production deployments, not preview deployments
69
+
70
+ ## References
71
+
72
+ - [Cron Jobs documentation](https://vercel.com/docs/cron-jobs)