@jetrabbits/agentic 0.0.1

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 (440) hide show
  1. package/AGENTS.md +143 -0
  2. package/README.md +154 -0
  3. package/agentic +1615 -0
  4. package/areas/devops/ci-cd/AGENTS.md +48 -0
  5. package/areas/devops/ci-cd/PROMPTS.md +7 -0
  6. package/areas/devops/ci-cd/prompts/onboard-repo.md +97 -0
  7. package/areas/devops/ci-cd/prompts/pipeline-debug.md +103 -0
  8. package/areas/devops/ci-cd/prompts/release-pipeline.md +115 -0
  9. package/areas/devops/ci-cd/rules/pipeline-standards.md +33 -0
  10. package/areas/devops/ci-cd/rules/quality-gates.md +24 -0
  11. package/areas/devops/ci-cd/rules/supply-chain-security.md +34 -0
  12. package/areas/devops/ci-cd/skills/artifact-management/SKILL.md +157 -0
  13. package/areas/devops/ci-cd/skills/build-optimization/SKILL.md +168 -0
  14. package/areas/devops/ci-cd/skills/github-actions-patterns/SKILL.md +190 -0
  15. package/areas/devops/ci-cd/skills/gitlab-ci-patterns/SKILL.md +169 -0
  16. package/areas/devops/ci-cd/skills/pipeline-security/SKILL.md +161 -0
  17. package/areas/devops/ci-cd/workflows/onboard-repo.md +73 -0
  18. package/areas/devops/ci-cd/workflows/pipeline-debug.md +66 -0
  19. package/areas/devops/ci-cd/workflows/release-pipeline.md +115 -0
  20. package/areas/devops/database-ops/AGENTS.md +47 -0
  21. package/areas/devops/database-ops/prompts/backup-verify.md +83 -0
  22. package/areas/devops/database-ops/prompts/db-incident.md +127 -0
  23. package/areas/devops/database-ops/rules/access-control.md +20 -0
  24. package/areas/devops/database-ops/rules/backup-policy.md +33 -0
  25. package/areas/devops/database-ops/rules/migration-runbook.md +32 -0
  26. package/areas/devops/database-ops/skills/backup-restore/SKILL.md +226 -0
  27. package/areas/devops/database-ops/skills/db-performance/SKILL.md +205 -0
  28. package/areas/devops/database-ops/skills/migration-safety/SKILL.md +155 -0
  29. package/areas/devops/database-ops/skills/postgres-operations/SKILL.md +156 -0
  30. package/areas/devops/database-ops/skills/redis-operations/SKILL.md +174 -0
  31. package/areas/devops/database-ops/workflows/backup-verify.md +107 -0
  32. package/areas/devops/database-ops/workflows/db-incident.md +86 -0
  33. package/areas/devops/devsecops/AGENTS.md +47 -0
  34. package/areas/devops/devsecops/prompts/policy-onboard.md +79 -0
  35. package/areas/devops/devsecops/prompts/security-scan-pipeline.md +131 -0
  36. package/areas/devops/devsecops/rules/container-security.md +22 -0
  37. package/areas/devops/devsecops/rules/policy-as-code.md +37 -0
  38. package/areas/devops/devsecops/rules/shift-left-policy.md +26 -0
  39. package/areas/devops/devsecops/skills/container-hardening/SKILL.md +146 -0
  40. package/areas/devops/devsecops/skills/opa-policies/SKILL.md +188 -0
  41. package/areas/devops/devsecops/skills/sbom-supply-chain/SKILL.md +165 -0
  42. package/areas/devops/devsecops/skills/secret-detection/SKILL.md +190 -0
  43. package/areas/devops/devsecops/skills/sigstore-signing/SKILL.md +184 -0
  44. package/areas/devops/devsecops/workflows/policy-onboard.md +104 -0
  45. package/areas/devops/devsecops/workflows/security-scan-pipeline.md +155 -0
  46. package/areas/devops/infrastructure/AGENTS.md +50 -0
  47. package/areas/devops/infrastructure/prompts/destroy-environment.md +81 -0
  48. package/areas/devops/infrastructure/prompts/drift-remediation.md +71 -0
  49. package/areas/devops/infrastructure/prompts/module-development.md +69 -0
  50. package/areas/devops/infrastructure/prompts/provision-environment.md +121 -0
  51. package/areas/devops/infrastructure/rules/iac-standards.md +80 -0
  52. package/areas/devops/infrastructure/rules/immutability.md +28 -0
  53. package/areas/devops/infrastructure/rules/secret-hygiene.md +53 -0
  54. package/areas/devops/infrastructure/rules/state-management.md +47 -0
  55. package/areas/devops/infrastructure/skills/ansible-playbooks/SKILL.md +174 -0
  56. package/areas/devops/infrastructure/skills/cost-optimization/SKILL.md +177 -0
  57. package/areas/devops/infrastructure/skills/drift-detection/SKILL.md +178 -0
  58. package/areas/devops/infrastructure/skills/state-management/SKILL.md +159 -0
  59. package/areas/devops/infrastructure/skills/terraform-modules/SKILL.md +169 -0
  60. package/areas/devops/infrastructure/workflows/destroy-environment.md +96 -0
  61. package/areas/devops/infrastructure/workflows/drift-remediation.md +66 -0
  62. package/areas/devops/infrastructure/workflows/module-development.md +101 -0
  63. package/areas/devops/infrastructure/workflows/provision-environment.md +96 -0
  64. package/areas/devops/kubernetes/AGENTS.md +57 -0
  65. package/areas/devops/kubernetes/PROMPTS.md +9 -0
  66. package/areas/devops/kubernetes/prompts/cluster-bootstrap.md +67 -0
  67. package/areas/devops/kubernetes/prompts/debug-workload.md +91 -0
  68. package/areas/devops/kubernetes/prompts/onboard-service.md +101 -0
  69. package/areas/devops/kubernetes/prompts/upgrade-cluster.md +63 -0
  70. package/areas/devops/kubernetes/rules/cluster-standards.md +51 -0
  71. package/areas/devops/kubernetes/rules/resource-governance.md +80 -0
  72. package/areas/devops/kubernetes/rules/upgrade-policy.md +52 -0
  73. package/areas/devops/kubernetes/rules/workload-security.md +64 -0
  74. package/areas/devops/kubernetes/skills/cluster-operations/SKILL.md +136 -0
  75. package/areas/devops/kubernetes/skills/helm-charts/SKILL.md +152 -0
  76. package/areas/devops/kubernetes/skills/network-policies/SKILL.md +169 -0
  77. package/areas/devops/kubernetes/skills/pod-troubleshooting/SKILL.md +129 -0
  78. package/areas/devops/kubernetes/skills/rbac-design/SKILL.md +148 -0
  79. package/areas/devops/kubernetes/skills/resource-tuning/SKILL.md +156 -0
  80. package/areas/devops/kubernetes/workflows/cluster-bootstrap.md +194 -0
  81. package/areas/devops/kubernetes/workflows/debug-workload.md +108 -0
  82. package/areas/devops/kubernetes/workflows/onboard-service.md +124 -0
  83. package/areas/devops/kubernetes/workflows/upgrade-cluster.md +165 -0
  84. package/areas/devops/networking/AGENTS.md +47 -0
  85. package/areas/devops/networking/prompts/onboard-ingress.md +119 -0
  86. package/areas/devops/networking/prompts/service-mesh-onboard.md +77 -0
  87. package/areas/devops/networking/rules/ingress-standards.md +17 -0
  88. package/areas/devops/networking/rules/network-segmentation.md +24 -0
  89. package/areas/devops/networking/rules/tls-policy.md +32 -0
  90. package/areas/devops/networking/skills/dns-management/SKILL.md +169 -0
  91. package/areas/devops/networking/skills/ingress-patterns/SKILL.md +165 -0
  92. package/areas/devops/networking/skills/service-mesh/SKILL.md +206 -0
  93. package/areas/devops/networking/skills/tls-termination/SKILL.md +198 -0
  94. package/areas/devops/networking/skills/vpc-design/SKILL.md +132 -0
  95. package/areas/devops/networking/workflows/onboard-ingress.md +64 -0
  96. package/areas/devops/networking/workflows/service-mesh-onboard.md +122 -0
  97. package/areas/devops/observability/AGENTS.md +48 -0
  98. package/areas/devops/observability/prompts/alert-investigation.md +117 -0
  99. package/areas/devops/observability/prompts/observability-stack-setup.md +99 -0
  100. package/areas/devops/observability/prompts/onboard-service-monitoring.md +79 -0
  101. package/areas/devops/observability/rules/alerting-standards.md +36 -0
  102. package/areas/devops/observability/rules/data-retention.md +19 -0
  103. package/areas/devops/observability/rules/golden-signals.md +28 -0
  104. package/areas/devops/observability/skills/distributed-tracing/SKILL.md +149 -0
  105. package/areas/devops/observability/skills/grafana-dashboards/SKILL.md +201 -0
  106. package/areas/devops/observability/skills/log-aggregation/SKILL.md +159 -0
  107. package/areas/devops/observability/skills/prometheus-alertmanager/SKILL.md +188 -0
  108. package/areas/devops/observability/skills/slo-implementation/SKILL.md +189 -0
  109. package/areas/devops/observability/workflows/alert-investigation.md +98 -0
  110. package/areas/devops/observability/workflows/observability-stack-setup.md +156 -0
  111. package/areas/devops/observability/workflows/onboard-service-monitoring.md +83 -0
  112. package/areas/devops/sre/AGENTS.md +48 -0
  113. package/areas/devops/sre/prompts/incident-response.md +129 -0
  114. package/areas/devops/sre/prompts/postmortem.md +101 -0
  115. package/areas/devops/sre/prompts/slo-review.md +125 -0
  116. package/areas/devops/sre/rules/error-budget-policy.md +25 -0
  117. package/areas/devops/sre/rules/on-call-standards.md +25 -0
  118. package/areas/devops/sre/rules/slo-policy.md +31 -0
  119. package/areas/devops/sre/skills/capacity-planning/SKILL.md +162 -0
  120. package/areas/devops/sre/skills/chaos-engineering/SKILL.md +186 -0
  121. package/areas/devops/sre/skills/incident-command/SKILL.md +119 -0
  122. package/areas/devops/sre/skills/postmortem-analysis/SKILL.md +104 -0
  123. package/areas/devops/sre/skills/slo-sli-design/SKILL.md +145 -0
  124. package/areas/devops/sre/workflows/incident-response.md +66 -0
  125. package/areas/devops/sre/workflows/postmortem.md +90 -0
  126. package/areas/devops/sre/workflows/slo-review.md +95 -0
  127. package/areas/software/backend/AGENTS.md +59 -0
  128. package/areas/software/backend/PROMPTS.md +50 -0
  129. package/areas/software/backend/README.md +48 -0
  130. package/areas/software/backend/prompts/add-migration.md +93 -0
  131. package/areas/software/backend/prompts/create-endpoint.md +97 -0
  132. package/areas/software/backend/prompts/debug-issue.md +87 -0
  133. package/areas/software/backend/prompts/develop-epic.md +83 -0
  134. package/areas/software/backend/prompts/develop-feature.md +91 -0
  135. package/areas/software/backend/prompts/refactor-module.md +79 -0
  136. package/areas/software/backend/prompts/test-feature.md +89 -0
  137. package/areas/software/backend/rules/architecture.md +20 -0
  138. package/areas/software/backend/rules/data_access.md +20 -0
  139. package/areas/software/backend/rules/security.md +20 -0
  140. package/areas/software/backend/rules/testing.md +19 -0
  141. package/areas/software/backend/skills/api-design/SKILL.md +170 -0
  142. package/areas/software/backend/skills/async-processing/SKILL.md +152 -0
  143. package/areas/software/backend/skills/database-modeling/SKILL.md +173 -0
  144. package/areas/software/backend/skills/observability/SKILL.md +162 -0
  145. package/areas/software/backend/skills/troubleshooting/SKILL.md +139 -0
  146. package/areas/software/backend/workflows/add-migration.md +79 -0
  147. package/areas/software/backend/workflows/create-endpoint.md +89 -0
  148. package/areas/software/backend/workflows/debug-issue.md +77 -0
  149. package/areas/software/backend/workflows/develop-epic.md +78 -0
  150. package/areas/software/backend/workflows/develop-feature.md +98 -0
  151. package/areas/software/backend/workflows/refactor-module.md +73 -0
  152. package/areas/software/backend/workflows/test-feature.md +67 -0
  153. package/areas/software/data-engineering/AGENTS.md +59 -0
  154. package/areas/software/data-engineering/PROMPTS.md +32 -0
  155. package/areas/software/data-engineering/prompts/backfill-data.md +107 -0
  156. package/areas/software/data-engineering/prompts/data-quality-incident.md +109 -0
  157. package/areas/software/data-engineering/prompts/lineage-trace.md +121 -0
  158. package/areas/software/data-engineering/prompts/new-model.md +117 -0
  159. package/areas/software/data-engineering/prompts/schema-migration.md +111 -0
  160. package/areas/software/data-engineering/rules/data-governance.md +11 -0
  161. package/areas/software/data-engineering/rules/pii-handling.md +19 -0
  162. package/areas/software/data-engineering/rules/pipeline-integrity.md +11 -0
  163. package/areas/software/data-engineering/rules/schema-management.md +21 -0
  164. package/areas/software/data-engineering/skills/data-modeling/SKILL.md +49 -0
  165. package/areas/software/data-engineering/skills/dbt-patterns/SKILL.md +43 -0
  166. package/areas/software/data-engineering/skills/lineage-governance/SKILL.md +38 -0
  167. package/areas/software/data-engineering/skills/orchestration/SKILL.md +35 -0
  168. package/areas/software/data-engineering/skills/quality-checks/SKILL.md +50 -0
  169. package/areas/software/data-engineering/skills/sql-optimization/SKILL.md +47 -0
  170. package/areas/software/data-engineering/skills/streaming-patterns/SKILL.md +48 -0
  171. package/areas/software/data-engineering/workflows/backfill-data.md +59 -0
  172. package/areas/software/data-engineering/workflows/data-quality-incident.md +64 -0
  173. package/areas/software/data-engineering/workflows/lineage-trace.md +56 -0
  174. package/areas/software/data-engineering/workflows/new-model.md +71 -0
  175. package/areas/software/data-engineering/workflows/schema-migration.md +67 -0
  176. package/areas/software/frontend/AGENTS.md +60 -0
  177. package/areas/software/frontend/PROMPTS.md +32 -0
  178. package/areas/software/frontend/prompts/a11y-fix.md +75 -0
  179. package/areas/software/frontend/prompts/bundle-analyze.md +75 -0
  180. package/areas/software/frontend/prompts/release-prep.md +83 -0
  181. package/areas/software/frontend/prompts/scaffold-component.md +69 -0
  182. package/areas/software/frontend/prompts/visual-regression.md +73 -0
  183. package/areas/software/frontend/rules/accessibility.md +16 -0
  184. package/areas/software/frontend/rules/architecture.md +29 -0
  185. package/areas/software/frontend/rules/performance.md +23 -0
  186. package/areas/software/frontend/rules/quality.md +12 -0
  187. package/areas/software/frontend/skills/a11y-audit/SKILL.md +61 -0
  188. package/areas/software/frontend/skills/api-integration/SKILL.md +58 -0
  189. package/areas/software/frontend/skills/component-design/SKILL.md +171 -0
  190. package/areas/software/frontend/skills/css-architecture/SKILL.md +146 -0
  191. package/areas/software/frontend/skills/error-handling/SKILL.md +55 -0
  192. package/areas/software/frontend/skills/performance-tuning/SKILL.md +58 -0
  193. package/areas/software/frontend/skills/state-management/SKILL.md +54 -0
  194. package/areas/software/frontend/skills/testing-patterns/SKILL.md +69 -0
  195. package/areas/software/frontend/workflows/a11y-fix.md +63 -0
  196. package/areas/software/frontend/workflows/bundle-analyze.md +56 -0
  197. package/areas/software/frontend/workflows/release-prep.md +66 -0
  198. package/areas/software/frontend/workflows/scaffold-component.md +67 -0
  199. package/areas/software/frontend/workflows/visual-regression.md +65 -0
  200. package/areas/software/full-stack/AGENTS.md +72 -0
  201. package/areas/software/full-stack/PROMPTS.md +66 -0
  202. package/areas/software/full-stack/prompts/backend-project-full-cycle.md +141 -0
  203. package/areas/software/full-stack/prompts/debug-issue.md +115 -0
  204. package/areas/software/full-stack/prompts/develop-feature.md +119 -0
  205. package/areas/software/full-stack/prompts/feature-implementation-flow.md +137 -0
  206. package/areas/software/full-stack/prompts/testing-ci-pipeline.md +119 -0
  207. package/areas/software/full-stack/rules/api-design-guide.md +24 -0
  208. package/areas/software/full-stack/rules/async-concurrency-guide.md +21 -0
  209. package/areas/software/full-stack/rules/backend-architecture-rule.md +41 -0
  210. package/areas/software/full-stack/rules/background-jobs-guide.md +20 -0
  211. package/areas/software/full-stack/rules/code-quality-guide.md +22 -0
  212. package/areas/software/full-stack/rules/database-access-guide.md +24 -0
  213. package/areas/software/full-stack/rules/database-migrations-guide.md +24 -0
  214. package/areas/software/full-stack/rules/domain-models-guide.md +28 -0
  215. package/areas/software/full-stack/rules/e2e-test-guide.md +18 -0
  216. package/areas/software/full-stack/rules/env-settings-guide.md +34 -0
  217. package/areas/software/full-stack/rules/error-handling-guide.md +20 -0
  218. package/areas/software/full-stack/rules/logging-observability-guide.md +22 -0
  219. package/areas/software/full-stack/rules/project-guide.md +34 -0
  220. package/areas/software/full-stack/rules/python-venv-guide.md +23 -0
  221. package/areas/software/full-stack/rules/security-guide.md +22 -0
  222. package/areas/software/full-stack/rules/svt-test-guide.md +17 -0
  223. package/areas/software/full-stack/rules/testing-ci-guide.md +25 -0
  224. package/areas/software/full-stack/skills/api-design-principles/SKILL.md +125 -0
  225. package/areas/software/full-stack/skills/api-design-principles/assets/api-design-checklist.md +155 -0
  226. package/areas/software/full-stack/skills/api-design-principles/assets/rest-api-template.py +182 -0
  227. package/areas/software/full-stack/skills/api-design-principles/references/graphql-schema-design.md +583 -0
  228. package/areas/software/full-stack/skills/api-design-principles/references/rest-best-practices.md +408 -0
  229. package/areas/software/full-stack/skills/api-design-principles/resources/implementation-playbook.md +513 -0
  230. package/areas/software/full-stack/skills/api-patterns/SKILL.md +81 -0
  231. package/areas/software/full-stack/skills/api-patterns/api-style.md +42 -0
  232. package/areas/software/full-stack/skills/api-patterns/auth.md +24 -0
  233. package/areas/software/full-stack/skills/api-patterns/documentation.md +26 -0
  234. package/areas/software/full-stack/skills/api-patterns/graphql.md +41 -0
  235. package/areas/software/full-stack/skills/api-patterns/rate-limiting.md +31 -0
  236. package/areas/software/full-stack/skills/api-patterns/response.md +37 -0
  237. package/areas/software/full-stack/skills/api-patterns/rest.md +40 -0
  238. package/areas/software/full-stack/skills/api-patterns/scripts/api_validator.py +211 -0
  239. package/areas/software/full-stack/skills/api-patterns/security-testing.md +122 -0
  240. package/areas/software/full-stack/skills/api-patterns/trpc.md +41 -0
  241. package/areas/software/full-stack/skills/api-patterns/versioning.md +22 -0
  242. package/areas/software/full-stack/skills/app-builder/SKILL.md +135 -0
  243. package/areas/software/full-stack/skills/app-builder/agent-coordination.md +71 -0
  244. package/areas/software/full-stack/skills/app-builder/feature-building.md +53 -0
  245. package/areas/software/full-stack/skills/app-builder/project-detection.md +34 -0
  246. package/areas/software/full-stack/skills/app-builder/scaffolding.md +118 -0
  247. package/areas/software/full-stack/skills/app-builder/tech-stack.md +40 -0
  248. package/areas/software/full-stack/skills/app-builder/templates/SKILL.md +39 -0
  249. package/areas/software/full-stack/skills/app-builder/templates/astro-static/TEMPLATE.md +76 -0
  250. package/areas/software/full-stack/skills/app-builder/templates/chrome-extension/TEMPLATE.md +92 -0
  251. package/areas/software/full-stack/skills/app-builder/templates/cli-tool/TEMPLATE.md +88 -0
  252. package/areas/software/full-stack/skills/app-builder/templates/electron-desktop/TEMPLATE.md +88 -0
  253. package/areas/software/full-stack/skills/app-builder/templates/express-api/TEMPLATE.md +83 -0
  254. package/areas/software/full-stack/skills/app-builder/templates/flutter-app/TEMPLATE.md +90 -0
  255. package/areas/software/full-stack/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md +90 -0
  256. package/areas/software/full-stack/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +82 -0
  257. package/areas/software/full-stack/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +100 -0
  258. package/areas/software/full-stack/skills/app-builder/templates/nextjs-static/TEMPLATE.md +106 -0
  259. package/areas/software/full-stack/skills/app-builder/templates/nuxt-app/TEMPLATE.md +101 -0
  260. package/areas/software/full-stack/skills/app-builder/templates/python-fastapi/TEMPLATE.md +83 -0
  261. package/areas/software/full-stack/skills/app-builder/templates/react-native-app/TEMPLATE.md +93 -0
  262. package/areas/software/full-stack/skills/backend-developer/SKILL.md +58 -0
  263. package/areas/software/full-stack/skills/bash-pro/SKILL.md +310 -0
  264. package/areas/software/full-stack/skills/blackbox-test/SKILL.md +84 -0
  265. package/areas/software/full-stack/skills/prompt-project-planner/SKILL.md +130 -0
  266. package/areas/software/full-stack/skills/prompt-project-planner/output.schema.md +68 -0
  267. package/areas/software/full-stack/skills/prompt-project-planner/questions.md +80 -0
  268. package/areas/software/full-stack/skills/python-pro/SKILL.md +158 -0
  269. package/areas/software/full-stack/skills/skill-creator/LICENSE.txt +202 -0
  270. package/areas/software/full-stack/skills/skill-creator/SKILL.md +356 -0
  271. package/areas/software/full-stack/skills/skill-creator/references/output-patterns.md +82 -0
  272. package/areas/software/full-stack/skills/skill-creator/references/workflows.md +28 -0
  273. package/areas/software/full-stack/skills/skill-creator/scripts/init_skill.py +303 -0
  274. package/areas/software/full-stack/skills/skill-creator/scripts/package_skill.py +110 -0
  275. package/areas/software/full-stack/skills/skill-creator/scripts/quick_validate.py +95 -0
  276. package/areas/software/full-stack/workflows/backend-project-full-cycle.md +132 -0
  277. package/areas/software/full-stack/workflows/debug-issue.md +70 -0
  278. package/areas/software/full-stack/workflows/develop-feature.md +85 -0
  279. package/areas/software/full-stack/workflows/feature-implementation-flow.md +78 -0
  280. package/areas/software/full-stack/workflows/testing-ci-pipeline.md +65 -0
  281. package/areas/software/general/AGENTS.md +68 -0
  282. package/areas/software/general/prompts/code-review-workflow.md +87 -0
  283. package/areas/software/general/prompts/development-cycle-workflow.md +83 -0
  284. package/areas/software/general/prompts/project-setup-workflow.md +93 -0
  285. package/areas/software/general/rules/code-style-guide.md +31 -0
  286. package/areas/software/general/rules/docker-compose-guide.md +27 -0
  287. package/areas/software/general/rules/git-workflow-guide.md +27 -0
  288. package/areas/software/general/rules/github-workflow-guide.md +27 -0
  289. package/areas/software/general/rules/gitlab-ci-guide.md +27 -0
  290. package/areas/software/general/rules/lint-format-guide.md +29 -0
  291. package/areas/software/general/rules/makefile-guide.md +34 -0
  292. package/areas/software/general/rules/readme-sync-guide.md +40 -0
  293. package/areas/software/general/rules/sdlc-methodology-guide.md +27 -0
  294. package/areas/software/general/rules/sdlc-role-responsibilities.md +108 -0
  295. package/areas/software/general/skills/general-dev-tools/SKILL.md +324 -0
  296. package/areas/software/general/workflows/code-review-workflow.md +84 -0
  297. package/areas/software/general/workflows/development-cycle-workflow.md +85 -0
  298. package/areas/software/general/workflows/project-setup-workflow.md +94 -0
  299. package/areas/software/mlops/AGENTS.md +57 -0
  300. package/areas/software/mlops/PROMPTS.md +32 -0
  301. package/areas/software/mlops/prompts/champion-challenger.md +87 -0
  302. package/areas/software/mlops/prompts/deploy-endpoint.md +91 -0
  303. package/areas/software/mlops/prompts/evaluate-model.md +87 -0
  304. package/areas/software/mlops/prompts/model-incident.md +87 -0
  305. package/areas/software/mlops/prompts/train-experiment.md +83 -0
  306. package/areas/software/mlops/rules/data-integrity.md +9 -0
  307. package/areas/software/mlops/rules/model-governance.md +9 -0
  308. package/areas/software/mlops/rules/production-safety.md +9 -0
  309. package/areas/software/mlops/rules/reproducibility.md +9 -0
  310. package/areas/software/mlops/skills/experiment-tracking/SKILL.md +29 -0
  311. package/areas/software/mlops/skills/feature-engineering/SKILL.md +44 -0
  312. package/areas/software/mlops/skills/inference-serving/SKILL.md +35 -0
  313. package/areas/software/mlops/skills/model-evaluation/SKILL.md +40 -0
  314. package/areas/software/mlops/skills/model-monitoring/SKILL.md +32 -0
  315. package/areas/software/mlops/workflows/champion-challenger.md +65 -0
  316. package/areas/software/mlops/workflows/deploy-endpoint.md +70 -0
  317. package/areas/software/mlops/workflows/evaluate-model.md +63 -0
  318. package/areas/software/mlops/workflows/model-incident.md +64 -0
  319. package/areas/software/mlops/workflows/train-experiment.md +56 -0
  320. package/areas/software/mobile/AGENTS.md +58 -0
  321. package/areas/software/mobile/PROMPTS.md +32 -0
  322. package/areas/software/mobile/prompts/crash-triage.md +63 -0
  323. package/areas/software/mobile/prompts/device-testing.md +83 -0
  324. package/areas/software/mobile/prompts/ota-update.md +75 -0
  325. package/areas/software/mobile/prompts/release-build.md +67 -0
  326. package/areas/software/mobile/prompts/store-submission.md +79 -0
  327. package/areas/software/mobile/rules/offline-first.md +10 -0
  328. package/areas/software/mobile/rules/performance-budget.md +20 -0
  329. package/areas/software/mobile/rules/platform-compliance.md +17 -0
  330. package/areas/software/mobile/rules/security-mobile.md +9 -0
  331. package/areas/software/mobile/skills/app-store-prep/SKILL.md +27 -0
  332. package/areas/software/mobile/skills/mobile-testing/SKILL.md +36 -0
  333. package/areas/software/mobile/skills/native-modules/SKILL.md +38 -0
  334. package/areas/software/mobile/skills/navigation-patterns/SKILL.md +49 -0
  335. package/areas/software/mobile/skills/push-notifications/SKILL.md +40 -0
  336. package/areas/software/mobile/skills/state-sync/SKILL.md +48 -0
  337. package/areas/software/mobile/workflows/crash-triage.md +63 -0
  338. package/areas/software/mobile/workflows/device-testing.md +54 -0
  339. package/areas/software/mobile/workflows/ota-update.md +54 -0
  340. package/areas/software/mobile/workflows/release-build.md +67 -0
  341. package/areas/software/mobile/workflows/store-submission.md +63 -0
  342. package/areas/software/platform/AGENTS.md +67 -0
  343. package/areas/software/platform/PROMPTS.md +32 -0
  344. package/areas/software/platform/prompts/cost-audit.md +117 -0
  345. package/areas/software/platform/prompts/deploy-production.md +109 -0
  346. package/areas/software/platform/prompts/drift-check.md +107 -0
  347. package/areas/software/platform/prompts/incident-response.md +121 -0
  348. package/areas/software/platform/prompts/provision-env.md +113 -0
  349. package/areas/software/platform/rules/cost-governance.md +11 -0
  350. package/areas/software/platform/rules/immutability.md +17 -0
  351. package/areas/software/platform/rules/reliability.md +19 -0
  352. package/areas/software/platform/rules/security-posture.md +12 -0
  353. package/areas/software/platform/skills/ci-cd-pipelines/SKILL.md +58 -0
  354. package/areas/software/platform/skills/incident-response/SKILL.md +41 -0
  355. package/areas/software/platform/skills/k8s-manifests/SKILL.md +56 -0
  356. package/areas/software/platform/skills/networking/SKILL.md +44 -0
  357. package/areas/software/platform/skills/observability-setup/SKILL.md +49 -0
  358. package/areas/software/platform/skills/secrets-management/SKILL.md +43 -0
  359. package/areas/software/platform/skills/terraform-patterns/SKILL.md +75 -0
  360. package/areas/software/platform/workflows/cost-audit.md +61 -0
  361. package/areas/software/platform/workflows/deploy-production.md +67 -0
  362. package/areas/software/platform/workflows/drift-check.md +61 -0
  363. package/areas/software/platform/workflows/incident-response.md +69 -0
  364. package/areas/software/platform/workflows/provision-env.md +77 -0
  365. package/areas/software/qa/AGENTS.md +58 -0
  366. package/areas/software/qa/PROMPTS.md +32 -0
  367. package/areas/software/qa/prompts/flakiness-investigation.md +61 -0
  368. package/areas/software/qa/prompts/performance-audit.md +65 -0
  369. package/areas/software/qa/prompts/regression-suite.md +61 -0
  370. package/areas/software/qa/prompts/smoke-test.md +65 -0
  371. package/areas/software/qa/prompts/test-coverage-report.md +61 -0
  372. package/areas/software/qa/rules/flakiness-policy.md +12 -0
  373. package/areas/software/qa/rules/quality-gates.md +28 -0
  374. package/areas/software/qa/rules/test-data.md +9 -0
  375. package/areas/software/qa/rules/test-strategy.md +11 -0
  376. package/areas/software/qa/skills/accessibility-testing/SKILL.md +139 -0
  377. package/areas/software/qa/skills/api-testing/SKILL.md +140 -0
  378. package/areas/software/qa/skills/e2e-patterns/SKILL.md +152 -0
  379. package/areas/software/qa/skills/performance-testing/SKILL.md +177 -0
  380. package/areas/software/qa/skills/test-data-management/SKILL.md +161 -0
  381. package/areas/software/qa/skills/test-pyramid/SKILL.md +127 -0
  382. package/areas/software/qa/workflows/flakiness-investigation.md +63 -0
  383. package/areas/software/qa/workflows/performance-audit.md +59 -0
  384. package/areas/software/qa/workflows/regression-suite.md +59 -0
  385. package/areas/software/qa/workflows/smoke-test.md +64 -0
  386. package/areas/software/qa/workflows/test-coverage-report.md +57 -0
  387. package/areas/software/security/AGENTS.md +58 -0
  388. package/areas/software/security/PROMPTS.md +32 -0
  389. package/areas/software/security/prompts/compliance-report.md +113 -0
  390. package/areas/software/security/prompts/pen-test-sim.md +113 -0
  391. package/areas/software/security/prompts/secret-rotation.md +115 -0
  392. package/areas/software/security/prompts/security-scan.md +91 -0
  393. package/areas/software/security/prompts/threat-model-review.md +105 -0
  394. package/areas/software/security/rules/compliance-baseline.md +23 -0
  395. package/areas/software/security/rules/dependency-policy.md +12 -0
  396. package/areas/software/security/rules/secrets-policy.md +22 -0
  397. package/areas/software/security/rules/secure-coding.md +22 -0
  398. package/areas/software/security/skills/auth-patterns/SKILL.md +42 -0
  399. package/areas/software/security/skills/crypto-standards/SKILL.md +42 -0
  400. package/areas/software/security/skills/dependency-audit/SKILL.md +29 -0
  401. package/areas/software/security/skills/sast-dast-interpretation/SKILL.md +33 -0
  402. package/areas/software/security/skills/security-headers/SKILL.md +29 -0
  403. package/areas/software/security/skills/threat-modeling/SKILL.md +36 -0
  404. package/areas/software/security/workflows/compliance-report.md +57 -0
  405. package/areas/software/security/workflows/pen-test-sim.md +63 -0
  406. package/areas/software/security/workflows/secret-rotation.md +67 -0
  407. package/areas/software/security/workflows/security-scan.md +64 -0
  408. package/areas/software/security/workflows/threat-model-review.md +62 -0
  409. package/areas/template/AGENTS-area.tmpl.md +61 -0
  410. package/areas/template/AGENTS.tmpl.md +67 -0
  411. package/areas/template/GUIDE.md +102 -0
  412. package/areas/template/PROMPTS.tmpl.md +29 -0
  413. package/areas/template/README.md +57 -0
  414. package/areas/template/README.tmpl.md +51 -0
  415. package/areas/template/prompt.tmpl.md +101 -0
  416. package/areas/template/rule.tmpl.md +71 -0
  417. package/areas/template/skill.tmpl.md +108 -0
  418. package/areas/template/workflow.tmpl.md +104 -0
  419. package/bin/agentic.js +24 -0
  420. package/extensions/antigravity/GEMINI.md +10 -0
  421. package/extensions/claude/CLAUDE.md +10 -0
  422. package/extensions/codex/AGENTS.override.md +93 -0
  423. package/extensions/gemini/GEMINI.md +10 -0
  424. package/extensions/opencode/agents/designer.md +65 -0
  425. package/extensions/opencode/agents/developer.md +63 -0
  426. package/extensions/opencode/agents/devops-engineer.md +69 -0
  427. package/extensions/opencode/agents/pm.md +61 -0
  428. package/extensions/opencode/agents/product-owner.md +76 -0
  429. package/extensions/opencode/agents/qa.md +66 -0
  430. package/extensions/opencode/agents/team-lead.md +67 -0
  431. package/extensions/opencode/commands/feature.md +75 -0
  432. package/extensions/opencode/opencode.json +93 -0
  433. package/extensions/opencode/plugins/model-checker.json +14 -0
  434. package/extensions/opencode/plugins/model-checker.ts +279 -0
  435. package/extensions/opencode/plugins/sound-notification.ts +13 -0
  436. package/extensions/opencode/plugins/telegram-notification.ts +86 -0
  437. package/extensions/opencode/skills/code_review_expert/SKILL.md +144 -0
  438. package/extensions/opencode/skills/design_expert/SKILL.md +42 -0
  439. package/extensions/opencode/skills/qa_expert/SKILL.md +116 -0
  440. package/package.json +19 -0
