aigroup-workflow 2.2.1 → 2.2.3

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 (653) hide show
  1. package/.claude/commands/fix-build.md +10 -5
  2. package/.claude/commands/init-project.md +13 -8
  3. package/.claude/commands/plan.md +15 -8
  4. package/.claude/commands/review.md +12 -6
  5. package/.claude/commands/tdd.md +11 -5
  6. package/.claude/commands/workflow-start.md +20 -11
  7. package/.claude/settings.json +28 -0
  8. package/.codex/agents/architect.toml +207 -0
  9. package/.codex/agents/build-error-resolver.toml +110 -0
  10. package/.codex/agents/code-reviewer.toml +233 -0
  11. package/.codex/agents/doc-updater.toml +103 -0
  12. package/.codex/agents/e2e-runner.toml +103 -0
  13. package/.codex/agents/get-current-datetime.toml +23 -0
  14. package/.codex/agents/init-architect.toml +181 -0
  15. package/.codex/agents/planner.toml +208 -0
  16. package/.codex/agents/refactor-cleaner.toml +81 -0
  17. package/.codex/agents/rust-reviewer.toml +90 -0
  18. package/.codex/agents/security-reviewer.toml +104 -0
  19. package/.codex/agents/tdd-guide.toml +87 -0
  20. package/.codex/config.toml +22 -39
  21. package/AGENTS.md +2 -2
  22. package/CLAUDE.md +23 -1
  23. package/LICENSE +20 -20
  24. package/README.md +333 -333
  25. package/agents/a11y-architect.md +141 -141
  26. package/agents/architect.md +211 -211
  27. package/agents/build-error-resolver.md +114 -114
  28. package/agents/chief-of-staff.md +151 -151
  29. package/agents/code-architect.md +71 -71
  30. package/agents/code-explorer.md +69 -69
  31. package/agents/code-reviewer.md +237 -237
  32. package/agents/code-simplifier.md +47 -47
  33. package/agents/comment-analyzer.md +45 -45
  34. package/agents/conversation-analyzer.md +52 -52
  35. package/agents/cpp-build-resolver.md +90 -90
  36. package/agents/cpp-reviewer.md +72 -72
  37. package/agents/csharp-reviewer.md +101 -101
  38. package/agents/dart-build-resolver.md +201 -201
  39. package/agents/database-reviewer.md +91 -91
  40. package/agents/doc-updater.md +107 -107
  41. package/agents/docs-lookup.md +68 -68
  42. package/agents/e2e-runner.md +107 -107
  43. package/agents/flutter-reviewer.md +243 -243
  44. package/agents/gan-evaluator.md +209 -209
  45. package/agents/gan-generator.md +131 -131
  46. package/agents/gan-planner.md +99 -99
  47. package/agents/get-current-datetime.md +26 -26
  48. package/agents/go-build-resolver.md +94 -94
  49. package/agents/go-reviewer.md +76 -76
  50. package/agents/harness-optimizer.md +35 -35
  51. package/agents/healthcare-reviewer.md +83 -83
  52. package/agents/java-build-resolver.md +153 -153
  53. package/agents/java-reviewer.md +92 -92
  54. package/agents/kotlin-build-resolver.md +118 -118
  55. package/agents/kotlin-reviewer.md +159 -159
  56. package/agents/loop-operator.md +36 -36
  57. package/agents/opensource-forker.md +198 -198
  58. package/agents/opensource-packager.md +249 -249
  59. package/agents/opensource-sanitizer.md +188 -188
  60. package/agents/performance-optimizer.md +446 -446
  61. package/agents/planner.md +212 -212
  62. package/agents/pr-test-analyzer.md +45 -45
  63. package/agents/python-reviewer.md +98 -98
  64. package/agents/pytorch-build-resolver.md +120 -120
  65. package/agents/refactor-cleaner.md +85 -85
  66. package/agents/rust-build-resolver.md +148 -148
  67. package/agents/rust-reviewer.md +94 -94
  68. package/agents/security-reviewer.md +108 -108
  69. package/agents/seo-specialist.md +59 -59
  70. package/agents/silent-failure-hunter.md +50 -50
  71. package/agents/tdd-guide.md +91 -91
  72. package/agents/type-design-analyzer.md +41 -41
  73. package/agents/typescript-reviewer.md +112 -112
  74. package/cli/commands/update.mjs +1 -1
  75. package/cli/utils/scaffold.mjs +53 -0
  76. package/docs/rules/agents.md +166 -50
  77. package/docs/rules/cpp/coding-style.md +44 -44
  78. package/docs/rules/cpp/hooks.md +39 -39
  79. package/docs/rules/cpp/patterns.md +51 -51
  80. package/docs/rules/cpp/security.md +51 -51
  81. package/docs/rules/cpp/testing.md +44 -44
  82. package/docs/rules/csharp/coding-style.md +72 -72
  83. package/docs/rules/csharp/hooks.md +25 -25
  84. package/docs/rules/csharp/patterns.md +50 -50
  85. package/docs/rules/csharp/security.md +58 -58
  86. package/docs/rules/csharp/testing.md +46 -46
  87. package/docs/rules/dart/coding-style.md +159 -159
  88. package/docs/rules/dart/hooks.md +66 -66
  89. package/docs/rules/dart/patterns.md +261 -261
  90. package/docs/rules/dart/security.md +135 -135
  91. package/docs/rules/dart/testing.md +215 -215
  92. package/docs/rules/golang/coding-style.md +32 -32
  93. package/docs/rules/golang/hooks.md +17 -17
  94. package/docs/rules/golang/patterns.md +45 -45
  95. package/docs/rules/golang/security.md +34 -34
  96. package/docs/rules/golang/testing.md +31 -31
  97. package/docs/rules/java/coding-style.md +114 -114
  98. package/docs/rules/java/hooks.md +18 -18
  99. package/docs/rules/java/patterns.md +146 -146
  100. package/docs/rules/java/security.md +100 -100
  101. package/docs/rules/java/testing.md +131 -131
  102. package/docs/rules/java_zn/coding-style.md +169 -0
  103. package/docs/rules/java_zn/mybatis.md +102 -0
  104. package/docs/rules/kotlin/coding-style.md +86 -86
  105. package/docs/rules/kotlin/hooks.md +17 -17
  106. package/docs/rules/kotlin/patterns.md +146 -146
  107. package/docs/rules/kotlin/security.md +82 -82
  108. package/docs/rules/kotlin/testing.md +128 -128
  109. package/docs/rules/perl/coding-style.md +46 -46
  110. package/docs/rules/perl/hooks.md +22 -22
  111. package/docs/rules/perl/patterns.md +76 -76
  112. package/docs/rules/perl/security.md +69 -69
  113. package/docs/rules/perl/testing.md +54 -54
  114. package/docs/rules/php/coding-style.md +40 -40
  115. package/docs/rules/php/hooks.md +24 -24
  116. package/docs/rules/php/patterns.md +33 -33
  117. package/docs/rules/php/security.md +37 -37
  118. package/docs/rules/php/testing.md +39 -39
  119. package/docs/rules/python/coding-style.md +42 -42
  120. package/docs/rules/python/hooks.md +19 -19
  121. package/docs/rules/python/patterns.md +39 -39
  122. package/docs/rules/python/security.md +30 -30
  123. package/docs/rules/python/testing.md +38 -38
  124. package/docs/rules/rust/coding-style.md +151 -151
  125. package/docs/rules/rust/hooks.md +16 -16
  126. package/docs/rules/rust/patterns.md +168 -168
  127. package/docs/rules/rust/security.md +141 -141
  128. package/docs/rules/rust/testing.md +154 -154
  129. package/docs/rules/swift/coding-style.md +47 -47
  130. package/docs/rules/swift/hooks.md +20 -20
  131. package/docs/rules/swift/patterns.md +66 -66
  132. package/docs/rules/swift/security.md +33 -33
  133. package/docs/rules/swift/testing.md +45 -45
  134. package/docs/rules/typescript/coding-style.md +199 -199
  135. package/docs/rules/typescript/hooks.md +22 -22
  136. package/docs/rules/typescript/patterns.md +52 -52
  137. package/docs/rules/typescript/security.md +28 -28
  138. package/docs/rules/typescript/testing.md +18 -18
  139. package/docs/rules/web/coding-style.md +96 -96
  140. package/docs/rules/web/design-quality.md +62 -62
  141. package/docs/rules/web/hooks.md +120 -120
  142. package/docs/rules/web/patterns.md +79 -79
  143. package/docs/rules/web/performance.md +64 -64
  144. package/docs/rules/web/security.md +57 -57
  145. package/docs/rules/web/testing.md +55 -55
  146. package/docs/templates/README.md +36 -36
  147. package/docs/templates/ai-project-final.md +124 -124
  148. package/docs/templates/ai-project.md +105 -105
  149. package/docs/templates/api.md +157 -157
  150. package/docs/templates/bug.md +62 -62
  151. package/docs/templates/code-review.md +87 -87
  152. package/docs/templates/generic.md +116 -116
  153. package/docs/templates/implementation-plan.md +1 -1
  154. package/docs/templates/meeting.md +68 -68
  155. package/docs/templates/prd.md +98 -98
  156. package/docs/templates/ui.md +134 -134
  157. package/docs/workflow-pipeline.md +5 -5
  158. package/package.json +40 -39
  159. package/skills/SUPERPOWERS-LICENSE +21 -21
  160. package/skills/ai-ml/fine-tuning-expert/SKILL.md +162 -162
  161. package/skills/ai-ml/fine-tuning-expert/references/dataset-preparation.md +540 -540
  162. package/skills/ai-ml/fine-tuning-expert/references/deployment-optimization.md +673 -673
  163. package/skills/ai-ml/fine-tuning-expert/references/evaluation-metrics.md +597 -597
  164. package/skills/ai-ml/fine-tuning-expert/references/hyperparameter-tuning.md +565 -565
  165. package/skills/ai-ml/fine-tuning-expert/references/lora-peft.md +347 -347
  166. package/skills/ai-ml/ml-pipeline/SKILL.md +159 -159
  167. package/skills/ai-ml/ml-pipeline/references/experiment-tracking.md +833 -833
  168. package/skills/ai-ml/ml-pipeline/references/feature-engineering.md +631 -631
  169. package/skills/ai-ml/ml-pipeline/references/model-validation.md +978 -978
  170. package/skills/ai-ml/ml-pipeline/references/pipeline-orchestration.md +907 -907
  171. package/skills/ai-ml/ml-pipeline/references/training-pipelines.md +782 -782
  172. package/skills/ai-ml/rag-architect/SKILL.md +194 -194
  173. package/skills/ai-ml/rag-architect/references/chunking-strategies.md +878 -878
  174. package/skills/ai-ml/rag-architect/references/embedding-models.md +561 -561
  175. package/skills/ai-ml/rag-architect/references/rag-evaluation.md +833 -833
  176. package/skills/ai-ml/rag-architect/references/retrieval-optimization.md +795 -795
  177. package/skills/ai-ml/rag-architect/references/vector-databases.md +589 -589
  178. package/skills/ai-ml/spark-engineer/SKILL.md +148 -148
  179. package/skills/ai-ml/spark-engineer/references/partitioning-caching.md +543 -543
  180. package/skills/ai-ml/spark-engineer/references/performance-tuning.md +544 -544
  181. package/skills/ai-ml/spark-engineer/references/rdd-operations.md +599 -599
  182. package/skills/ai-ml/spark-engineer/references/spark-sql-dataframes.md +474 -474
  183. package/skills/ai-ml/spark-engineer/references/streaming-patterns.md +786 -786
  184. package/skills/backend/api-designer/SKILL.md +217 -217
  185. package/skills/backend/api-designer/references/error-handling.md +541 -541
  186. package/skills/backend/api-designer/references/openapi.md +824 -824
  187. package/skills/backend/api-designer/references/pagination.md +494 -494
  188. package/skills/backend/api-designer/references/rest-patterns.md +335 -335
  189. package/skills/backend/api-designer/references/versioning.md +391 -391
  190. package/skills/backend/architecture-designer/SKILL.md +117 -117
  191. package/skills/backend/architecture-designer/references/adr-template.md +116 -116
  192. package/skills/backend/architecture-designer/references/architecture-patterns.md +111 -111
  193. package/skills/backend/architecture-designer/references/database-selection.md +102 -102
  194. package/skills/backend/architecture-designer/references/nfr-checklist.md +112 -112
  195. package/skills/backend/architecture-designer/references/system-design.md +100 -100
  196. package/skills/backend/code-documenter/SKILL.md +147 -147
  197. package/skills/backend/code-documenter/references/api-docs-fastapi-django.md +166 -166
  198. package/skills/backend/code-documenter/references/api-docs-nestjs-express.md +220 -220
  199. package/skills/backend/code-documenter/references/coverage-reports.md +125 -125
  200. package/skills/backend/code-documenter/references/documentation-systems.md +333 -333
  201. package/skills/backend/code-documenter/references/interactive-api-docs.md +531 -531
  202. package/skills/backend/code-documenter/references/python-docstrings.md +121 -121
  203. package/skills/backend/code-documenter/references/typescript-jsdoc.md +145 -145
  204. package/skills/backend/code-documenter/references/user-guides-tutorials.md +530 -530
  205. package/skills/backend/debugging-wizard/SKILL.md +105 -105
  206. package/skills/backend/debugging-wizard/references/common-patterns.md +132 -132
  207. package/skills/backend/debugging-wizard/references/debugging-tools.md +140 -140
  208. package/skills/backend/debugging-wizard/references/quick-fixes.md +177 -177
  209. package/skills/backend/debugging-wizard/references/strategies.md +142 -142
  210. package/skills/backend/debugging-wizard/references/systematic-debugging.md +367 -367
  211. package/skills/backend/feature-forge/SKILL.md +98 -98
  212. package/skills/backend/feature-forge/references/acceptance-criteria.md +104 -104
  213. package/skills/backend/feature-forge/references/ears-syntax.md +99 -99
  214. package/skills/backend/feature-forge/references/interview-questions.md +150 -150
  215. package/skills/backend/feature-forge/references/pre-discovery-subagents.md +54 -54
  216. package/skills/backend/feature-forge/references/specification-template.md +103 -103
  217. package/skills/backend/fullstack-guardian/SKILL.md +105 -105
  218. package/skills/backend/fullstack-guardian/references/api-design-standards.md +307 -307
  219. package/skills/backend/fullstack-guardian/references/architecture-decisions.md +350 -350
  220. package/skills/backend/fullstack-guardian/references/backend-patterns.md +237 -237
  221. package/skills/backend/fullstack-guardian/references/common-patterns.md +134 -134
  222. package/skills/backend/fullstack-guardian/references/deliverables-checklist.md +354 -354
  223. package/skills/backend/fullstack-guardian/references/design-template.md +91 -91
  224. package/skills/backend/fullstack-guardian/references/error-handling.md +135 -135
  225. package/skills/backend/fullstack-guardian/references/frontend-patterns.md +340 -340
  226. package/skills/backend/fullstack-guardian/references/integration-patterns.md +333 -333
  227. package/skills/backend/fullstack-guardian/references/security-checklist.md +106 -106
  228. package/skills/backend/graphql-architect/SKILL.md +146 -146
  229. package/skills/backend/graphql-architect/references/federation.md +418 -418
  230. package/skills/backend/graphql-architect/references/migration-from-rest.md +1141 -1141
  231. package/skills/backend/graphql-architect/references/resolvers.md +425 -425
  232. package/skills/backend/graphql-architect/references/schema-design.md +393 -393
  233. package/skills/backend/graphql-architect/references/security.md +569 -569
  234. package/skills/backend/graphql-architect/references/subscriptions.md +510 -510
  235. package/skills/backend/legacy-modernizer/SKILL.md +137 -137
  236. package/skills/backend/legacy-modernizer/references/legacy-testing.md +381 -381
  237. package/skills/backend/legacy-modernizer/references/migration-strategies.md +423 -423
  238. package/skills/backend/legacy-modernizer/references/refactoring-patterns.md +395 -395
  239. package/skills/backend/legacy-modernizer/references/strangler-fig-pattern.md +281 -281
  240. package/skills/backend/legacy-modernizer/references/system-assessment.md +487 -487
  241. package/skills/backend/microservices-architect/SKILL.md +164 -164
  242. package/skills/backend/microservices-architect/references/communication.md +499 -499
  243. package/skills/backend/microservices-architect/references/data.md +721 -721
  244. package/skills/backend/microservices-architect/references/decomposition.md +344 -344
  245. package/skills/backend/microservices-architect/references/observability.md +805 -805
  246. package/skills/backend/microservices-architect/references/patterns.md +603 -603
  247. package/skills/database/database-optimizer/SKILL.md +147 -147
  248. package/skills/database/database-optimizer/references/index-strategies.md +331 -331
  249. package/skills/database/database-optimizer/references/monitoring-analysis.md +501 -501
  250. package/skills/database/database-optimizer/references/mysql-tuning.md +452 -452
  251. package/skills/database/database-optimizer/references/postgresql-tuning.md +413 -413
  252. package/skills/database/database-optimizer/references/query-optimization.md +251 -251
  253. package/skills/database/postgres-pro/SKILL.md +152 -152
  254. package/skills/database/postgres-pro/references/extensions.md +404 -404
  255. package/skills/database/postgres-pro/references/jsonb.md +321 -321
  256. package/skills/database/postgres-pro/references/maintenance.md +481 -481
  257. package/skills/database/postgres-pro/references/performance.md +265 -265
  258. package/skills/database/postgres-pro/references/replication.md +446 -446
  259. package/skills/database/sql-pro/SKILL.md +129 -129
  260. package/skills/database/sql-pro/references/database-design.md +402 -402
  261. package/skills/database/sql-pro/references/dialect-differences.md +419 -419
  262. package/skills/database/sql-pro/references/optimization.md +384 -384
  263. package/skills/database/sql-pro/references/query-patterns.md +285 -285
  264. package/skills/database/sql-pro/references/window-functions.md +328 -328
  265. package/skills/dotnet/csharp-developer/SKILL.md +125 -125
  266. package/skills/dotnet/csharp-developer/references/aspnet-core.md +394 -394
  267. package/skills/dotnet/csharp-developer/references/blazor.md +553 -553
  268. package/skills/dotnet/csharp-developer/references/entity-framework.md +409 -409
  269. package/skills/dotnet/csharp-developer/references/modern-csharp.md +248 -248
  270. package/skills/dotnet/csharp-developer/references/performance.md +498 -498
  271. package/skills/dotnet/dotnet-core-expert/SKILL.md +138 -138
  272. package/skills/dotnet/dotnet-core-expert/references/authentication.md +546 -546
  273. package/skills/dotnet/dotnet-core-expert/references/clean-architecture.md +455 -455
  274. package/skills/dotnet/dotnet-core-expert/references/cloud-native.md +548 -548
  275. package/skills/dotnet/dotnet-core-expert/references/entity-framework.md +440 -440
  276. package/skills/dotnet/dotnet-core-expert/references/minimal-apis.md +319 -319
  277. package/skills/frontend/angular-architect/SKILL.md +152 -152
  278. package/skills/frontend/angular-architect/references/components.md +297 -297
  279. package/skills/frontend/angular-architect/references/ngrx.md +401 -401
  280. package/skills/frontend/angular-architect/references/routing.md +361 -361
  281. package/skills/frontend/angular-architect/references/rxjs.md +319 -319
  282. package/skills/frontend/angular-architect/references/testing.md +405 -405
  283. package/skills/frontend/design-commands/design.md +91 -91
  284. package/skills/frontend/design-commands/handoff.md +97 -97
  285. package/skills/frontend/design-commands/prototype.md +120 -120
  286. package/skills/frontend/design-commands/spec.md +160 -160
  287. package/skills/frontend/design-commands/style.md +78 -78
  288. package/skills/frontend/flutter-expert/SKILL.md +138 -138
  289. package/skills/frontend/flutter-expert/references/bloc-state.md +259 -259
  290. package/skills/frontend/flutter-expert/references/gorouter-navigation.md +119 -119
  291. package/skills/frontend/flutter-expert/references/performance.md +99 -99
  292. package/skills/frontend/flutter-expert/references/project-structure.md +118 -118
  293. package/skills/frontend/flutter-expert/references/riverpod-state.md +130 -130
  294. package/skills/frontend/flutter-expert/references/widget-patterns.md +123 -123
  295. package/skills/frontend/nextjs-developer/SKILL.md +143 -143
  296. package/skills/frontend/nextjs-developer/references/app-router.md +311 -311
  297. package/skills/frontend/nextjs-developer/references/data-fetching.md +482 -482
  298. package/skills/frontend/nextjs-developer/references/deployment.md +545 -545
  299. package/skills/frontend/nextjs-developer/references/server-actions.md +462 -462
  300. package/skills/frontend/nextjs-developer/references/server-components.md +384 -384
  301. package/skills/frontend/react-expert/SKILL.md +149 -149
  302. package/skills/frontend/react-expert/references/hooks-patterns.md +162 -162
  303. package/skills/frontend/react-expert/references/migration-class-to-modern.md +1119 -1119
  304. package/skills/frontend/react-expert/references/performance.md +168 -168
  305. package/skills/frontend/react-expert/references/react-19-features.md +174 -174
  306. package/skills/frontend/react-expert/references/server-components.md +143 -143
  307. package/skills/frontend/react-expert/references/state-management.md +171 -171
  308. package/skills/frontend/react-expert/references/testing-react.md +174 -174
  309. package/skills/frontend/react-native-expert/SKILL.md +185 -185
  310. package/skills/frontend/react-native-expert/references/expo-router.md +187 -187
  311. package/skills/frontend/react-native-expert/references/list-optimization.md +204 -204
  312. package/skills/frontend/react-native-expert/references/platform-handling.md +188 -188
  313. package/skills/frontend/react-native-expert/references/project-structure.md +171 -171
  314. package/skills/frontend/react-native-expert/references/storage-hooks.md +173 -173
  315. package/skills/frontend/senior-frontend/SKILL.md +477 -477
  316. package/skills/frontend/senior-frontend/references/frontend_best_practices.md +806 -806
  317. package/skills/frontend/senior-frontend/references/nextjs_optimization_guide.md +724 -724
  318. package/skills/frontend/senior-frontend/references/react_patterns.md +746 -746
  319. package/skills/frontend/senior-frontend/scripts/bundle_analyzer.py +407 -407
  320. package/skills/frontend/senior-frontend/scripts/component_generator.py +329 -329
  321. package/skills/frontend/senior-frontend/scripts/frontend_scaffolder.py +1005 -1005
  322. package/skills/frontend/ui-ux-pro-max/SKILL.md +386 -386
  323. package/skills/frontend/ui-ux-pro-max/data/charts.csv +26 -26
  324. package/skills/frontend/ui-ux-pro-max/data/colors.csv +97 -97
  325. package/skills/frontend/ui-ux-pro-max/data/icons.csv +101 -101
  326. package/skills/frontend/ui-ux-pro-max/data/landing.csv +31 -31
  327. package/skills/frontend/ui-ux-pro-max/data/products.csv +96 -96
  328. package/skills/frontend/ui-ux-pro-max/data/react-performance.csv +45 -45
  329. package/skills/frontend/ui-ux-pro-max/data/stacks/astro.csv +54 -54
  330. package/skills/frontend/ui-ux-pro-max/data/stacks/flutter.csv +53 -53
  331. package/skills/frontend/ui-ux-pro-max/data/stacks/html-tailwind.csv +56 -56
  332. package/skills/frontend/ui-ux-pro-max/data/stacks/jetpack-compose.csv +53 -53
  333. package/skills/frontend/ui-ux-pro-max/data/stacks/nextjs.csv +53 -53
  334. package/skills/frontend/ui-ux-pro-max/data/stacks/nuxt-ui.csv +51 -51
  335. package/skills/frontend/ui-ux-pro-max/data/stacks/nuxtjs.csv +59 -59
  336. package/skills/frontend/ui-ux-pro-max/data/stacks/react-native.csv +52 -52
  337. package/skills/frontend/ui-ux-pro-max/data/stacks/react.csv +54 -54
  338. package/skills/frontend/ui-ux-pro-max/data/stacks/shadcn.csv +61 -61
  339. package/skills/frontend/ui-ux-pro-max/data/stacks/svelte.csv +54 -54
  340. package/skills/frontend/ui-ux-pro-max/data/stacks/swiftui.csv +51 -51
  341. package/skills/frontend/ui-ux-pro-max/data/stacks/vue.csv +50 -50
  342. package/skills/frontend/ui-ux-pro-max/data/styles.csv +68 -68
  343. package/skills/frontend/ui-ux-pro-max/data/typography.csv +57 -57
  344. package/skills/frontend/ui-ux-pro-max/data/ui-reasoning.csv +101 -101
  345. package/skills/frontend/ui-ux-pro-max/data/ux-guidelines.csv +99 -99
  346. package/skills/frontend/ui-ux-pro-max/data/web-interface.csv +31 -31
  347. package/skills/frontend/ui-ux-pro-max/scripts/core.py +253 -253
  348. package/skills/frontend/ui-ux-pro-max/scripts/design_system.py +1067 -1067
  349. package/skills/frontend/ui-ux-pro-max/scripts/search.py +114 -114
  350. package/skills/frontend/vue-expert/SKILL.md +98 -98
  351. package/skills/frontend/vue-expert/references/build-tooling.md +480 -480
  352. package/skills/frontend/vue-expert/references/components.md +448 -448
  353. package/skills/frontend/vue-expert/references/composition-api.md +299 -299
  354. package/skills/frontend/vue-expert/references/mobile-hybrid.md +636 -636
  355. package/skills/frontend/vue-expert/references/nuxt.md +669 -669
  356. package/skills/frontend/vue-expert/references/state-management.md +449 -449
  357. package/skills/frontend/vue-expert/references/typescript.md +584 -584
  358. package/skills/frontend/vue-expert-js/SKILL.md +167 -167
  359. package/skills/frontend/vue-expert-js/references/component-architecture.md +219 -219
  360. package/skills/frontend/vue-expert-js/references/composables-patterns.md +183 -183
  361. package/skills/frontend/vue-expert-js/references/jsdoc-typing.md +535 -535
  362. package/skills/frontend/vue-expert-js/references/state-management.md +249 -249
  363. package/skills/frontend/vue-expert-js/references/testing-patterns.md +237 -237
  364. package/skills/go-rust-cpp/cpp-pro/SKILL.md +115 -115
  365. package/skills/go-rust-cpp/cpp-pro/references/build-tooling.md +440 -440
  366. package/skills/go-rust-cpp/cpp-pro/references/concurrency.md +437 -437
  367. package/skills/go-rust-cpp/cpp-pro/references/memory-performance.md +397 -397
  368. package/skills/go-rust-cpp/cpp-pro/references/modern-cpp.md +304 -304
  369. package/skills/go-rust-cpp/cpp-pro/references/templates.md +357 -357
  370. package/skills/go-rust-cpp/golang-pro/SKILL.md +122 -122
  371. package/skills/go-rust-cpp/golang-pro/references/concurrency.md +329 -329
  372. package/skills/go-rust-cpp/golang-pro/references/generics.md +442 -442
  373. package/skills/go-rust-cpp/golang-pro/references/interfaces.md +432 -432
  374. package/skills/go-rust-cpp/golang-pro/references/project-structure.md +477 -477
  375. package/skills/go-rust-cpp/golang-pro/references/testing.md +451 -451
  376. package/skills/go-rust-cpp/rust-engineer/SKILL.md +167 -167
  377. package/skills/go-rust-cpp/rust-engineer/references/async.md +458 -458
  378. package/skills/go-rust-cpp/rust-engineer/references/error-handling.md +334 -334
  379. package/skills/go-rust-cpp/rust-engineer/references/ownership.md +278 -278
  380. package/skills/go-rust-cpp/rust-engineer/references/testing.md +470 -470
  381. package/skills/go-rust-cpp/rust-engineer/references/traits.md +413 -413
  382. package/skills/infra/cli-developer/SKILL.md +113 -113
  383. package/skills/infra/cli-developer/references/design-patterns.md +221 -221
  384. package/skills/infra/cli-developer/references/go-cli.md +540 -540
  385. package/skills/infra/cli-developer/references/node-cli.md +383 -383
  386. package/skills/infra/cli-developer/references/python-cli.md +422 -422
  387. package/skills/infra/cli-developer/references/ux-patterns.md +448 -448
  388. package/skills/infra/cloud-architect/SKILL.md +216 -216
  389. package/skills/infra/cloud-architect/references/aws.md +394 -394
  390. package/skills/infra/cloud-architect/references/azure.md +562 -562
  391. package/skills/infra/cloud-architect/references/cost.md +582 -582
  392. package/skills/infra/cloud-architect/references/gcp.md +633 -633
  393. package/skills/infra/cloud-architect/references/multi-cloud.md +483 -483
  394. package/skills/infra/devops-engineer/SKILL.md +144 -144
  395. package/skills/infra/devops-engineer/references/deployment-strategies.md +241 -241
  396. package/skills/infra/devops-engineer/references/docker-patterns.md +113 -113
  397. package/skills/infra/devops-engineer/references/github-actions.md +139 -139
  398. package/skills/infra/devops-engineer/references/incident-response.md +331 -331
  399. package/skills/infra/devops-engineer/references/kubernetes.md +154 -154
  400. package/skills/infra/devops-engineer/references/platform-engineering.md +417 -417
  401. package/skills/infra/devops-engineer/references/release-automation.md +527 -527
  402. package/skills/infra/devops-engineer/references/terraform-iac.md +141 -141
  403. package/skills/infra/kubernetes-specialist/SKILL.md +241 -241
  404. package/skills/infra/kubernetes-specialist/references/configuration.md +452 -452
  405. package/skills/infra/kubernetes-specialist/references/cost-optimization.md +458 -458
  406. package/skills/infra/kubernetes-specialist/references/custom-operators.md +563 -563
  407. package/skills/infra/kubernetes-specialist/references/gitops.md +530 -530
  408. package/skills/infra/kubernetes-specialist/references/helm-charts.md +912 -912
  409. package/skills/infra/kubernetes-specialist/references/multi-cluster.md +507 -507
  410. package/skills/infra/kubernetes-specialist/references/networking.md +447 -447
  411. package/skills/infra/kubernetes-specialist/references/service-mesh.md +459 -459
  412. package/skills/infra/kubernetes-specialist/references/storage.md +535 -535
  413. package/skills/infra/kubernetes-specialist/references/troubleshooting.md +414 -414
  414. package/skills/infra/kubernetes-specialist/references/workloads.md +377 -377
  415. package/skills/infra/mcp-developer/SKILL.md +143 -143
  416. package/skills/infra/mcp-developer/references/protocol.md +244 -244
  417. package/skills/infra/mcp-developer/references/python-sdk.md +367 -367
  418. package/skills/infra/mcp-developer/references/resources.md +554 -554
  419. package/skills/infra/mcp-developer/references/tools.md +480 -480
  420. package/skills/infra/mcp-developer/references/typescript-sdk.md +350 -350
  421. package/skills/infra/monitoring-expert/SKILL.md +176 -176
  422. package/skills/infra/monitoring-expert/references/alerting-rules.md +141 -141
  423. package/skills/infra/monitoring-expert/references/application-profiling.md +331 -331
  424. package/skills/infra/monitoring-expert/references/capacity-planning.md +344 -344
  425. package/skills/infra/monitoring-expert/references/dashboards.md +126 -126
  426. package/skills/infra/monitoring-expert/references/opentelemetry.md +123 -123
  427. package/skills/infra/monitoring-expert/references/performance-testing.md +269 -269
  428. package/skills/infra/monitoring-expert/references/prometheus-metrics.md +136 -136
  429. package/skills/infra/monitoring-expert/references/structured-logging.md +142 -142
  430. package/skills/infra/sre-engineer/SKILL.md +181 -181
  431. package/skills/infra/sre-engineer/references/automation-toil.md +492 -492
  432. package/skills/infra/sre-engineer/references/error-budget-policy.md +334 -334
  433. package/skills/infra/sre-engineer/references/incident-chaos.md +576 -576
  434. package/skills/infra/sre-engineer/references/monitoring-alerting.md +424 -424
  435. package/skills/infra/sre-engineer/references/slo-sli-management.md +238 -238
  436. package/skills/infra/terraform-engineer/SKILL.md +143 -143
  437. package/skills/infra/terraform-engineer/references/best-practices.md +583 -583
  438. package/skills/infra/terraform-engineer/references/module-patterns.md +297 -297
  439. package/skills/infra/terraform-engineer/references/providers.md +452 -452
  440. package/skills/infra/terraform-engineer/references/state-management.md +371 -371
  441. package/skills/infra/terraform-engineer/references/testing.md +486 -486
  442. package/skills/infra/websocket-engineer/SKILL.md +168 -168
  443. package/skills/infra/websocket-engineer/references/alternatives.md +391 -391
  444. package/skills/infra/websocket-engineer/references/patterns.md +400 -400
  445. package/skills/infra/websocket-engineer/references/protocol.md +195 -195
  446. package/skills/infra/websocket-engineer/references/scaling.md +333 -333
  447. package/skills/infra/websocket-engineer/references/security.md +474 -474
  448. package/skills/java/java-architect/SKILL.md +132 -132
  449. package/skills/java/java-architect/references/jpa-optimization.md +393 -393
  450. package/skills/java/java-architect/references/reactive-webflux.md +356 -356
  451. package/skills/java/java-architect/references/spring-boot-setup.md +269 -269
  452. package/skills/java/java-architect/references/spring-security.md +445 -445
  453. package/skills/java/java-architect/references/testing-patterns.md +500 -500
  454. package/skills/java/kotlin-specialist/SKILL.md +147 -147
  455. package/skills/java/kotlin-specialist/references/android-compose.md +419 -419
  456. package/skills/java/kotlin-specialist/references/coroutines-flow.md +276 -276
  457. package/skills/java/kotlin-specialist/references/dsl-idioms.md +421 -421
  458. package/skills/java/kotlin-specialist/references/ktor-server.md +426 -426
  459. package/skills/java/kotlin-specialist/references/multiplatform-kmp.md +380 -380
  460. package/skills/java/spring-boot-engineer/SKILL.md +196 -195
  461. package/skills/java/spring-boot-engineer/references/cloud.md +498 -498
  462. package/skills/java/spring-boot-engineer/references/data.md +381 -381
  463. package/skills/java/spring-boot-engineer/references/mybatis-plus.md +592 -0
  464. package/skills/java/spring-boot-engineer/references/security.md +459 -459
  465. package/skills/java/spring-boot-engineer/references/testing.md +545 -545
  466. package/skills/java/spring-boot-engineer/references/web.md +295 -295
  467. package/skills/java/spring-boot-engineer_zn/SKILL.md +129 -0
  468. package/skills/java/spring-boot-engineer_zn/references/architecture.md +23 -0
  469. package/skills/java/spring-boot-engineer_zn/references/concurrency.md +9 -0
  470. package/skills/java/spring-boot-engineer_zn/references/exception-logging.md +31 -0
  471. package/skills/java/spring-boot-engineer_zn/references/persistence.md +13 -0
  472. package/skills/java/spring-boot-engineer_zn/references/pojo-lombok.md +48 -0
  473. package/skills/java/spring-boot-engineer_zn/references/security.md +9 -0
  474. package/skills/java/spring-boot-engineer_zn/references/testing.md +7 -0
  475. package/skills/java/spring-boot-engineer_zn/references/validation.md +80 -0
  476. package/skills/javascript/javascript-pro/SKILL.md +132 -132
  477. package/skills/javascript/javascript-pro/references/async-patterns.md +334 -334
  478. package/skills/javascript/javascript-pro/references/browser-apis.md +398 -398
  479. package/skills/javascript/javascript-pro/references/modern-syntax.md +272 -272
  480. package/skills/javascript/javascript-pro/references/modules.md +357 -357
  481. package/skills/javascript/javascript-pro/references/node-essentials.md +471 -471
  482. package/skills/javascript/nestjs-expert/SKILL.md +206 -206
  483. package/skills/javascript/nestjs-expert/references/authentication.md +166 -166
  484. package/skills/javascript/nestjs-expert/references/controllers-routing.md +111 -111
  485. package/skills/javascript/nestjs-expert/references/dtos-validation.md +153 -153
  486. package/skills/javascript/nestjs-expert/references/migration-from-express.md +1237 -1237
  487. package/skills/javascript/nestjs-expert/references/services-di.md +140 -140
  488. package/skills/javascript/nestjs-expert/references/testing-patterns.md +186 -186
  489. package/skills/javascript/typescript-pro/SKILL.md +145 -145
  490. package/skills/javascript/typescript-pro/references/advanced-types.md +259 -259
  491. package/skills/javascript/typescript-pro/references/configuration.md +445 -445
  492. package/skills/javascript/typescript-pro/references/patterns.md +484 -484
  493. package/skills/javascript/typescript-pro/references/type-guards.md +352 -352
  494. package/skills/javascript/typescript-pro/references/utility-types.md +329 -329
  495. package/skills/php/laravel-specialist/SKILL.md +262 -262
  496. package/skills/php/laravel-specialist/references/eloquent.md +351 -351
  497. package/skills/php/laravel-specialist/references/livewire.md +512 -512
  498. package/skills/php/laravel-specialist/references/queues.md +423 -423
  499. package/skills/php/laravel-specialist/references/routing.md +362 -362
  500. package/skills/php/laravel-specialist/references/testing.md +522 -522
  501. package/skills/php/php-pro/SKILL.md +206 -206
  502. package/skills/php/php-pro/references/async-patterns.md +412 -412
  503. package/skills/php/php-pro/references/laravel-patterns.md +377 -377
  504. package/skills/php/php-pro/references/modern-php-features.md +323 -323
  505. package/skills/php/php-pro/references/symfony-patterns.md +466 -466
  506. package/skills/php/php-pro/references/testing-quality.md +466 -466
  507. package/skills/product/competitive-analysis/SKILL.md +257 -257
  508. package/skills/product/meeting-notes/SKILL.md +266 -266
  509. package/skills/product/prd-template/SKILL.md +150 -150
  510. package/skills/product/stakeholder-update/SKILL.md +225 -225
  511. package/skills/product/user-research-synthesis/SKILL.md +235 -235
  512. package/skills/python/django-expert/SKILL.md +162 -162
  513. package/skills/python/django-expert/references/authentication.md +145 -145
  514. package/skills/python/django-expert/references/drf-serializers.md +148 -148
  515. package/skills/python/django-expert/references/models-orm.md +151 -151
  516. package/skills/python/django-expert/references/testing-django.md +204 -204
  517. package/skills/python/django-expert/references/viewsets-views.md +153 -153
  518. package/skills/python/fastapi-expert/SKILL.md +185 -185
  519. package/skills/python/fastapi-expert/references/async-sqlalchemy.md +146 -146
  520. package/skills/python/fastapi-expert/references/authentication.md +159 -159
  521. package/skills/python/fastapi-expert/references/endpoints-routing.md +142 -142
  522. package/skills/python/fastapi-expert/references/migration-from-django.md +996 -996
  523. package/skills/python/fastapi-expert/references/pydantic-v2.md +135 -135
  524. package/skills/python/fastapi-expert/references/testing-async.md +159 -159
  525. package/skills/python/pandas-pro/SKILL.md +178 -178
  526. package/skills/python/pandas-pro/references/aggregation-groupby.md +545 -545
  527. package/skills/python/pandas-pro/references/data-cleaning.md +500 -500
  528. package/skills/python/pandas-pro/references/dataframe-operations.md +420 -420
  529. package/skills/python/pandas-pro/references/merging-joining.md +596 -596
  530. package/skills/python/pandas-pro/references/performance-optimization.md +597 -597
  531. package/skills/python/python-pro/SKILL.md +177 -177
  532. package/skills/python/python-pro/references/async-patterns.md +356 -356
  533. package/skills/python/python-pro/references/packaging.md +460 -460
  534. package/skills/python/python-pro/references/standard-library.md +378 -378
  535. package/skills/python/python-pro/references/testing.md +404 -404
  536. package/skills/python/python-pro/references/type-system.md +290 -290
  537. package/skills/quality/chaos-engineer/SKILL.md +182 -182
  538. package/skills/quality/chaos-engineer/references/chaos-tools.md +511 -511
  539. package/skills/quality/chaos-engineer/references/experiment-design.md +229 -229
  540. package/skills/quality/chaos-engineer/references/game-days.md +434 -434
  541. package/skills/quality/chaos-engineer/references/infrastructure-chaos.md +348 -348
  542. package/skills/quality/chaos-engineer/references/kubernetes-chaos.md +432 -432
  543. package/skills/quality/code-reviewer/SKILL.md +119 -119
  544. package/skills/quality/code-reviewer/references/common-issues.md +142 -142
  545. package/skills/quality/code-reviewer/references/feedback-examples.md +144 -144
  546. package/skills/quality/code-reviewer/references/receiving-feedback.md +238 -238
  547. package/skills/quality/code-reviewer/references/report-template.md +109 -109
  548. package/skills/quality/code-reviewer/references/review-checklist.md +88 -88
  549. package/skills/quality/code-reviewer/references/spec-compliance-review.md +258 -258
  550. package/skills/quality/playwright-expert/SKILL.md +169 -169
  551. package/skills/quality/playwright-expert/references/api-mocking.md +140 -140
  552. package/skills/quality/playwright-expert/references/configuration.md +155 -155
  553. package/skills/quality/playwright-expert/references/debugging-flaky.md +150 -150
  554. package/skills/quality/playwright-expert/references/page-object-model.md +152 -152
  555. package/skills/quality/playwright-expert/references/selectors-locators.md +119 -119
  556. package/skills/quality/secure-code-guardian/SKILL.md +191 -191
  557. package/skills/quality/secure-code-guardian/references/authentication.md +136 -136
  558. package/skills/quality/secure-code-guardian/references/input-validation.md +146 -146
  559. package/skills/quality/secure-code-guardian/references/owasp-prevention.md +135 -135
  560. package/skills/quality/secure-code-guardian/references/security-headers.md +133 -133
  561. package/skills/quality/secure-code-guardian/references/xss-csrf.md +157 -157
  562. package/skills/quality/security-reviewer/SKILL.md +103 -103
  563. package/skills/quality/security-reviewer/references/infrastructure-security.md +268 -268
  564. package/skills/quality/security-reviewer/references/penetration-testing.md +268 -268
  565. package/skills/quality/security-reviewer/references/report-template.md +170 -170
  566. package/skills/quality/security-reviewer/references/sast-tools.md +117 -117
  567. package/skills/quality/security-reviewer/references/secret-scanning.md +125 -125
  568. package/skills/quality/security-reviewer/references/vulnerability-patterns.md +152 -152
  569. package/skills/quality/senior-qa/README.md +196 -196
  570. package/skills/quality/senior-qa/SKILL.md +399 -399
  571. package/skills/quality/senior-qa/references/qa_best_practices.md +964 -964
  572. package/skills/quality/senior-qa/references/test_automation_patterns.md +1009 -1009
  573. package/skills/quality/senior-qa/references/testing_strategies.md +649 -649
  574. package/skills/quality/senior-qa/scripts/coverage_analyzer.py +836 -836
  575. package/skills/quality/senior-qa/scripts/e2e_test_scaffolder.py +820 -820
  576. package/skills/quality/senior-qa/scripts/test_suite_generator.py +605 -605
  577. package/skills/quality/tdd-guide/HOW_TO_USE.md +313 -313
  578. package/skills/quality/tdd-guide/README.md +680 -680
  579. package/skills/quality/tdd-guide/SKILL.md +122 -122
  580. package/skills/quality/tdd-guide/assets/expected_output.json +77 -77
  581. package/skills/quality/tdd-guide/assets/sample_input_python.json +39 -39
  582. package/skills/quality/tdd-guide/assets/sample_input_typescript.json +36 -36
  583. package/skills/quality/tdd-guide/references/ci-integration.md +195 -195
  584. package/skills/quality/tdd-guide/references/framework-guide.md +206 -206
  585. package/skills/quality/tdd-guide/references/tdd-best-practices.md +128 -128
  586. package/skills/quality/tdd-guide/scripts/coverage_analyzer.py +434 -434
  587. package/skills/quality/tdd-guide/scripts/fixture_generator.py +440 -440
  588. package/skills/quality/tdd-guide/scripts/format_detector.py +384 -384
  589. package/skills/quality/tdd-guide/scripts/framework_adapter.py +428 -428
  590. package/skills/quality/tdd-guide/scripts/metrics_calculator.py +456 -456
  591. package/skills/quality/tdd-guide/scripts/output_formatter.py +354 -354
  592. package/skills/quality/tdd-guide/scripts/tdd_workflow.py +474 -474
  593. package/skills/quality/tdd-guide/scripts/test_generator.py +438 -438
  594. package/skills/quality/test-master/SKILL.md +94 -94
  595. package/skills/quality/test-master/references/automation-frameworks.md +294 -294
  596. package/skills/quality/test-master/references/e2e-testing.md +128 -128
  597. package/skills/quality/test-master/references/integration-testing.md +120 -120
  598. package/skills/quality/test-master/references/performance-testing.md +118 -118
  599. package/skills/quality/test-master/references/qa-methodology.md +247 -247
  600. package/skills/quality/test-master/references/security-testing.md +127 -127
  601. package/skills/quality/test-master/references/tdd-iron-laws.md +174 -174
  602. package/skills/quality/test-master/references/test-reports.md +104 -104
  603. package/skills/quality/test-master/references/testing-anti-patterns.md +231 -231
  604. package/skills/quality/test-master/references/unit-testing.md +113 -113
  605. package/skills/ruby/rails-expert/SKILL.md +154 -154
  606. package/skills/ruby/rails-expert/references/active-record.md +244 -244
  607. package/skills/ruby/rails-expert/references/api-development.md +401 -401
  608. package/skills/ruby/rails-expert/references/background-jobs.md +272 -272
  609. package/skills/ruby/rails-expert/references/hotwire-turbo.md +228 -228
  610. package/skills/ruby/rails-expert/references/rspec-testing.md +367 -367
  611. package/skills/swift/swift-expert/SKILL.md +163 -163
  612. package/skills/swift/swift-expert/references/async-concurrency.md +360 -360
  613. package/skills/swift/swift-expert/references/memory-performance.md +377 -377
  614. package/skills/swift/swift-expert/references/protocol-oriented.md +354 -354
  615. package/skills/swift/swift-expert/references/swiftui-patterns.md +291 -291
  616. package/skills/swift/swift-expert/references/testing-patterns.md +399 -399
  617. package/skills/workflow/brainstorming/SKILL.md +164 -164
  618. package/skills/workflow/brainstorming/scripts/frame-template.html +214 -214
  619. package/skills/workflow/brainstorming/scripts/helper.js +88 -88
  620. package/skills/workflow/brainstorming/scripts/server.cjs +354 -354
  621. package/skills/workflow/brainstorming/scripts/start-server.sh +148 -148
  622. package/skills/workflow/brainstorming/scripts/stop-server.sh +56 -56
  623. package/skills/workflow/brainstorming/spec-document-reviewer-prompt.md +49 -49
  624. package/skills/workflow/brainstorming/visual-companion.md +287 -287
  625. package/skills/workflow/documentation/SKILL.md +45 -45
  626. package/skills/workflow/entropy-management/SKILL.md +115 -115
  627. package/skills/workflow/executing-plans/SKILL.md +70 -70
  628. package/skills/workflow/finishing-a-development-branch/SKILL.md +200 -200
  629. package/skills/workflow/receiving-code-review/SKILL.md +213 -213
  630. package/skills/workflow/requesting-code-review/SKILL.md +105 -105
  631. package/skills/workflow/requesting-code-review/code-reviewer.md +146 -146
  632. package/skills/workflow/requirement-engineering/SKILL.md +111 -111
  633. package/skills/workflow/systematic-debugging/CREATION-LOG.md +119 -119
  634. package/skills/workflow/systematic-debugging/SKILL.md +296 -296
  635. package/skills/workflow/systematic-debugging/condition-based-waiting-example.ts +158 -158
  636. package/skills/workflow/systematic-debugging/condition-based-waiting.md +115 -115
  637. package/skills/workflow/systematic-debugging/defense-in-depth.md +122 -122
  638. package/skills/workflow/systematic-debugging/find-polluter.sh +63 -63
  639. package/skills/workflow/systematic-debugging/root-cause-tracing.md +169 -169
  640. package/skills/workflow/systematic-debugging/test-academic.md +14 -14
  641. package/skills/workflow/systematic-debugging/test-pressure-1.md +58 -58
  642. package/skills/workflow/systematic-debugging/test-pressure-2.md +68 -68
  643. package/skills/workflow/systematic-debugging/test-pressure-3.md +69 -69
  644. package/skills/workflow/using-git-worktrees/SKILL.md +218 -218
  645. package/skills/workflow/verification-before-completion/SKILL.md +139 -139
  646. package/skills/workflow/writing-plans/SKILL.md +151 -151
  647. package/skills/workflow/writing-plans/plan-document-reviewer-prompt.md +49 -49
  648. package/skills/workflow/writing-skills/SKILL.md +655 -655
  649. package/skills/workflow/writing-skills/anthropic-best-practices.md +1150 -1150
  650. package/skills/workflow/writing-skills/examples/CLAUDE_MD_TESTING.md +189 -189
  651. package/skills/workflow/writing-skills/persuasion-principles.md +187 -187
  652. package/skills/workflow/writing-skills/render-graphs.js +168 -168
  653. package/skills/workflow/writing-skills/testing-skills-with-subagents.md +384 -384