@@ -0,0 +1,84 @@
1
+ ---
2
+ name: code-review-workflow
3
+ type: workflow
4
+ trigger: /code-review-workflow
5
+ description: Conduct a structured, constructive code review of a pull or merge request.
6
+ inputs:
7
+ - pull_request_or_merge_request
8
+ - codebase_context
9
+ outputs:
10
+ - review_comments
11
+ - approval_or_change_requests
12
+ roles:
13
+ - team-lead
14
+ - developer
15
+ - qa
16
+ execution:
17
+ initiator: developer
18
+ related-rules:
19
+ - code-style-guide.md
20
+ - git-workflow-guide.md
21
+ - sdlc-methodology-guide.md
22
+ uses-skills:
23
+ - general-dev-tools
24
+ quality-gates:
25
+ - CI pipeline passes before manual review begins
26
+ - all blocking comments resolved before approval
27
+ - no secrets or credentials in diff
28
+ ---
29
+
30
+ ## Steps
31
+
32
+ ### 1. Automated Pre-check — `@developer` (author)
33
+ - **Input:** feature branch with changes
34
+ - **Actions:** confirm CI passes (lint / tests / build); no merge conflicts; branch up to date with target
35
+ - **Output:** CI-green PR
36
+ - **Done when:** automated checks pass — only then request review
37
+
38
+ ### 2. Context Understanding — `@team-lead`
39
+ - **Input:** PR description and linked issue/task
40
+ - **Actions:** read PR description and linked ticket; check scope focus; if diff > 400 lines of logic — request splitting the PR
41
+ - **Output:** decision to proceed or split
42
+ - **Done when:** reviewer understands the intent and scope is acceptable
43
+
44
+ ### 3. Code Review — `@team-lead` + `@qa`
45
+ - **Input:** PR diff + context
46
+ - **Actions — Correctness:**
47
+ - Does the code do what the ticket describes?
48
+ - Are edge cases and error paths handled?
49
+ - **Actions — Design & Architecture:**
50
+ - Does the change follow existing codebase patterns?
51
+ - No unnecessary complexity or over-engineering?
52
+ - Abstractions at the right level?
53
+ - **Actions — Code Quality:**
54
+ - Names are clear and intention-revealing?
55
+ - No duplicated logic that could be extracted?
56
+ - No magic numbers or strings?
57
+ - **Actions — Tests:**
58
+ - New behaviors covered by tests?
59
+ - Tests assert meaningful behavior, not implementation details?
60
+ - Edge cases tested?
61
+ - **Actions — Security:**
62
+ - No secrets or credentials committed
63
+ - User input validated/sanitized
64
+ - Permissions and access control respected
65
+ - **Output:** review comments with blocking / non-blocking labels; at least one positive comment
66
+ - **Done when:** all review dimensions checked
67
+
68
+ ### 4. Feedback Resolution — `@developer`
69
+ - **Input:** review comments
70
+ - **Actions:** address all blocking comments; push fixes as new commits (no force-push during review); re-request review
71
+ - **Output:** updated PR
72
+ - **Done when:** no open blocking comments
73
+
74
+ ### 5. Approval & Merge — `@team-lead`
75
+ - **Input:** resolved PR
76
+ - **Actions:** re-check fixes; approve; author squashes or rebases per project convention; merge; delete feature branch
77
+ - **Output:** merged PR; branch deleted
78
+ - **Done when:** change merged and feature branch removed
79
+
80
+ ## Iteration Loop
81
+ If fixes introduce new issues → reviewer re-raises blocking comments; loop repeats until clean.
82
+
83
+ ## Exit
84
+ Approved and merged PR = review complete.
@@ -0,0 +1,85 @@
1
+ ---
2
+ name: development-cycle-workflow
3
+ type: workflow
4
+ trigger: /development-cycle-workflow
5
+ description: Implement any development task from ticket to merged code.
6
+ inputs:
7
+ - task_or_issue_description
8
+ - existing_codebase
9
+ outputs:
10
+ - implemented_changes
11
+ - passing_tests
12
+ - merged_pull_request
13
+ roles:
14
+ - product-owner
15
+ - pm
16
+ - team-lead
17
+ - developer
18
+ - qa
19
+ execution:
20
+ initiator: product-owner
21
+ related-rules:
22
+ - git-workflow-guide.md
23
+ - sdlc-methodology-guide.md
24
+ - code-style-guide.md
25
+ - lint-format-guide.md
26
+ uses-skills:
27
+ - general-dev-tools
28
+ quality-gates:
29
+ - acceptance criteria confirmed before implementation starts
30
+ - all checks pass (lint / test / build)
31
+ - PR reviewed and approved
32
+ ---
33
+
34
+ ## Steps
35
+
36
+ ### 1. Requirements Framing — `@product-owner` + `@pm`
37
+ - **Input:** task or issue description
38
+ - **Actions:** define acceptance criteria; clarify scope and non-goals; if larger than 1 day of work — break into sub-tasks
39
+ - **Output:** confirmed acceptance criteria added to the ticket
40
+ - **Done when:** criteria are testable and agreed upon
41
+
42
+ ### 2. Technical Design — `@team-lead`
43
+ - **Input:** confirmed acceptance criteria
44
+ - **Actions:** identify impacted code areas; flag architectural risks; approve approach or request changes
45
+ - **Output:** brief design note (inline comment or `docs/<task>/notes.md` for significant changes)
46
+ - **Done when:** implementation approach is unambiguous
47
+
48
+ ### 3. Implementation — `@developer`
49
+ - **Input:** confirmed acceptance criteria + design note
50
+ - **Actions:**
51
+ - pull latest `main`, create branch: `git checkout -b feature/<task-id>-short-desc`
52
+ - implement in small logical commits; follow code style rules
53
+ - run `make fmt` after each logical change
54
+ - do not mix unrelated changes in the same branch
55
+ - **Output:** code changes on feature branch
56
+ - **Done when:** implementation covers all acceptance criteria
57
+
58
+ ### 4. Verification — `@developer` → `@qa`
59
+ - **Input:** code changes on branch
60
+ - **Actions:**
61
+ - `make test` — all tests pass
62
+ - `make lint` — zero errors
63
+ - `make fmt` — no diffs
64
+ - add or update tests for any new behavior
65
+ - `@qa` runs exploratory checks against acceptance criteria
66
+ - **Output:** green local checks; test evidence attached to PR
67
+ - **Done when:** no failing checks; acceptance criteria manually verified
68
+
69
+ ### 5. Pull Request — `@developer`
70
+ - **Input:** green checks, test evidence
71
+ - **Actions:** open PR with title `[TASK-ID] Short description`; body includes what changed, why, how to test, screenshots if UI; assign reviewer; CI must pass before review
72
+ - **Output:** open PR with passing CI
73
+ - **Done when:** PR is open and CI is green
74
+
75
+ ### 6. Review & Merge — `@team-lead` (coordinated by `@pm`)
76
+ - **Input:** open PR
77
+ - **Actions:** `@team-lead` reviews code quality, architecture, and tests; `@developer` addresses all blocking comments; squash or rebase per project convention; merge; delete feature branch
78
+ - **Output:** merged PR; feature branch deleted
79
+ - **Done when:** PR is merged and change is verified in staging/preview
80
+
81
+ ## Iteration Loop
82
+ If verification (Step 4) or review (Step 6) reveals gaps → return to Step 3. `@pm` tracks blockers and timeline.
83
+
84
+ ## Exit
85
+ Merged PR + acceptance criteria validated in staging = task complete.
@@ -0,0 +1,94 @@
1
+ ---
2
+ name: project-setup-workflow
3
+ type: workflow
4
+ trigger: /project-setup-workflow
5
+ description: Bootstrap a new software project with tooling, CI, and documentation from day one.
6
+ inputs:
7
+ - project_name
8
+ - language_or_framework
9
+ - target_platform
10
+ outputs:
11
+ - initialized_repository
12
+ - ci_pipeline_configured
13
+ - readme_and_docs
14
+ roles:
15
+ - product-owner
16
+ - pm
17
+ - team-lead
18
+ - developer
19
+ - qa
20
+ execution:
21
+ initiator: product-owner
22
+ related-rules:
23
+ - git-workflow-guide.md
24
+ - makefile-guide.md
25
+ - docker-compose-guide.md
26
+ - lint-format-guide.md
27
+ uses-skills:
28
+ - general-dev-tools
29
+ quality-gates:
30
+ - CI pipeline passes on first commit
31
+ - make install && make dev works on a clean machine
32
+ - pre-commit hooks installed and passing
33
+ ---
34
+
35
+ ## Steps
36
+
37
+ ### 1. Scope & Decisions — `@product-owner` + `@pm`
38
+ - **Input:** project name, purpose, team constraints
39
+ - **Actions:** confirm language/framework/platform; define team conventions (branch model, merge strategy); confirm initial milestone
40
+ - **Output:** brief project charter note (README draft or ADR-0)
41
+ - **Done when:** tech stack and conventions agreed upon
42
+
43
+ ### 2. Repository Setup — `@team-lead` + `@developer`
44
+ - **Input:** project charter note
45
+ - **Actions:**
46
+ - create repo on GitHub/GitLab with meaningful name and description
47
+ - set up branch protection on `main` (require CI + review)
48
+ - add `.gitignore` for the language/framework
49
+ - add `README.md` with: description, prerequisites, quick start (`make install && make dev`), CI badge
50
+ - **Output:** initialized repository with branch protection
51
+ - **Done when:** repo accessible, branch protection active
52
+
53
+ ### 3. Development Environment — `@developer`
54
+ - **Input:** initialized repository
55
+ - **Actions:**
56
+ - create `Makefile` with targets: `install`, `dev`, `test`, `lint`, `fmt`, `clean`, `help`
57
+ - if multi-service: create `docker-compose.yml` with health checks and `.env.example`
58
+ - configure language toolchain (venv, node_modules, go modules, etc.)
59
+ - add `.editorconfig` for consistent whitespace
60
+ - **Output:** working local dev environment
61
+ - **Done when:** `make install && make dev` succeeds on a clean machine
62
+
63
+ ### 4. Code Quality Tooling — `@developer`
64
+ - **Input:** working dev environment
65
+ - **Actions:**
66
+ - add linter config (`.eslintrc`, `pyproject.toml [tool.ruff]`, `.golangci.yml`, etc.)
67
+ - add formatter config (`prettier`, `black`, etc.)
68
+ - configure `pre-commit` with at minimum: trailing-whitespace, end-of-file-fixer, check-yaml
69
+ - run `pre-commit install` and `pre-commit run --all-files` — fix any issues
70
+ - **Output:** linter + formatter + pre-commit hooks configured and passing
71
+ - **Done when:** `make lint` and `make fmt` exit clean on the initial codebase
72
+
73
+ ### 5. CI Pipeline — `@developer` + `@team-lead`
74
+ - **Input:** quality tooling configured
75
+ - **Actions:**
76
+ - create CI config (`.github/workflows/ci.yml` or `.gitlab-ci.yml`)
77
+ - pipeline runs: lint → test → build on every PR
78
+ - set branch protection to require passing CI before merge
79
+ - add CI status badge to README
80
+ - **Output:** CI pipeline running on the repo
81
+ - **Done when:** CI passes on `main`
82
+
83
+ ### 6. First Commit & Validation — `@developer` + `@qa`
84
+ - **Input:** all tooling configured
85
+ - **Actions:**
86
+ - `git add -A && git commit -m "chore: initial project setup"`
87
+ - push and verify CI passes on default branch
88
+ - `@qa` validates: clean install on a second machine, CI badge green, `make test` passes
89
+ - create first `CHANGELOG.md` entry: `## [Unreleased]`
90
+ - **Output:** green CI on first commit; validated by QA
91
+ - **Done when:** CI green, QA confirms setup is reproducible
92
+
93
+ ## Exit
94
+ Green CI + QA sign-off = project is ready for first feature development.
@@ -0,0 +1,57 @@
1
+ # MLOps — guidance index
2
+
3
+ ## What this area covers
4
+
5
+ Machine learning operations: experiment tracking, model training pipelines, feature engineering, model evaluation, champion/challenger workflows, inference serving, model monitoring, and production safety gates. MLOps treats models as software artifacts with the same reproducibility and observability requirements as any production service.
6
+
7
+ ## Guidance chain
8
+
9
+ 1. Project `.agent/` baseline (`AGENTS.md` + `.agent/*`)
10
+ 2. `software/general/rules/*` — always active
11
+ 3. `mlops/rules/*` — load all for this spec
12
+ 4. `mlops/skills/*/SKILL.md` — load only the skill matching the current task
13
+ 5. `mlops/workflows/*` — load the workflow matching the triggered command
14
+
15
+ ## Inherited from general
16
+
17
+ - SDLC methodology and handoff contracts
18
+ - Git / CI / lint and code style baselines
19
+
20
+ ## MLOps-specific constraints
21
+
22
+ - Every experiment is reproducible: fixed random seed, pinned dependency versions, logged hyperparameters.
23
+ - No model promotes to production without a documented evaluation report and a champion/challenger comparison.
24
+ - Production models emit prediction latency, throughput, and data drift metrics — no silent inference.
25
+ - Training data containing PII is governed under `data-engineering/rules/pii-handling.md` at all times.
26
+
27
+ ## Spec map
28
+
29
+ ```text
30
+ mlops/
31
+ ├── rules/
32
+ │ ├── reproducibility.md ← seed pinning, dependency locking, artifact versioning
33
+ │ ├── data-integrity.md ← training data lineage, validation, split discipline
34
+ │ ├── model-governance.md ← approval gates, versioning, rollback policy
35
+ │ └── production-safety.md ← shadow mode, canary traffic, kill switch requirements
36
+ ├── skills/
37
+ │ ├── experiment-tracking/SKILL.md ← MLflow, W&B, run comparison, artifact logging
38
+ │ ├── feature-engineering/SKILL.md ← feature stores, transformation pipelines, leakage prevention
39
+ │ ├── model-evaluation/SKILL.md ← metric selection, fairness checks, threshold calibration
40
+ │ ├── inference-serving/SKILL.md ← online/batch serving, latency budgets, model registries
41
+ │ └── model-monitoring/SKILL.md ← data drift, prediction drift, retraining triggers
42
+ ├── workflows/
43
+ │ ├── train-experiment.md ← /train-experiment
44
+ │ ├── evaluate-model.md ← /evaluate-model
45
+ │ ├── champion-challenger.md ← /champion-challenger
46
+ │ ├── deploy-endpoint.md ← /deploy-endpoint
47
+ │ └── model-incident.md ← /model-incident
48
+ └── prompts/
49
+ └── *.md
50
+ ```
51
+
52
+ ## Discovery patterns
53
+
54
+ - `rules/*.md`
55
+ - `skills/*/SKILL.md`
56
+ - `workflows/*.md`
57
+ - `prompts/*.md`
@@ -0,0 +1,32 @@
1
+ # PROMPTS: mlops
2
+
3
+ Use these prompts with `AGENTS.md` from the same directory.
4
+
5
+ ## 1) Initialize agent behavior
6
+
7
+ ```text
8
+ Read `mlops/AGENTS.md` and adopt its rules, skills loading strategy, and workflows as hard constraints.
9
+ List the active rules and the selected workflow before implementation.
10
+ ```
11
+
12
+ ## 2) Implement a feature
13
+
14
+ ```text
15
+ Using `mlops/AGENTS.md`, implement: <feature description>.
16
+ Before coding: provide architecture notes, risk list, and test plan.
17
+ After coding: run checks and report exact commands and results.
18
+ ```
19
+
20
+ ## 3) Incident / debug mode
21
+
22
+ ```text
23
+ Using `mlops/AGENTS.md`, run incident triage for: <incident summary>.
24
+ Return root cause hypotheses, validation steps, fix plan, and rollback plan.
25
+ ```
26
+
27
+ ## 4) Release readiness
28
+
29
+ ```text
30
+ Using `mlops/AGENTS.md`, prepare release checklist for: <release scope>.
31
+ Include quality gates, security gates, performance gates, and deployment validation.
32
+ ```
@@ -0,0 +1,87 @@
1
+ ---
2
+ workflow: champion-challenger
3
+ ---
4
+
5
+ # Prompt: `/champion-challenger`
6
+
7
+ Use when: running a controlled champion-vs-challenger model experiment with statistical significance and rollback guardrails.
8
+
9
+ ---
10
+
11
+ ## Example 1 — Credit risk model challenger rollout
12
+
13
+ **EN:**
14
+ ```
15
+ /champion-challenger
16
+
17
+ Champion model: credit-risk-xgb-v14 (Production in registry)
18
+ Challenger model: credit-risk-xgb-v15 (candidate from MLflow run 5d8a9f2)
19
+ Experiment duration: 14 days or until 2.5M scored applications
20
+ Primary metric: approved-loan default rate after policy thresholding
21
+ Guardrails:
22
+ - online latency p99 < 180ms
23
+ - application scoring error rate < 0.2%
24
+ - fairness disparity by age_group and region <= 0.08
25
+ Traffic split: 50% champion / 50% challenger by hashed applicant_id
26
+ Decision rules:
27
+ - promote only if default rate improves by at least 1.5% relative and p-value < 0.05
28
+ - auto-rollback if latency or fairness guardrail breaches for 30 min
29
+ Output: experiment design, sample-size calculation, daily monitoring plan, and final promotion decision template
30
+ ```
31
+
32
+ **RU:**
33
+ ```
34
+ /champion-challenger
35
+
36
+ Champion model: credit-risk-xgb-v14 (Production в registry)
37
+ Challenger model: credit-risk-xgb-v15 (кандидат из MLflow run 5d8a9f2)
38
+ Длительность эксперимента: 14 дней или до 2.5M скорингованных заявок
39
+ Основная метрика: default rate по одобренным займам после применения policy threshold
40
+ Guardrails:
41
+ - online latency p99 < 180ms
42
+ - error rate скоринга заявок < 0.2%
43
+ - fairness disparity по age_group и region <= 0.08
44
+ Разделение трафика: 50% champion / 50% challenger по hashed applicant_id
45
+ Правила решения:
46
+ - продвигать только если default rate улучшается минимум на 1.5% относительно и p-value < 0.05
47
+ - auto-rollback если latency или fairness guardrail нарушается 30 минут подряд
48
+ Результат: дизайн эксперимента, расчёт sample size, ежедневный план мониторинга и шаблон финального решения о promotion
49
+ ```
50
+
51
+ ---
52
+
53
+ ## Example 2 — Search ranking experiment with segment safety
54
+
55
+ **EN:**
56
+ ```
57
+ /champion-challenger
58
+
59
+ Champion model: search-ranker-bert-v8
60
+ Challenger model: search-ranker-bert-v9-distilled
61
+ Experiment duration: 7 days during normal traffic period (exclude Black Friday campaign week)
62
+ Primary metric: click-through rate on top-5 search results
63
+ Secondary metrics:
64
+ - add-to-cart rate from search sessions
65
+ - zero-result session rate
66
+ - median inference cost per 1k requests
67
+ Segments that must not regress: mobile web, long-tail queries, German locale
68
+ Rollback policy: if challenger harms any protected segment by > 2% relative CTR for 24h, revert all traffic to champion
69
+ Output: experiment assignment strategy, segment analysis requirements, and final report structure for registry and product stakeholders
70
+ ```
71
+
72
+ **RU:**
73
+ ```
74
+ /champion-challenger
75
+
76
+ Champion model: search-ranker-bert-v8
77
+ Challenger model: search-ranker-bert-v9-distilled
78
+ Длительность эксперимента: 7 дней в период обычного трафика (исключая неделю кампании Black Friday)
79
+ Основная метрика: click-through rate по top-5 результатам поиска
80
+ Вторичные метрики:
81
+ - add-to-cart rate из search sessions
82
+ - zero-result session rate
83
+ - median inference cost на 1k запросов
84
+ Сегменты, которые не должны деградировать: mobile web, long-tail queries, немецкая локаль
85
+ Политика отката: если challenger ухудшает любой защищённый сегмент более чем на 2% относительного CTR в течение 24ч, вернуть весь трафик champion'у
86
+ Результат: стратегия назначения эксперимента, требования к segment analysis и структура финального отчёта для registry и продуктовых стейкхолдеров
87
+ ```
@@ -0,0 +1,91 @@
1
+ ---
2
+ workflow: deploy-endpoint
3
+ ---
4
+
5
+ # Prompt: `/deploy-endpoint`
6
+
7
+ Use when: deploying a model endpoint through shadow, canary, and full rollout with explicit rollback thresholds.
8
+
9
+ ---
10
+
11
+ ## Example 1 — Deploy new fraud model with shadow and canary
12
+
13
+ **EN:**
14
+ ```
15
+ /deploy-endpoint
16
+
17
+ Model name: fraud-detection-xgb
18
+ Run ID: mlflow://fraud-prod/4f2d71b9
19
+ Deployment strategy: shadow -> canary -> full rollout
20
+ Preconditions:
21
+ - /evaluate-model scorecard recommendation = PROMOTE
22
+ - model registry approval recorded by risk lead
23
+ - current production endpoint fraud-score-v12 healthy for last 7 days
24
+ Traffic plan:
25
+ - shadow for 48h with 100% mirrored requests, no user-visible responses from challenger
26
+ - canary 5% -> 20% -> 50% -> 100% if latency p99 < 120ms and error rate < 0.5%
27
+ Monitoring:
28
+ - compare prediction distribution vs champion
29
+ - alert on PSI > 0.2 for any top-10 feature
30
+ - auto-rollback on SLO breach or schema mismatch in payloads
31
+ Output: deployment plan, rollout checkpoints, rollback commands, and post-deploy monitoring checklist
32
+ ```
33
+
34
+ **RU:**
35
+ ```
36
+ /deploy-endpoint
37
+
38
+ Model name: fraud-detection-xgb
39
+ Run ID: mlflow://fraud-prod/4f2d71b9
40
+ Стратегия деплоя: shadow -> canary -> full rollout
41
+ Предусловия:
42
+ - рекомендация в scorecard от /evaluate-model = PROMOTE
43
+ - approval в model registry зафиксирован risk lead
44
+ - текущий production endpoint fraud-score-v12 здоров последние 7 дней
45
+ План трафика:
46
+ - shadow 48ч со 100% зеркалированием запросов, без user-visible ответов от challenger
47
+ - canary 5% -> 20% -> 50% -> 100% если latency p99 < 120ms и error rate < 0.5%
48
+ Мониторинг:
49
+ - сравнивать распределение предсказаний vs champion
50
+ - алерт при PSI > 0.2 для любого из top-10 признаков
51
+ - auto-rollback при нарушении SLO или schema mismatch в payload'ах
52
+ Результат: план деплоя, rollout checkpoints, rollback commands и чеклист post-deploy мониторинга
53
+ ```
54
+
55
+ ---
56
+
57
+ ## Example 2 — Emergency redeploy after endpoint infrastructure drift
58
+
59
+ **EN:**
60
+ ```
61
+ /deploy-endpoint
62
+
63
+ Model name: recommendations-transformer
64
+ Run ID: mlflow://reco-prod/9a17cb21
65
+ Deployment strategy: canary only (skip shadow because the same artifact was already shadow-tested last week)
66
+ Context:
67
+ - current live endpoint lost autoscaling configuration during cluster migration
68
+ - no model change, but serving container and HPA manifests must be re-applied safely
69
+ Success criteria:
70
+ - 100% traffic restored on the same model artifact
71
+ - canary stages complete without error rate increase above 0.2%
72
+ - dashboards updated with new pod labels and endpoint version tags
73
+ Output: infrastructure validation checklist, canary plan, and evidence that registry state still points to the same Production artifact
74
+ ```
75
+
76
+ **RU:**
77
+ ```
78
+ /deploy-endpoint
79
+
80
+ Model name: recommendations-transformer
81
+ Run ID: mlflow://reco-prod/9a17cb21
82
+ Стратегия деплоя: только canary (без shadow, потому что тот же артефакт уже проходил shadow на прошлой неделе)
83
+ Контекст:
84
+ - текущий live endpoint потерял autoscaling configuration во время миграции кластера
85
+ - модель не меняется, но serving container и HPA manifests нужно безопасно применить заново
86
+ Критерии успеха:
87
+ - 100% трафика восстановлено на том же model artifact
88
+ - canary стадии завершаются без роста error rate выше 0.2%
89
+ - dashboards обновлены с новыми pod labels и endpoint version tags
90
+ Результат: чеклист валидации инфраструктуры, canary plan и доказательство, что registry state по-прежнему указывает на тот же Production artifact
91
+ ```
@@ -0,0 +1,87 @@
1
+ ---
2
+ workflow: evaluate-model
3
+ ---
4
+
5
+ # Prompt: `/evaluate-model`
6
+
7
+ Use when: evaluating a trained model against a held-out test set, current champion, and business/fairness constraints before promotion.
8
+
9
+ ---
10
+
11
+ ## Example 1 — Binary classification promotion review
12
+
13
+ **EN:**
14
+ ```
15
+ /evaluate-model
16
+
17
+ Run ID: mlflow://fraud-exp/8124ac91
18
+ Champion reference: fraud-detection-xgb-v12 (Production)
19
+ Model type: binary classification
20
+ Held-out test set: fraud_eval_2026_02_15.parquet (never used in training)
21
+ Required metrics:
22
+ - AUC-ROC, PR-AUC, precision, recall, F1 at operating threshold 0.72
23
+ - confusion matrix for amounts > $500 and <= $500
24
+ Business translation:
25
+ - estimate prevented fraud dollars/month at current traffic
26
+ - estimate false-positive manual review cost increase
27
+ Fairness check required: disparity across customer_region and account_age_bucket
28
+ Decision options: PROMOTE / DO_NOT_PROMOTE / NEEDS_REVIEW
29
+ Output: signed evaluation_scorecard.json + plots + champion comparison summary
30
+ ```
31
+
32
+ **RU:**
33
+ ```
34
+ /evaluate-model
35
+
36
+ Run ID: mlflow://fraud-exp/8124ac91
37
+ Champion reference: fraud-detection-xgb-v12 (Production)
38
+ Тип модели: binary classification
39
+ Held-out test set: fraud_eval_2026_02_15.parquet (никогда не использовался в обучении)
40
+ Обязательные метрики:
41
+ - AUC-ROC, PR-AUC, precision, recall, F1 на operating threshold 0.72
42
+ - confusion matrix для сумм > $500 и <= $500
43
+ Бизнес-интерпретация:
44
+ - оценить предотвращённые fraud losses в месяц при текущем трафике
45
+ - оценить рост стоимости ручной проверки из-за false positive
46
+ Требуется fairness check: disparity по customer_region и account_age_bucket
47
+ Варианты решения: PROMOTE / DO_NOT_PROMOTE / NEEDS_REVIEW
48
+ Результат: подписанный evaluation_scorecard.json + графики + summary сравнения с champion
49
+ ```
50
+
51
+ ---
52
+
53
+ ## Example 2 — Regression model with champion comparison and leakage guard
54
+
55
+ **EN:**
56
+ ```
57
+ /evaluate-model
58
+
59
+ Run ID: mlflow://pricing-exp/cd09f552
60
+ Champion reference: price-forecast-lgbm-v7
61
+ Model type: regression
62
+ Held-out test set: demand_forecast_eval_week_10 (data version dv_2026_03_01)
63
+ Checks required:
64
+ - verify test set rows were excluded from every training iteration and hyperparameter search
65
+ - compute MAE, RMSE, R2, and MAPE vs champion on the same horizon
66
+ - business impact: estimate inventory carrying cost delta if challenger replaces champion
67
+ - slice analysis: top 20 SKUs, long-tail SKUs, promo periods, holiday periods
68
+ Promotion rule: only recommend PROMOTE if MAE improves and no slice regresses by more than 3%
69
+ Output: scorecard, leakage verification note, and decision rationale for pricing team review
70
+ ```
71
+
72
+ **RU:**
73
+ ```
74
+ /evaluate-model
75
+
76
+ Run ID: mlflow://pricing-exp/cd09f552
77
+ Champion reference: price-forecast-lgbm-v7
78
+ Тип модели: regression
79
+ Held-out test set: demand_forecast_eval_week_10 (версия данных dv_2026_03_01)
80
+ Требуемые проверки:
81
+ - подтвердить, что строки test set были исключены из всех итераций обучения и hyperparameter search
82
+ - вычислить MAE, RMSE, R2 и MAPE vs champion на том же горизонте
83
+ - бизнес-эффект: оценить дельту стоимости хранения запасов, если challenger заменит champion
84
+ - slice analysis: top 20 SKU, long-tail SKU, promo periods, holiday periods
85
+ Правило продвижения: рекомендовать PROMOTE только если MAE улучшается и ни один slice не деградирует более чем на 3%
86
+ Результат: scorecard, заметка о проверке leakage и обоснование решения для review командой pricing
87
+ ```