@@ -1,633 +1,633 @@
1
- # GCP Architecture Reference
2
-
3
- Comprehensive guide for Google Cloud Platform services, patterns, and architecture framework.
4
-
5
- ## Google Cloud Architecture Framework
6
-
7
- ### Five Pillars
8
-
9
- 1. **Operational Excellence**
10
- - Infrastructure as Code (Deployment Manager, Terraform)
11
- - CI/CD with Cloud Build
12
- - Monitoring with Cloud Monitoring (Stackdriver)
13
- - SRE principles and SLOs
14
- - Incident management
15
-
16
- 2. **Security, Privacy, and Compliance**
17
- - Identity and Access Management (Cloud IAM)
18
- - VPC Service Controls for data perimeter
19
- - Binary Authorization for containers
20
- - Data encryption (default at rest and in transit)
21
- - Security Command Center
22
-
23
- 3. **Reliability**
24
- - Multi-zone and multi-region deployments
25
- - Load balancing and autoscaling
26
- - Disaster recovery planning
27
- - Chaos engineering practices
28
- - SLIs, SLOs, and error budgets
29
-
30
- 4. **Cost Optimization**
31
- - Committed Use Discounts
32
- - Sustained Use Discounts (automatic)
33
- - Preemptible VMs and Spot VMs
34
- - Recommender for right-sizing
35
- - Active Assist for optimization
36
-
37
- 5. **Performance Optimization**
38
- - Cloud CDN and Media CDN
39
- - Caching strategies (Memorystore)
40
- - Database performance tuning
41
- - Network optimization (Premium vs Standard tier)
42
- - Regional and zonal resource placement
43
-
44
- ## Core Services Architecture
45
-
46
- ### Compute
47
-
48
- **Compute Engine**
49
- - Machine types: E2 (cost-optimized), N2 (balanced), C2 (compute-optimized), M2 (memory-optimized)
50
- - Custom machine types for specific needs
51
- - Preemptible VMs (up to 80% discount, max 24 hours)
52
- - Spot VMs (similar to preemptible, better availability)
53
- - Instance groups: Managed (with autoscaling), unmanaged
54
- - Best practices: Use latest generation, committed use discounts, Spot for batch jobs
55
-
56
- **Cloud Run**
57
- - Fully managed serverless container platform
58
- - Auto-scaling to zero
59
- - Pay per request
60
- - CPU allocated only during request handling
61
- - Best practices: Stateless containers, optimize cold starts, use Cloud Run jobs for batch
62
-
63
- **Cloud Functions**
64
- - Event-driven serverless functions
65
- - 1st gen: HTTP and background functions
66
- - 2nd gen: Built on Cloud Run, better performance
67
- - Event sources: Pub/Sub, Cloud Storage, Firestore, HTTP
68
- - Best practices: Use 2nd gen, minimize cold starts, implement retry logic
69
-
70
- **Google Kubernetes Engine (GKE)**
71
- - Managed Kubernetes with GCP integration
72
- - Autopilot mode: Fully managed, per-pod pricing
73
- - Standard mode: More control, node management
74
- - Workload Identity for secure service access
75
- - Binary Authorization for deployment policies
76
- - Best practices: Use Autopilot for simplicity, enable Workload Identity, implement network policies
77
-
78
- **App Engine**
79
- - Fully managed platform (PaaS)
80
- - Standard environment (sandboxed, auto-scaling)
81
- - Flexible environment (Docker containers, custom runtimes)
82
- - Traffic splitting for canary deployments
83
- - Best practices: Use Standard for web apps, Flexible for custom dependencies
84
-
85
- ### Storage
86
-
87
- **Cloud Storage**
88
- - Storage classes: Standard, Nearline (30-day), Coldline (90-day), Archive (365-day)
89
- - Object lifecycle management
90
- - Object versioning and retention policies
91
- - Autoclass for automatic tier transitions
92
- - Requester pays for data transfer
93
- - Best practices: Use Autoclass, enable versioning, implement lifecycle policies
94
-
95
- **Persistent Disk**
96
- - Types: Standard (HDD), Balanced SSD, SSD, Extreme
97
- - Zonal and regional persistent disks
98
- - Snapshots for backup (incremental)
99
- - Disk resize without downtime
100
- - Best practices: Use Balanced SSD for most workloads, enable snapshots
101
-
102
- **Filestore**
103
- - Managed NFS file storage
104
- - Tiers: Basic (1-63.9 TB), Enterprise (1-10 TB, better performance)
105
- - Backup to Cloud Storage
106
- - Best practices: Use Enterprise for production, implement backups
107
-
108
- **Cloud Storage for Firebase**
109
- - Object storage for mobile and web apps
110
- - Client SDKs for direct upload/download
111
- - Security rules for access control
112
-
113
- ### Database
114
-
115
- **Cloud SQL**
116
- - Managed MySQL, PostgreSQL, SQL Server
117
- - High availability configuration (regional)
118
- - Read replicas for scaling
119
- - Automated backups and point-in-time recovery
120
- - Best practices: Enable HA, use read replicas, implement connection pooling with Cloud SQL Proxy
121
-
122
- **Cloud Spanner**
123
- - Globally distributed relational database
124
- - Horizontal scalability with strong consistency
125
- - Multi-region for 99.999% availability
126
- - TrueTime for global consistency
127
- - Best practices: Design proper schema splits, use commit timestamps, optimize hotspots
128
-
129
- **Firestore (Native mode)**
130
- - NoSQL document database
131
- - Real-time synchronization
132
- - Offline support for mobile
133
- - ACID transactions
134
- - Best practices: Design document structure carefully, use collection group queries wisely
135
-
136
- **Bigtable**
137
- - NoSQL wide-column database
138
- - Petabyte-scale with single-digit millisecond latency
139
- - HBase API compatible
140
- - Linear scalability by adding nodes
141
- - Best practices: Design row keys to avoid hotspots, use replication for HA
142
-
143
- **Memorystore**
144
- - Managed Redis and Memcached
145
- - Standard tier (HA with replica) and Basic tier
146
- - Best practices: Use Standard tier for production, implement connection pooling
147
-
148
- **BigQuery**
149
- - Serverless data warehouse
150
- - SQL analytics on petabyte-scale data
151
- - Column-oriented storage
152
- - Automatic caching and optimization
153
- - Best practices: Partition and cluster tables, use approximate functions, control costs with quotas
154
-
155
- ### Networking
156
-
157
- **VPC (Virtual Private Cloud)**
158
- - Global resource (subnets are regional)
159
- - Custom or auto mode networks
160
- - Firewall rules (stateful)
161
- - VPC peering and Shared VPC
162
- - Private Google Access for GCP services
163
- - Best practices: Use custom mode VPC, plan IP ranges, implement firewall rules
164
-
165
- **Cloud Load Balancing**
166
- - Global load balancing (HTTP(S), TCP/SSL Proxy, external TCP/UDP)
167
- - Regional load balancing (internal HTTP(S), internal TCP/UDP)
168
- - Anycast IP for global distribution
169
- - Backend services with health checks
170
- - Best practices: Use global for multi-region, enable CDN, configure health checks
171
-
172
- **Cloud CDN**
173
- - Global content delivery network
174
- - Cache invalidation and signed URLs
175
- - Integration with Cloud Storage and compute
176
- - Best practices: Enable compression, use cache-control headers
177
-
178
- **Cloud Interconnect and VPN**
179
- - Dedicated Interconnect (10 Gbps or 100 Gbps)
180
- - Partner Interconnect (50 Mbps to 50 Gbps)
181
- - Cloud VPN (HA VPN for 99.99% SLA)
182
- - Best practices: Use HA VPN for redundancy, Dedicated Interconnect for high bandwidth
183
-
184
- **Cloud Armor**
185
- - DDoS protection and WAF
186
- - Preconfigured and custom rules
187
- - Adaptive protection (ML-based)
188
- - Best practices: Enable for internet-facing services, use preconfigured rules
189
-
190
- **Private Service Connect**
191
- - Private connectivity to Google APIs and services
192
- - Service Directory for service discovery
193
- - Best practices: Use for all managed services in production
194
-
195
- ### Serverless and Event-Driven
196
-
197
- **Pub/Sub**
198
- - Global message queue
199
- - At-least-once delivery
200
- - Push and pull subscriptions
201
- - Message ordering and filtering
202
- - Dead-letter topics
203
- - Best practices: Use message attributes for filtering, implement idempotent processing
204
-
205
- **Eventarc**
206
- - Event-driven architecture
207
- - Triggers for Cloud Run, Workflows, GKE
208
- - Sources: Audit Logs, Pub/Sub, custom events
209
- - Best practices: Use for decoupled architectures, implement event filtering
210
-
211
- **Cloud Scheduler**
212
- - Fully managed cron service
213
- - HTTP, Pub/Sub, and App Engine targets
214
- - Best practices: Use for periodic tasks, implement retry logic
215
-
216
- **Workflows**
217
- - Orchestrate and automate GCP and HTTP services
218
- - YAML-based workflow definition
219
- - Built-in error handling and retry
220
- - Best practices: Use for complex multi-step processes, implement compensating transactions
221
-
222
- ### Security and Identity
223
-
224
- **Cloud IAM**
225
- - Resource hierarchy: Organization -> Folders -> Projects -> Resources
226
- - Roles: Primitive (Owner, Editor, Viewer), Predefined, Custom
227
- - Service accounts for applications
228
- - Workload Identity for GKE
229
- - Best practices: Use predefined roles, least privilege, service accounts for apps
230
-
231
- **Cloud Key Management (KMS)**
232
- - Encryption key management
233
- - Customer-managed encryption keys (CMEK)
234
- - Hardware Security Module (HSM) backed
235
- - Automatic key rotation
236
- - Best practices: Enable automatic rotation, use separate keys per environment
237
-
238
- **Secret Manager**
239
- - Store API keys, passwords, certificates
240
- - Versioning and access control
241
- - Automatic rotation integration
242
- - Best practices: Rotate secrets regularly, use IAM for access control
243
-
244
- **Security Command Center**
245
- - Centralized security and risk management
246
- - Asset discovery and vulnerability scanning
247
- - Threat detection and compliance monitoring
248
- - Best practices: Enable all detectors, review findings regularly
249
-
250
- **VPC Service Controls**
251
- - Create security perimeters around GCP resources
252
- - Prevent data exfiltration
253
- - Best practices: Use for sensitive data, implement access levels
254
-
255
- ### AI and Machine Learning
256
-
257
- **Vertex AI**
258
- - Unified ML platform
259
- - AutoML for custom models
260
- - Pre-trained models (Vision, Natural Language, etc.)
261
- - MLOps with pipelines
262
- - Best practices: Use AutoML for quick start, implement feature store
263
-
264
- **BigQuery ML**
265
- - Create and execute ML models using SQL
266
- - Model types: Linear regression, logistic regression, clustering, etc.
267
- - Integration with Vertex AI
268
- - Best practices: Use for simple models, leverage BigQuery's scale
269
-
270
- ## Architecture Patterns
271
-
272
- ### High Availability
273
-
274
- **Multi-Zone Pattern**
275
- ```
276
- Global HTTP(S) Load Balancer
277
- |
278
- v
279
- Managed Instance Group (multi-zone)
280
- |
281
- v
282
- Cloud SQL (regional, HA configuration)
283
- |
284
- v
285
- Cloud Storage (multi-region)
286
- ```
287
-
288
- **Multi-Region Pattern**
289
- ```
290
- Global HTTP(S) Load Balancer
291
- |
292
- ├── Backend Service Region 1 (Cloud Run)
293
- └── Backend Service Region 2 (Cloud Run)
294
- |
295
- v
296
- Cloud Spanner (multi-region)
297
- ```
298
-
299
- ### Serverless Architecture
300
-
301
- **Event-Driven Pattern**
302
- ```
303
- Cloud Storage upload event
304
- |
305
- v
306
- Pub/Sub topic
307
- |
308
- v
309
- Cloud Functions (image processing)
310
- |
311
- v
312
- Firestore (metadata storage)
313
- ```
314
-
315
- **API-First Pattern**
316
- ```
317
- Cloud Endpoints or API Gateway
318
- |
319
- v
320
- Cloud Run (multiple services)
321
- |
322
- ├── Cloud SQL (transactional data)
323
- └── Firestore (user data)
324
- ```
325
-
326
- ### Microservices on GKE
327
-
328
- **GKE with Service Mesh**
329
- ```
330
- Global Load Balancer
331
- |
332
- v
333
- GKE Ingress
334
- |
335
- v
336
- Anthos Service Mesh (Istio)
337
- |
338
- v
339
- Microservices (Cloud Spanner, Firestore, Memorystore)
340
- ```
341
-
342
- ### Data Analytics Platform
343
-
344
- ```
345
- Data Sources
346
- |
347
- v
348
- Pub/Sub (streaming)
349
- |
350
- v
351
- Dataflow (Apache Beam)
352
- |
353
- v
354
- BigQuery (data warehouse)
355
- |
356
- v
357
- Looker or Data Studio (visualization)
358
- ```
359
-
360
- **Batch Processing**
361
- ```
362
- Cloud Storage (raw data)
363
- |
364
- v
365
- Dataproc (Apache Spark)
366
- |
367
- v
368
- BigQuery (analytics)
369
- ```
370
-
371
- ## Landing Zone Design
372
-
373
- ### Resource Hierarchy
374
-
375
- ```
376
- Organization
377
- ├── Folders (by environment or team)
378
- │ ├── Production Folder
379
- │ │ ├── Project A
380
- │ │ └── Project B
381
- │ ├── Staging Folder
382
- │ └── Development Folder
383
- └── Shared Services Folder
384
- ├── Networking Project (Shared VPC host)
385
- ├── Security Project (KMS, Secret Manager)
386
- └── Logging Project (centralized logs)
387
- ```
388
-
389
- ### Network Design
390
-
391
- **Shared VPC Pattern**
392
- ```
393
- Host Project (networking team)
394
- ├── Shared VPC
395
- │ ├── Subnet Production (region A)
396
- │ ├── Subnet Staging (region A)
397
- │ └── Subnet Development (region B)
398
-
399
- Service Projects (application teams)
400
- ├── Production Project (uses Production subnet)
401
- ├── Staging Project (uses Staging subnet)
402
- └── Development Project (uses Development subnet)
403
- ```
404
-
405
- **Hub-and-Spoke with VPN**
406
- ```
407
- On-premises Network
408
- |
409
- v
410
- Cloud VPN / Interconnect
411
- |
412
- v
413
- Hub VPC (shared services)
414
- |
415
- ├── Spoke VPC 1 (production workloads)
416
- ├── Spoke VPC 2 (development workloads)
417
- └── Spoke VPC 3 (analytics workloads)
418
- ```
419
-
420
- ### Governance
421
-
422
- **Organization Policies**
423
- - Restrict public IP assignment
424
- - Enforce uniform bucket-level access
425
- - Restrict VM external IP
426
- - Define allowed resource locations
427
-
428
- **IAM Strategy**
429
- - Use Google Groups for role assignments
430
- - Separate duties (network admin, security admin, etc.)
431
- - Service accounts per application
432
- - Workload Identity for GKE workloads
433
-
434
- **Logging and Monitoring**
435
- ```
436
- All Projects
437
- |
438
- v
439
- Log Router
440
- |
441
- ├── Cloud Logging (default sink)
442
- ├── BigQuery (long-term analysis)
443
- ├── Cloud Storage (archive)
444
- └── Pub/Sub (real-time processing)
445
- ```
446
-
447
- ## Migration Strategies
448
-
449
- ### Migrate to Virtual Machines
450
-
451
- **Tools**
452
- - Migrate to Virtual Machines (formerly Migrate for Compute Engine)
453
- - Supports VMware, AWS, Azure, physical servers
454
- - Agentless or agent-based migration
455
- - Waves and test clones
456
-
457
- **Process**
458
- 1. Assess: Fit assessment and TCO analysis
459
- 2. Plan: Group VMs, define migration waves
460
- 3. Deploy: Set up infrastructure (VPC, firewall rules)
461
- 4. Migrate: Test migration, cutover, validation
462
- 5. Optimize: Right-sizing, committed use discounts
463
-
464
- ### Database Migration
465
-
466
- **Database Migration Service**
467
- - Minimal downtime migrations
468
- - Supports MySQL, PostgreSQL, SQL Server, Oracle
469
- - Continuous replication for cutover flexibility
470
-
471
- **Transfer Appliance**
472
- - Physical device for large data transfers
473
- - Up to 1 PB capacity
474
- - Offline data transfer
475
-
476
- ## Cost Optimization
477
-
478
- ### Compute Savings
479
-
480
- **Committed Use Discounts**
481
- - 1-year or 3-year commitments
482
- - Up to 57% savings for VMs
483
- - Resource-based or spend-based
484
-
485
- **Sustained Use Discounts**
486
- - Automatic discounts for running VMs >25% of month
487
- - Up to 30% savings
488
- - No commitment required
489
-
490
- **Preemptible and Spot VMs**
491
- - Up to 80% discount
492
- - Can be terminated by GCP
493
- - Best for batch processing, fault-tolerant workloads
494
-
495
- **Recommender**
496
- - VM rightsizing recommendations
497
- - Idle resource identification
498
- - Committed use discount recommendations
499
-
500
- ### Storage Savings
501
-
502
- **Cloud Storage**
503
- - Autoclass for automatic tier transitions
504
- - Lifecycle policies (delete or transition)
505
- - Nearline (30+ days), Coldline (90+ days), Archive (365+ days)
506
- - Requester pays for data transfer
507
-
508
- **Persistent Disk**
509
- - Delete orphaned disks
510
- - Use balanced SSD instead of SSD when possible
511
- - Resize disks to match actual usage
512
-
513
- ### BigQuery Savings
514
-
515
- **On-Demand Pricing**
516
- - $5 per TB processed
517
- - Use partitioning and clustering
518
- - Query cache for free repeated queries
519
-
520
- **Flat-Rate Pricing**
521
- - Predictable costs for heavy users
522
- - Autoscaling slots available
523
- - Flex slots for short-term commitments
524
-
525
- **Best Practices**
526
- - Use approximate aggregation functions (APPROX_COUNT_DISTINCT)
527
- - Avoid SELECT *, specify columns
528
- - Use materialized views for common queries
529
- - Set up cost controls with custom quotas
530
-
531
- ### Monitoring Costs
532
-
533
- **Cloud Billing**
534
- - Budgets and alerts
535
- - Cost breakdown by project, service, SKU
536
- - Export to BigQuery for analysis
537
- - Recommendations from Active Assist
538
-
539
- ## Disaster Recovery
540
-
541
- ### Backup Strategies
542
-
543
- **VM Backups**
544
- - Persistent disk snapshots (incremental)
545
- - Machine images (include metadata and config)
546
- - Cross-region snapshot copy
547
- - Snapshot schedules for automation
548
-
549
- **Database Backups**
550
- - Cloud SQL: Automated backups (7-365 days retention)
551
- - Cloud Spanner: Backups on demand or scheduled
552
- - Firestore: Automated daily exports
553
- - Bigtable: Backups to Cloud Storage
554
-
555
- ### High Availability
556
-
557
- **RTO/RPO Matrix**
558
-
559
- | Pattern | RPO | RTO | Cost |
560
- |---------|-----|-----|------|
561
- | Active-Active Multi-Region | Seconds | Seconds | High |
562
- | Active-Passive with Replication | Minutes | Minutes | Medium |
563
- | Warm Standby | Minutes | 10-30 min | Medium |
564
- | Backup and Restore | Hours | Hours | Low |
565
-
566
- **Cloud SQL HA**
567
- - Regional configuration with synchronous replication
568
- - Automatic failover
569
- - 99.95% SLA (vs 99.5% for single zone)
570
-
571
- **Cloud Spanner**
572
- - Multi-region configuration
573
- - 99.999% availability SLA
574
- - Synchronous replication across regions
575
-
576
- ### Disaster Recovery Testing
577
-
578
- - Regular DR drills (quarterly recommended)
579
- - Document runbooks
580
- - Test restoration procedures
581
- - Measure actual RTO/RPO vs targets
582
-
583
- ## Monitoring and Observability
584
-
585
- ### Cloud Monitoring (formerly Stackdriver)
586
-
587
- **Metrics**
588
- - System metrics (CPU, memory, disk, network)
589
- - Custom metrics via Cloud Monitoring API
590
- - Metric scopes for multi-project monitoring
591
- - Uptime checks for availability
592
-
593
- **Dashboards and Charts**
594
- - Predefined dashboards for GCP services
595
- - Custom dashboards with filters and grouping
596
- - SLO monitoring with error budgets
597
-
598
- ### Cloud Logging
599
-
600
- **Log Types**
601
- - Admin Activity logs (always enabled, no charge)
602
- - Data Access logs (must be enabled)
603
- - System Event logs
604
- - Access Transparency logs (for Google access)
605
-
606
- **Log Sinks**
607
- - Route logs to BigQuery, Cloud Storage, Pub/Sub
608
- - Aggregated sinks at organization/folder level
609
- - Exclusion filters to reduce costs
610
-
611
- ### Cloud Trace
612
-
613
- **Distributed Tracing**
614
- - Automatic instrumentation for App Engine, Cloud Run, GKE
615
- - Manual instrumentation with client libraries
616
- - Latency analysis and performance insights
617
- - Integration with Zipkin
618
-
619
- ### Cloud Profiler
620
-
621
- **Continuous Profiling**
622
- - CPU and memory profiling
623
- - Low overhead (< 0.5% CPU)
624
- - Flame graphs for visualization
625
- - Supported languages: Java, Go, Python, Node.js
626
-
627
- ### Error Reporting
628
-
629
- **Aggregated Error Tracking**
630
- - Automatic error grouping
631
- - Stack trace analysis
632
- - Integration with Cloud Logging
633
- - Notifications for new errors
1
+ # GCP Architecture Reference
2
+
3
+ Comprehensive guide for Google Cloud Platform services, patterns, and architecture framework.
4
+
5
+ ## Google Cloud Architecture Framework
6
+
7
+ ### Five Pillars
8
+
9
+ 1. **Operational Excellence**
10
+ - Infrastructure as Code (Deployment Manager, Terraform)
11
+ - CI/CD with Cloud Build
12
+ - Monitoring with Cloud Monitoring (Stackdriver)
13
+ - SRE principles and SLOs
14
+ - Incident management
15
+
16
+ 2. **Security, Privacy, and Compliance**
17
+ - Identity and Access Management (Cloud IAM)
18
+ - VPC Service Controls for data perimeter
19
+ - Binary Authorization for containers
20
+ - Data encryption (default at rest and in transit)
21
+ - Security Command Center
22
+
23
+ 3. **Reliability**
24
+ - Multi-zone and multi-region deployments
25
+ - Load balancing and autoscaling
26
+ - Disaster recovery planning
27
+ - Chaos engineering practices
28
+ - SLIs, SLOs, and error budgets
29
+
30
+ 4. **Cost Optimization**
31
+ - Committed Use Discounts
32
+ - Sustained Use Discounts (automatic)
33
+ - Preemptible VMs and Spot VMs
34
+ - Recommender for right-sizing
35
+ - Active Assist for optimization
36
+
37
+ 5. **Performance Optimization**
38
+ - Cloud CDN and Media CDN
39
+ - Caching strategies (Memorystore)
40
+ - Database performance tuning
41
+ - Network optimization (Premium vs Standard tier)
42
+ - Regional and zonal resource placement
43
+
44
+ ## Core Services Architecture
45
+
46
+ ### Compute
47
+
48
+ **Compute Engine**
49
+ - Machine types: E2 (cost-optimized), N2 (balanced), C2 (compute-optimized), M2 (memory-optimized)
50
+ - Custom machine types for specific needs
51
+ - Preemptible VMs (up to 80% discount, max 24 hours)
52
+ - Spot VMs (similar to preemptible, better availability)
53
+ - Instance groups: Managed (with autoscaling), unmanaged
54
+ - Best practices: Use latest generation, committed use discounts, Spot for batch jobs
55
+
56
+ **Cloud Run**
57
+ - Fully managed serverless container platform
58
+ - Auto-scaling to zero
59
+ - Pay per request
60
+ - CPU allocated only during request handling
61
+ - Best practices: Stateless containers, optimize cold starts, use Cloud Run jobs for batch
62
+
63
+ **Cloud Functions**
64
+ - Event-driven serverless functions
65
+ - 1st gen: HTTP and background functions
66
+ - 2nd gen: Built on Cloud Run, better performance
67
+ - Event sources: Pub/Sub, Cloud Storage, Firestore, HTTP
68
+ - Best practices: Use 2nd gen, minimize cold starts, implement retry logic
69
+
70
+ **Google Kubernetes Engine (GKE)**
71
+ - Managed Kubernetes with GCP integration
72
+ - Autopilot mode: Fully managed, per-pod pricing
73
+ - Standard mode: More control, node management
74
+ - Workload Identity for secure service access
75
+ - Binary Authorization for deployment policies
76
+ - Best practices: Use Autopilot for simplicity, enable Workload Identity, implement network policies
77
+
78
+ **App Engine**
79
+ - Fully managed platform (PaaS)
80
+ - Standard environment (sandboxed, auto-scaling)
81
+ - Flexible environment (Docker containers, custom runtimes)
82
+ - Traffic splitting for canary deployments
83
+ - Best practices: Use Standard for web apps, Flexible for custom dependencies
84
+
85
+ ### Storage
86
+
87
+ **Cloud Storage**
88
+ - Storage classes: Standard, Nearline (30-day), Coldline (90-day), Archive (365-day)
89
+ - Object lifecycle management
90
+ - Object versioning and retention policies
91
+ - Autoclass for automatic tier transitions
92
+ - Requester pays for data transfer
93
+ - Best practices: Use Autoclass, enable versioning, implement lifecycle policies
94
+
95
+ **Persistent Disk**
96
+ - Types: Standard (HDD), Balanced SSD, SSD, Extreme
97
+ - Zonal and regional persistent disks
98
+ - Snapshots for backup (incremental)
99
+ - Disk resize without downtime
100
+ - Best practices: Use Balanced SSD for most workloads, enable snapshots
101
+
102
+ **Filestore**
103
+ - Managed NFS file storage
104
+ - Tiers: Basic (1-63.9 TB), Enterprise (1-10 TB, better performance)
105
+ - Backup to Cloud Storage
106
+ - Best practices: Use Enterprise for production, implement backups
107
+
108
+ **Cloud Storage for Firebase**
109
+ - Object storage for mobile and web apps
110
+ - Client SDKs for direct upload/download
111
+ - Security rules for access control
112
+
113
+ ### Database
114
+
115
+ **Cloud SQL**
116
+ - Managed MySQL, PostgreSQL, SQL Server
117
+ - High availability configuration (regional)
118
+ - Read replicas for scaling
119
+ - Automated backups and point-in-time recovery
120
+ - Best practices: Enable HA, use read replicas, implement connection pooling with Cloud SQL Proxy
121
+
122
+ **Cloud Spanner**
123
+ - Globally distributed relational database
124
+ - Horizontal scalability with strong consistency
125
+ - Multi-region for 99.999% availability
126
+ - TrueTime for global consistency
127
+ - Best practices: Design proper schema splits, use commit timestamps, optimize hotspots
128
+
129
+ **Firestore (Native mode)**
130
+ - NoSQL document database
131
+ - Real-time synchronization
132
+ - Offline support for mobile
133
+ - ACID transactions
134
+ - Best practices: Design document structure carefully, use collection group queries wisely
135
+
136
+ **Bigtable**
137
+ - NoSQL wide-column database
138
+ - Petabyte-scale with single-digit millisecond latency
139
+ - HBase API compatible
140
+ - Linear scalability by adding nodes
141
+ - Best practices: Design row keys to avoid hotspots, use replication for HA
142
+
143
+ **Memorystore**
144
+ - Managed Redis and Memcached
145
+ - Standard tier (HA with replica) and Basic tier
146
+ - Best practices: Use Standard tier for production, implement connection pooling
147
+
148
+ **BigQuery**
149
+ - Serverless data warehouse
150
+ - SQL analytics on petabyte-scale data
151
+ - Column-oriented storage
152
+ - Automatic caching and optimization
153
+ - Best practices: Partition and cluster tables, use approximate functions, control costs with quotas
154
+
155
+ ### Networking
156
+
157
+ **VPC (Virtual Private Cloud)**
158
+ - Global resource (subnets are regional)
159
+ - Custom or auto mode networks
160
+ - Firewall rules (stateful)
161
+ - VPC peering and Shared VPC
162
+ - Private Google Access for GCP services
163
+ - Best practices: Use custom mode VPC, plan IP ranges, implement firewall rules
164
+
165
+ **Cloud Load Balancing**
166
+ - Global load balancing (HTTP(S), TCP/SSL Proxy, external TCP/UDP)
167
+ - Regional load balancing (internal HTTP(S), internal TCP/UDP)
168
+ - Anycast IP for global distribution
169
+ - Backend services with health checks
170
+ - Best practices: Use global for multi-region, enable CDN, configure health checks
171
+
172
+ **Cloud CDN**
173
+ - Global content delivery network
174
+ - Cache invalidation and signed URLs
175
+ - Integration with Cloud Storage and compute
176
+ - Best practices: Enable compression, use cache-control headers
177
+
178
+ **Cloud Interconnect and VPN**
179
+ - Dedicated Interconnect (10 Gbps or 100 Gbps)
180
+ - Partner Interconnect (50 Mbps to 50 Gbps)
181
+ - Cloud VPN (HA VPN for 99.99% SLA)
182
+ - Best practices: Use HA VPN for redundancy, Dedicated Interconnect for high bandwidth
183
+
184
+ **Cloud Armor**
185
+ - DDoS protection and WAF
186
+ - Preconfigured and custom rules
187
+ - Adaptive protection (ML-based)
188
+ - Best practices: Enable for internet-facing services, use preconfigured rules
189
+
190
+ **Private Service Connect**
191
+ - Private connectivity to Google APIs and services
192
+ - Service Directory for service discovery
193
+ - Best practices: Use for all managed services in production
194
+
195
+ ### Serverless and Event-Driven
196
+
197
+ **Pub/Sub**
198
+ - Global message queue
199
+ - At-least-once delivery
200
+ - Push and pull subscriptions
201
+ - Message ordering and filtering
202
+ - Dead-letter topics
203
+ - Best practices: Use message attributes for filtering, implement idempotent processing
204
+
205
+ **Eventarc**
206
+ - Event-driven architecture
207
+ - Triggers for Cloud Run, Workflows, GKE
208
+ - Sources: Audit Logs, Pub/Sub, custom events
209
+ - Best practices: Use for decoupled architectures, implement event filtering
210
+
211
+ **Cloud Scheduler**
212
+ - Fully managed cron service
213
+ - HTTP, Pub/Sub, and App Engine targets
214
+ - Best practices: Use for periodic tasks, implement retry logic
215
+
216
+ **Workflows**
217
+ - Orchestrate and automate GCP and HTTP services
218
+ - YAML-based workflow definition
219
+ - Built-in error handling and retry
220
+ - Best practices: Use for complex multi-step processes, implement compensating transactions
221
+
222
+ ### Security and Identity
223
+
224
+ **Cloud IAM**
225
+ - Resource hierarchy: Organization -> Folders -> Projects -> Resources
226
+ - Roles: Primitive (Owner, Editor, Viewer), Predefined, Custom
227
+ - Service accounts for applications
228
+ - Workload Identity for GKE
229
+ - Best practices: Use predefined roles, least privilege, service accounts for apps
230
+
231
+ **Cloud Key Management (KMS)**
232
+ - Encryption key management
233
+ - Customer-managed encryption keys (CMEK)
234
+ - Hardware Security Module (HSM) backed
235
+ - Automatic key rotation
236
+ - Best practices: Enable automatic rotation, use separate keys per environment
237
+
238
+ **Secret Manager**
239
+ - Store API keys, passwords, certificates
240
+ - Versioning and access control
241
+ - Automatic rotation integration
242
+ - Best practices: Rotate secrets regularly, use IAM for access control
243
+
244
+ **Security Command Center**
245
+ - Centralized security and risk management
246
+ - Asset discovery and vulnerability scanning
247
+ - Threat detection and compliance monitoring
248
+ - Best practices: Enable all detectors, review findings regularly
249
+
250
+ **VPC Service Controls**
251
+ - Create security perimeters around GCP resources
252
+ - Prevent data exfiltration
253
+ - Best practices: Use for sensitive data, implement access levels
254
+
255
+ ### AI and Machine Learning
256
+
257
+ **Vertex AI**
258
+ - Unified ML platform
259
+ - AutoML for custom models
260
+ - Pre-trained models (Vision, Natural Language, etc.)
261
+ - MLOps with pipelines
262
+ - Best practices: Use AutoML for quick start, implement feature store
263
+
264
+ **BigQuery ML**
265
+ - Create and execute ML models using SQL
266
+ - Model types: Linear regression, logistic regression, clustering, etc.
267
+ - Integration with Vertex AI
268
+ - Best practices: Use for simple models, leverage BigQuery's scale
269
+
270
+ ## Architecture Patterns
271
+
272
+ ### High Availability
273
+
274
+ **Multi-Zone Pattern**
275
+ ```
276
+ Global HTTP(S) Load Balancer
277
+ |
278
+ v
279
+ Managed Instance Group (multi-zone)
280
+ |
281
+ v
282
+ Cloud SQL (regional, HA configuration)
283
+ |
284
+ v
285
+ Cloud Storage (multi-region)
286
+ ```
287
+
288
+ **Multi-Region Pattern**
289
+ ```
290
+ Global HTTP(S) Load Balancer
291
+ |
292
+ ├── Backend Service Region 1 (Cloud Run)
293
+ └── Backend Service Region 2 (Cloud Run)
294
+ |
295
+ v
296
+ Cloud Spanner (multi-region)
297
+ ```
298
+
299
+ ### Serverless Architecture
300
+
301
+ **Event-Driven Pattern**
302
+ ```
303
+ Cloud Storage upload event
304
+ |
305
+ v
306
+ Pub/Sub topic
307
+ |
308
+ v
309
+ Cloud Functions (image processing)
310
+ |
311
+ v
312
+ Firestore (metadata storage)
313
+ ```
314
+
315
+ **API-First Pattern**
316
+ ```
317
+ Cloud Endpoints or API Gateway
318
+ |
319
+ v
320
+ Cloud Run (multiple services)
321
+ |
322
+ ├── Cloud SQL (transactional data)
323
+ └── Firestore (user data)
324
+ ```
325
+
326
+ ### Microservices on GKE
327
+
328
+ **GKE with Service Mesh**
329
+ ```
330
+ Global Load Balancer
331
+ |
332
+ v
333
+ GKE Ingress
334
+ |
335
+ v
336
+ Anthos Service Mesh (Istio)
337
+ |
338
+ v
339
+ Microservices (Cloud Spanner, Firestore, Memorystore)
340
+ ```
341
+
342
+ ### Data Analytics Platform
343
+
344
+ ```
345
+ Data Sources
346
+ |
347
+ v
348
+ Pub/Sub (streaming)
349
+ |
350
+ v
351
+ Dataflow (Apache Beam)
352
+ |
353
+ v
354
+ BigQuery (data warehouse)
355
+ |
356
+ v
357
+ Looker or Data Studio (visualization)
358
+ ```
359
+
360
+ **Batch Processing**
361
+ ```
362
+ Cloud Storage (raw data)
363
+ |
364
+ v
365
+ Dataproc (Apache Spark)
366
+ |
367
+ v
368
+ BigQuery (analytics)
369
+ ```
370
+
371
+ ## Landing Zone Design
372
+
373
+ ### Resource Hierarchy
374
+
375
+ ```
376
+ Organization
377
+ ├── Folders (by environment or team)
378
+ │ ├── Production Folder
379
+ │ │ ├── Project A
380
+ │ │ └── Project B
381
+ │ ├── Staging Folder
382
+ │ └── Development Folder
383
+ └── Shared Services Folder
384
+ ├── Networking Project (Shared VPC host)
385
+ ├── Security Project (KMS, Secret Manager)
386
+ └── Logging Project (centralized logs)
387
+ ```
388
+
389
+ ### Network Design
390
+
391
+ **Shared VPC Pattern**
392
+ ```
393
+ Host Project (networking team)
394
+ ├── Shared VPC
395
+ │ ├── Subnet Production (region A)
396
+ │ ├── Subnet Staging (region A)
397
+ │ └── Subnet Development (region B)
398
+
399
+ Service Projects (application teams)
400
+ ├── Production Project (uses Production subnet)
401
+ ├── Staging Project (uses Staging subnet)
402
+ └── Development Project (uses Development subnet)
403
+ ```
404
+
405
+ **Hub-and-Spoke with VPN**
406
+ ```
407
+ On-premises Network
408
+ |
409
+ v
410
+ Cloud VPN / Interconnect
411
+ |
412
+ v
413
+ Hub VPC (shared services)
414
+ |
415
+ ├── Spoke VPC 1 (production workloads)
416
+ ├── Spoke VPC 2 (development workloads)
417
+ └── Spoke VPC 3 (analytics workloads)
418
+ ```
419
+
420
+ ### Governance
421
+
422
+ **Organization Policies**
423
+ - Restrict public IP assignment
424
+ - Enforce uniform bucket-level access
425
+ - Restrict VM external IP
426
+ - Define allowed resource locations
427
+
428
+ **IAM Strategy**
429
+ - Use Google Groups for role assignments
430
+ - Separate duties (network admin, security admin, etc.)
431
+ - Service accounts per application
432
+ - Workload Identity for GKE workloads
433
+
434
+ **Logging and Monitoring**
435
+ ```
436
+ All Projects
437
+ |
438
+ v
439
+ Log Router
440
+ |
441
+ ├── Cloud Logging (default sink)
442
+ ├── BigQuery (long-term analysis)
443
+ ├── Cloud Storage (archive)
444
+ └── Pub/Sub (real-time processing)
445
+ ```
446
+
447
+ ## Migration Strategies
448
+
449
+ ### Migrate to Virtual Machines
450
+
451
+ **Tools**
452
+ - Migrate to Virtual Machines (formerly Migrate for Compute Engine)
453
+ - Supports VMware, AWS, Azure, physical servers
454
+ - Agentless or agent-based migration
455
+ - Waves and test clones
456
+
457
+ **Process**
458
+ 1. Assess: Fit assessment and TCO analysis
459
+ 2. Plan: Group VMs, define migration waves
460
+ 3. Deploy: Set up infrastructure (VPC, firewall rules)
461
+ 4. Migrate: Test migration, cutover, validation
462
+ 5. Optimize: Right-sizing, committed use discounts
463
+
464
+ ### Database Migration
465
+
466
+ **Database Migration Service**
467
+ - Minimal downtime migrations
468
+ - Supports MySQL, PostgreSQL, SQL Server, Oracle
469
+ - Continuous replication for cutover flexibility
470
+
471
+ **Transfer Appliance**
472
+ - Physical device for large data transfers
473
+ - Up to 1 PB capacity
474
+ - Offline data transfer
475
+
476
+ ## Cost Optimization
477
+
478
+ ### Compute Savings
479
+
480
+ **Committed Use Discounts**
481
+ - 1-year or 3-year commitments
482
+ - Up to 57% savings for VMs
483
+ - Resource-based or spend-based
484
+
485
+ **Sustained Use Discounts**
486
+ - Automatic discounts for running VMs >25% of month
487
+ - Up to 30% savings
488
+ - No commitment required
489
+
490
+ **Preemptible and Spot VMs**
491
+ - Up to 80% discount
492
+ - Can be terminated by GCP
493
+ - Best for batch processing, fault-tolerant workloads
494
+
495
+ **Recommender**
496
+ - VM rightsizing recommendations
497
+ - Idle resource identification
498
+ - Committed use discount recommendations
499
+
500
+ ### Storage Savings
501
+
502
+ **Cloud Storage**
503
+ - Autoclass for automatic tier transitions
504
+ - Lifecycle policies (delete or transition)
505
+ - Nearline (30+ days), Coldline (90+ days), Archive (365+ days)
506
+ - Requester pays for data transfer
507
+
508
+ **Persistent Disk**
509
+ - Delete orphaned disks
510
+ - Use balanced SSD instead of SSD when possible
511
+ - Resize disks to match actual usage
512
+
513
+ ### BigQuery Savings
514
+
515
+ **On-Demand Pricing**
516
+ - $5 per TB processed
517
+ - Use partitioning and clustering
518
+ - Query cache for free repeated queries
519
+
520
+ **Flat-Rate Pricing**
521
+ - Predictable costs for heavy users
522
+ - Autoscaling slots available
523
+ - Flex slots for short-term commitments
524
+
525
+ **Best Practices**
526
+ - Use approximate aggregation functions (APPROX_COUNT_DISTINCT)
527
+ - Avoid SELECT *, specify columns
528
+ - Use materialized views for common queries
529
+ - Set up cost controls with custom quotas
530
+
531
+ ### Monitoring Costs
532
+
533
+ **Cloud Billing**
534
+ - Budgets and alerts
535
+ - Cost breakdown by project, service, SKU
536
+ - Export to BigQuery for analysis
537
+ - Recommendations from Active Assist
538
+
539
+ ## Disaster Recovery
540
+
541
+ ### Backup Strategies
542
+
543
+ **VM Backups**
544
+ - Persistent disk snapshots (incremental)
545
+ - Machine images (include metadata and config)
546
+ - Cross-region snapshot copy
547
+ - Snapshot schedules for automation
548
+
549
+ **Database Backups**
550
+ - Cloud SQL: Automated backups (7-365 days retention)
551
+ - Cloud Spanner: Backups on demand or scheduled
552
+ - Firestore: Automated daily exports
553
+ - Bigtable: Backups to Cloud Storage
554
+
555
+ ### High Availability
556
+
557
+ **RTO/RPO Matrix**
558
+
559
+ | Pattern | RPO | RTO | Cost |
560
+ |---------|-----|-----|------|
561
+ | Active-Active Multi-Region | Seconds | Seconds | High |
562
+ | Active-Passive with Replication | Minutes | Minutes | Medium |
563
+ | Warm Standby | Minutes | 10-30 min | Medium |
564
+ | Backup and Restore | Hours | Hours | Low |
565
+
566
+ **Cloud SQL HA**
567
+ - Regional configuration with synchronous replication
568
+ - Automatic failover
569
+ - 99.95% SLA (vs 99.5% for single zone)
570
+
571
+ **Cloud Spanner**
572
+ - Multi-region configuration
573
+ - 99.999% availability SLA
574
+ - Synchronous replication across regions
575
+
576
+ ### Disaster Recovery Testing
577
+
578
+ - Regular DR drills (quarterly recommended)
579
+ - Document runbooks
580
+ - Test restoration procedures
581
+ - Measure actual RTO/RPO vs targets
582
+
583
+ ## Monitoring and Observability
584
+
585
+ ### Cloud Monitoring (formerly Stackdriver)
586
+
587
+ **Metrics**
588
+ - System metrics (CPU, memory, disk, network)
589
+ - Custom metrics via Cloud Monitoring API
590
+ - Metric scopes for multi-project monitoring
591
+ - Uptime checks for availability
592
+
593
+ **Dashboards and Charts**
594
+ - Predefined dashboards for GCP services
595
+ - Custom dashboards with filters and grouping
596
+ - SLO monitoring with error budgets
597
+
598
+ ### Cloud Logging
599
+
600
+ **Log Types**
601
+ - Admin Activity logs (always enabled, no charge)
602
+ - Data Access logs (must be enabled)
603
+ - System Event logs
604
+ - Access Transparency logs (for Google access)
605
+
606
+ **Log Sinks**
607
+ - Route logs to BigQuery, Cloud Storage, Pub/Sub
608
+ - Aggregated sinks at organization/folder level
609
+ - Exclusion filters to reduce costs
610
+
611
+ ### Cloud Trace
612
+
613
+ **Distributed Tracing**
614
+ - Automatic instrumentation for App Engine, Cloud Run, GKE
615
+ - Manual instrumentation with client libraries
616
+ - Latency analysis and performance insights
617
+ - Integration with Zipkin
618
+
619
+ ### Cloud Profiler
620
+
621
+ **Continuous Profiling**
622
+ - CPU and memory profiling
623
+ - Low overhead (< 0.5% CPU)
624
+ - Flame graphs for visualization
625
+ - Supported languages: Java, Go, Python, Node.js
626
+
627
+ ### Error Reporting
628
+
629
+ **Aggregated Error Tracking**
630
+ - Automatic error grouping
631
+ - Stack trace analysis
632
+ - Integration with Cloud Logging
633
+ - Notifications for new errors