@heyai-rules/pilo-masterkit 1.2.2 → 2.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (708) hide show
  1. package/.agent/agents/PILO_MASTER.md +77 -77
  2. package/.agent/agents/backend-specialist.md +263 -263
  3. package/.agent/agents/code-archaeologist.md +106 -106
  4. package/.agent/agents/csharp-reviewer.md +101 -0
  5. package/.agent/agents/dart-build-resolver.md +201 -0
  6. package/.agent/agents/database-architect.md +226 -226
  7. package/.agent/agents/debugger.md +225 -225
  8. package/.agent/agents/devops-engineer.md +242 -242
  9. package/.agent/agents/documentation-writer.md +104 -104
  10. package/.agent/agents/explorer-agent.md +73 -73
  11. package/.agent/agents/frontend-specialist.md +593 -593
  12. package/.agent/agents/game-developer.md +162 -162
  13. package/.agent/agents/gan-evaluator.md +209 -0
  14. package/.agent/agents/gan-generator.md +131 -0
  15. package/.agent/agents/gan-planner.md +99 -0
  16. package/.agent/agents/healthcare-reviewer.md +83 -0
  17. package/.agent/agents/mobile-developer.md +377 -377
  18. package/.agent/agents/opensource-forker.md +198 -0
  19. package/.agent/agents/opensource-packager.md +249 -0
  20. package/.agent/agents/opensource-sanitizer.md +188 -0
  21. package/.agent/agents/orchestrator.md +416 -416
  22. package/.agent/agents/penetration-tester.md +188 -188
  23. package/.agent/agents/performance-optimizer.md +446 -187
  24. package/.agent/agents/personas/athena-agent/agent.json +10 -0
  25. package/.agent/agents/personas/athena-agent/athena-backend-logic-architecture-profile.md +189 -0
  26. package/.agent/agents/personas/athena-agent/context-files/agents.md +55 -0
  27. package/.agent/agents/personas/athena-agent/context-files/identity.md +23 -0
  28. package/.agent/agents/personas/athena-agent/context-files/soul.md +51 -0
  29. package/.agent/agents/personas/athena-agent/context-files/user-predefined.md +15 -0
  30. package/.agent/agents/personas/athena-agent/user-context-files/system/bootstrap.md +37 -0
  31. package/.agent/agents/personas/athena-agent/user-context-files/system/user.md +45 -0
  32. package/.agent/agents/personas/da-vinci-agent/agent.json +10 -0
  33. package/.agent/agents/personas/da-vinci-agent/context-files/agents.md +55 -0
  34. package/.agent/agents/personas/da-vinci-agent/context-files/identity.md +23 -0
  35. package/.agent/agents/personas/da-vinci-agent/context-files/soul.md +51 -0
  36. package/.agent/agents/personas/da-vinci-agent/context-files/user-predefined.md +15 -0
  37. package/.agent/agents/personas/da-vinci-agent/da-vinci-frontend-ui-ux-design-profile.md +189 -0
  38. package/.agent/agents/personas/da-vinci-agent/user-context-files/system/bootstrap.md +37 -0
  39. package/.agent/agents/personas/da-vinci-agent/user-context-files/system/user.md +45 -0
  40. package/.agent/agents/personas/duong-tang-agent/agent.json +10 -0
  41. package/.agent/agents/personas/duong-tang-agent/context-files/agents.md +55 -0
  42. package/.agent/agents/personas/duong-tang-agent/context-files/identity.md +23 -0
  43. package/.agent/agents/personas/duong-tang-agent/context-files/soul.md +51 -0
  44. package/.agent/agents/personas/duong-tang-agent/context-files/user-predefined.md +15 -0
  45. package/.agent/agents/personas/duong-tang-agent/tang-monk-quality-testing-documentation-profile.md +189 -0
  46. package/.agent/agents/personas/duong-tang-agent/user-context-files/system/bootstrap.md +37 -0
  47. package/.agent/agents/personas/duong-tang-agent/user-context-files/system/user.md +45 -0
  48. package/.agent/agents/personas/gia-cat-luong-agent/agent.json +10 -0
  49. package/.agent/agents/personas/gia-cat-luong-agent/context-files/agents.md +55 -0
  50. package/.agent/agents/personas/gia-cat-luong-agent/context-files/identity.md +23 -0
  51. package/.agent/agents/personas/gia-cat-luong-agent/context-files/soul.md +51 -0
  52. package/.agent/agents/personas/gia-cat-luong-agent/context-files/user-predefined.md +15 -0
  53. package/.agent/agents/personas/gia-cat-luong-agent/kongming-research-strategy-analysis-profile.md +189 -0
  54. package/.agent/agents/personas/gia-cat-luong-agent/user-context-files/system/bootstrap.md +37 -0
  55. package/.agent/agents/personas/gia-cat-luong-agent/user-context-files/system/user.md +45 -0
  56. package/.agent/agents/personas/mihata-agent/agent.json +10 -0
  57. package/.agent/agents/personas/mihata-agent/context-files/agents.md +55 -0
  58. package/.agent/agents/personas/mihata-agent/context-files/identity.md +23 -0
  59. package/.agent/agents/personas/mihata-agent/context-files/soul.md +51 -0
  60. package/.agent/agents/personas/mihata-agent/context-files/user-predefined.md +15 -0
  61. package/.agent/agents/personas/mihata-agent/mihata-multi-agent-orchestration-profile.md +189 -0
  62. package/.agent/agents/personas/mihata-agent/user-context-files/system/bootstrap.md +37 -0
  63. package/.agent/agents/personas/mihata-agent/user-context-files/system/user.md +45 -0
  64. package/.agent/agents/personas/tesla-agent/agent.json +10 -0
  65. package/.agent/agents/personas/tesla-agent/context-files/agents.md +55 -0
  66. package/.agent/agents/personas/tesla-agent/context-files/identity.md +23 -0
  67. package/.agent/agents/personas/tesla-agent/context-files/soul.md +51 -0
  68. package/.agent/agents/personas/tesla-agent/context-files/user-predefined.md +15 -0
  69. package/.agent/agents/personas/tesla-agent/tesla-fullstack-system-optimization-profile.md +189 -0
  70. package/.agent/agents/personas/tesla-agent/user-context-files/system/bootstrap.md +37 -0
  71. package/.agent/agents/personas/tesla-agent/user-context-files/system/user.md +45 -0
  72. package/.agent/agents/personas/tu-ma-y-agent/agent.json +10 -0
  73. package/.agent/agents/personas/tu-ma-y-agent/context-files/agents.md +55 -0
  74. package/.agent/agents/personas/tu-ma-y-agent/context-files/identity.md +23 -0
  75. package/.agent/agents/personas/tu-ma-y-agent/context-files/soul.md +51 -0
  76. package/.agent/agents/personas/tu-ma-y-agent/context-files/user-predefined.md +15 -0
  77. package/.agent/agents/personas/tu-ma-y-agent/simayi-feasibility-risk-control-profile.md +189 -0
  78. package/.agent/agents/personas/tu-ma-y-agent/user-context-files/system/bootstrap.md +37 -0
  79. package/.agent/agents/personas/tu-ma-y-agent/user-context-files/system/user.md +45 -0
  80. package/.agent/agents/personas/venti-agent/agent.json +10 -0
  81. package/.agent/agents/personas/venti-agent/context-files/agents.md +55 -0
  82. package/.agent/agents/personas/venti-agent/context-files/identity.md +23 -0
  83. package/.agent/agents/personas/venti-agent/context-files/soul.md +51 -0
  84. package/.agent/agents/personas/venti-agent/context-files/user-predefined.md +15 -0
  85. package/.agent/agents/personas/venti-agent/user-context-files/system/bootstrap.md +37 -0
  86. package/.agent/agents/personas/venti-agent/user-context-files/system/user.md +45 -0
  87. package/.agent/agents/personas/venti-agent/venti-learning-communication-mentoring-profile.md +189 -0
  88. package/.agent/agents/product-manager.md +112 -112
  89. package/.agent/agents/product-owner.md +95 -95
  90. package/.agent/agents/project-planner.md +406 -406
  91. package/.agent/agents/qa-automation-engineer.md +103 -103
  92. package/.agent/agents/security-auditor.md +170 -170
  93. package/.agent/agents/seo-specialist.md +111 -111
  94. package/.agent/agents/test-engineer.md +158 -158
  95. package/.agent/contexts/dev.md +20 -0
  96. package/.agent/contexts/research.md +26 -0
  97. package/.agent/contexts/review.md +22 -0
  98. package/.agent/hooks/hooks.json +395 -0
  99. package/.agent/hooks/readme.md +222 -0
  100. package/.agent/mcp-configs/mcp-servers.json +181 -0
  101. package/.agent/rules/ARCHITECTURAL_BLUEPRINTS.md +62 -62
  102. package/.agent/rules/CODE_CRAFTSMANSHIP.md +69 -69
  103. package/.agent/rules/CORE_RULES.md +72 -72
  104. package/.agent/rules/PROJECT_MAP.md +58 -58
  105. package/.agent/rules/QUALITY_ASSURANCE.md +54 -54
  106. package/.agent/rules/SECURITY_ARMOR.md +44 -44
  107. package/.agent/rules/VERSION_ORCHESTRATION.md +64 -64
  108. package/.agent/rules/WORKFLOW_ORCHESTRATION.md +55 -55
  109. package/.agent/rules/common/agents.md +50 -0
  110. package/.agent/rules/common/code-review.md +124 -0
  111. package/.agent/rules/common/coding-style.md +48 -0
  112. package/.agent/rules/common/development-workflow.md +44 -0
  113. package/.agent/rules/common/git-workflow.md +24 -0
  114. package/.agent/rules/common/hooks.md +30 -0
  115. package/.agent/rules/common/patterns.md +31 -0
  116. package/.agent/rules/common/performance.md +55 -0
  117. package/.agent/rules/common/security.md +29 -0
  118. package/.agent/rules/common/testing.md +29 -0
  119. package/.agent/rules/cpp/coding-style.md +44 -0
  120. package/.agent/rules/cpp/hooks.md +39 -0
  121. package/.agent/rules/cpp/patterns.md +51 -0
  122. package/.agent/rules/cpp/security.md +51 -0
  123. package/.agent/rules/cpp/testing.md +44 -0
  124. package/.agent/rules/csharp/coding-style.md +72 -0
  125. package/.agent/rules/csharp/hooks.md +25 -0
  126. package/.agent/rules/csharp/patterns.md +50 -0
  127. package/.agent/rules/csharp/security.md +58 -0
  128. package/.agent/rules/csharp/testing.md +46 -0
  129. package/.agent/rules/dart/coding-style.md +159 -0
  130. package/.agent/rules/dart/hooks.md +66 -0
  131. package/.agent/rules/dart/patterns.md +261 -0
  132. package/.agent/rules/dart/security.md +135 -0
  133. package/.agent/rules/dart/testing.md +215 -0
  134. package/.agent/rules/golang/coding-style.md +32 -0
  135. package/.agent/rules/golang/hooks.md +17 -0
  136. package/.agent/rules/golang/patterns.md +45 -0
  137. package/.agent/rules/golang/security.md +34 -0
  138. package/.agent/rules/golang/testing.md +31 -0
  139. package/.agent/rules/java/coding-style.md +114 -0
  140. package/.agent/rules/java/hooks.md +18 -0
  141. package/.agent/rules/java/patterns.md +146 -0
  142. package/.agent/rules/java/security.md +100 -0
  143. package/.agent/rules/java/testing.md +131 -0
  144. package/.agent/rules/kotlin/coding-style.md +86 -0
  145. package/.agent/rules/kotlin/hooks.md +17 -0
  146. package/.agent/rules/kotlin/patterns.md +146 -0
  147. package/.agent/rules/kotlin/security.md +82 -0
  148. package/.agent/rules/kotlin/testing.md +128 -0
  149. package/.agent/rules/perl/coding-style.md +46 -0
  150. package/.agent/rules/perl/hooks.md +22 -0
  151. package/.agent/rules/perl/patterns.md +76 -0
  152. package/.agent/rules/perl/security.md +69 -0
  153. package/.agent/rules/perl/testing.md +54 -0
  154. package/.agent/rules/php/coding-style.md +40 -0
  155. package/.agent/rules/php/hooks.md +24 -0
  156. package/.agent/rules/php/patterns.md +33 -0
  157. package/.agent/rules/php/security.md +37 -0
  158. package/.agent/rules/php/testing.md +39 -0
  159. package/.agent/rules/python/coding-style.md +42 -0
  160. package/.agent/rules/python/hooks.md +19 -0
  161. package/.agent/rules/python/patterns.md +39 -0
  162. package/.agent/rules/python/security.md +30 -0
  163. package/.agent/rules/python/testing.md +38 -0
  164. package/.agent/rules/readme.md +111 -0
  165. package/.agent/rules/rust/coding-style.md +151 -0
  166. package/.agent/rules/rust/hooks.md +16 -0
  167. package/.agent/rules/rust/patterns.md +168 -0
  168. package/.agent/rules/rust/security.md +141 -0
  169. package/.agent/rules/rust/testing.md +154 -0
  170. package/.agent/rules/swift/coding-style.md +47 -0
  171. package/.agent/rules/swift/hooks.md +20 -0
  172. package/.agent/rules/swift/patterns.md +66 -0
  173. package/.agent/rules/swift/security.md +33 -0
  174. package/.agent/rules/swift/testing.md +45 -0
  175. package/.agent/rules/typescript/coding-style.md +199 -0
  176. package/.agent/rules/typescript/hooks.md +22 -0
  177. package/.agent/rules/typescript/patterns.md +52 -0
  178. package/.agent/rules/typescript/security.md +28 -0
  179. package/.agent/rules/typescript/testing.md +18 -0
  180. package/.agent/rules/web/coding-style.md +96 -0
  181. package/.agent/rules/web/design-quality.md +63 -0
  182. package/.agent/rules/web/hooks.md +120 -0
  183. package/.agent/rules/web/patterns.md +79 -0
  184. package/.agent/rules/web/performance.md +64 -0
  185. package/.agent/rules/web/security.md +57 -0
  186. package/.agent/rules/web/testing.md +55 -0
  187. package/.agent/rules/zh/agents.md +50 -0
  188. package/.agent/rules/zh/code-review.md +124 -0
  189. package/.agent/rules/zh/coding-style.md +48 -0
  190. package/.agent/rules/zh/development-workflow.md +44 -0
  191. package/.agent/rules/zh/git-workflow.md +24 -0
  192. package/.agent/rules/zh/hooks.md +30 -0
  193. package/.agent/rules/zh/patterns.md +31 -0
  194. package/.agent/rules/zh/performance.md +55 -0
  195. package/.agent/rules/zh/readme.md +108 -0
  196. package/.agent/rules/zh/security.md +29 -0
  197. package/.agent/rules/zh/testing.md +29 -0
  198. package/.agent/scripts/auto_preview.py +148 -148
  199. package/.agent/scripts/checklist.py +217 -217
  200. package/.agent/scripts/session_manager.py +120 -120
  201. package/.agent/scripts/verify_all.py +327 -327
  202. package/.agent/skills/agent-eval/SKILL.md +145 -0
  203. package/.agent/skills/agent-harness-construction/SKILL.md +73 -0
  204. package/.agent/skills/agent-payment-x402/SKILL.md +178 -0
  205. package/.agent/skills/agentic-engineering/SKILL.md +63 -0
  206. package/.agent/skills/ai-first-engineering/SKILL.md +51 -0
  207. package/.agent/skills/ai-regression-testing/SKILL.md +385 -0
  208. package/.agent/skills/android-clean-architecture/SKILL.md +339 -0
  209. package/.agent/skills/api-design/SKILL.md +523 -0
  210. package/.agent/skills/api-patterns/SKILL.md +81 -81
  211. package/.agent/skills/api-patterns/api-style.md +42 -42
  212. package/.agent/skills/api-patterns/auth.md +24 -24
  213. package/.agent/skills/api-patterns/documentation.md +26 -26
  214. package/.agent/skills/api-patterns/graphql.md +41 -41
  215. package/.agent/skills/api-patterns/rate-limiting.md +31 -31
  216. package/.agent/skills/api-patterns/response.md +37 -37
  217. package/.agent/skills/api-patterns/rest.md +40 -40
  218. package/.agent/skills/api-patterns/scripts/api_validator.py +211 -211
  219. package/.agent/skills/api-patterns/security-testing.md +122 -122
  220. package/.agent/skills/api-patterns/trpc.md +41 -41
  221. package/.agent/skills/api-patterns/versioning.md +22 -22
  222. package/.agent/skills/app-builder/SKILL.md +75 -75
  223. package/.agent/skills/app-builder/agent-coordination.md +71 -71
  224. package/.agent/skills/app-builder/feature-building.md +53 -53
  225. package/.agent/skills/app-builder/project-detection.md +34 -34
  226. package/.agent/skills/app-builder/scaffolding.md +118 -118
  227. package/.agent/skills/app-builder/tech-stack.md +41 -41
  228. package/.agent/skills/app-builder/templates/SKILL.md +39 -39
  229. package/.agent/skills/app-builder/templates/astro-static/TEMPLATE.md +76 -76
  230. package/.agent/skills/app-builder/templates/chrome-extension/TEMPLATE.md +92 -92
  231. package/.agent/skills/app-builder/templates/cli-tool/TEMPLATE.md +88 -88
  232. package/.agent/skills/app-builder/templates/electron-desktop/TEMPLATE.md +88 -88
  233. package/.agent/skills/app-builder/templates/express-api/TEMPLATE.md +83 -83
  234. package/.agent/skills/app-builder/templates/flutter-app/TEMPLATE.md +90 -90
  235. package/.agent/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md +90 -90
  236. package/.agent/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +122 -122
  237. package/.agent/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +122 -122
  238. package/.agent/skills/app-builder/templates/nextjs-static/TEMPLATE.md +169 -169
  239. package/.agent/skills/app-builder/templates/nuxt-app/TEMPLATE.md +134 -134
  240. package/.agent/skills/app-builder/templates/python-fastapi/TEMPLATE.md +83 -83
  241. package/.agent/skills/app-builder/templates/react-native-app/TEMPLATE.md +119 -119
  242. package/.agent/skills/architecture/SKILL.md +55 -55
  243. package/.agent/skills/architecture/context-discovery.md +43 -43
  244. package/.agent/skills/architecture/examples.md +94 -94
  245. package/.agent/skills/architecture/pattern-selection.md +68 -68
  246. package/.agent/skills/architecture/patterns-reference.md +50 -50
  247. package/.agent/skills/architecture/trade-off-analysis.md +77 -77
  248. package/.agent/skills/architecture-decision-records/SKILL.md +179 -0
  249. package/.agent/skills/article-writing/SKILL.md +79 -0
  250. package/.agent/skills/autonomous-agent-harness/SKILL.md +267 -0
  251. package/.agent/skills/autonomous-loops/SKILL.md +610 -0
  252. package/.agent/skills/backend-patterns/SKILL.md +598 -0
  253. package/.agent/skills/bash-linux/SKILL.md +199 -199
  254. package/.agent/skills/behavioral-modes/SKILL.md +242 -242
  255. package/.agent/skills/benchmark/SKILL.md +93 -0
  256. package/.agent/skills/blueprint/SKILL.md +105 -0
  257. package/.agent/skills/brainstorming/SKILL.md +163 -163
  258. package/.agent/skills/brainstorming/dynamic-questioning.md +350 -350
  259. package/.agent/skills/brand-voice/SKILL.md +97 -0
  260. package/.agent/skills/brand-voice/references/voice-profile-schema.md +55 -0
  261. package/.agent/skills/browser-qa/SKILL.md +87 -0
  262. package/.agent/skills/bun-runtime/SKILL.md +84 -0
  263. package/.agent/skills/canary-watch/SKILL.md +99 -0
  264. package/.agent/skills/carrier-relationship-management/SKILL.md +212 -0
  265. package/.agent/skills/ck/SKILL.md +147 -0
  266. package/.agent/skills/ck/commands/forget.mjs +44 -0
  267. package/.agent/skills/ck/commands/info.mjs +24 -0
  268. package/.agent/skills/ck/commands/init.mjs +143 -0
  269. package/.agent/skills/ck/commands/list.mjs +40 -0
  270. package/.agent/skills/ck/commands/migrate.mjs +202 -0
  271. package/.agent/skills/ck/commands/resume.mjs +36 -0
  272. package/.agent/skills/ck/commands/save.mjs +210 -0
  273. package/.agent/skills/ck/commands/shared.mjs +387 -0
  274. package/.agent/skills/ck/hooks/session-start.mjs +224 -0
  275. package/.agent/skills/claude-api/SKILL.md +337 -0
  276. package/.agent/skills/claude-devfleet/SKILL.md +103 -0
  277. package/.agent/skills/clean-code/SKILL.md +201 -201
  278. package/.agent/skills/click-path-audit/SKILL.md +244 -0
  279. package/.agent/skills/clickhouse-io/SKILL.md +439 -0
  280. package/.agent/skills/code-review-checklist/SKILL.md +109 -109
  281. package/.agent/skills/codebase-onboarding/SKILL.md +233 -0
  282. package/.agent/skills/coding-standards/SKILL.md +530 -0
  283. package/.agent/skills/compose-multiplatform-patterns/SKILL.md +299 -0
  284. package/.agent/skills/configure-ecc/SKILL.md +367 -0
  285. package/.agent/skills/connections-optimizer/SKILL.md +189 -0
  286. package/.agent/skills/content-engine/SKILL.md +131 -0
  287. package/.agent/skills/content-hash-cache-pattern/SKILL.md +161 -0
  288. package/.agent/skills/context-budget/SKILL.md +135 -0
  289. package/.agent/skills/continuous-agent-loop/SKILL.md +45 -0
  290. package/.agent/skills/continuous-learning/SKILL.md +119 -0
  291. package/.agent/skills/continuous-learning/config.json +18 -0
  292. package/.agent/skills/continuous-learning/evaluate-session.sh +69 -0
  293. package/.agent/skills/continuous-learning-v2/SKILL.md +365 -0
  294. package/.agent/skills/continuous-learning-v2/agents/observer-loop.sh +271 -0
  295. package/.agent/skills/continuous-learning-v2/agents/observer.md +198 -0
  296. package/.agent/skills/continuous-learning-v2/agents/session-guardian.sh +150 -0
  297. package/.agent/skills/continuous-learning-v2/agents/start-observer.sh +244 -0
  298. package/.agent/skills/continuous-learning-v2/config.json +8 -0
  299. package/.agent/skills/continuous-learning-v2/hooks/observe.sh +428 -0
  300. package/.agent/skills/continuous-learning-v2/scripts/detect-project.sh +228 -0
  301. package/.agent/skills/continuous-learning-v2/scripts/instinct-cli.py +1426 -0
  302. package/.agent/skills/continuous-learning-v2/scripts/test-parse-instinct.py +984 -0
  303. package/.agent/skills/cost-aware-llm-pipeline/SKILL.md +183 -0
  304. package/.agent/skills/cpp-coding-standards/SKILL.md +723 -0
  305. package/.agent/skills/cpp-testing/SKILL.md +324 -0
  306. package/.agent/skills/crosspost/SKILL.md +111 -0
  307. package/.agent/skills/csharp-testing/SKILL.md +321 -0
  308. package/.agent/skills/customer-billing-ops/SKILL.md +140 -0
  309. package/.agent/skills/customs-trade-compliance/SKILL.md +263 -0
  310. package/.agent/skills/dart-flutter-patterns/SKILL.md +563 -0
  311. package/.agent/skills/data-scraper-agent/SKILL.md +764 -0
  312. package/.agent/skills/database-design/SKILL.md +52 -52
  313. package/.agent/skills/database-design/database-selection.md +43 -43
  314. package/.agent/skills/database-design/indexing.md +39 -39
  315. package/.agent/skills/database-design/migrations.md +48 -48
  316. package/.agent/skills/database-design/optimization.md +36 -36
  317. package/.agent/skills/database-design/orm-selection.md +30 -30
  318. package/.agent/skills/database-design/schema-design.md +56 -56
  319. package/.agent/skills/database-design/scripts/schema_validator.py +172 -172
  320. package/.agent/skills/database-migrations/SKILL.md +429 -0
  321. package/.agent/skills/deep-research/SKILL.md +155 -0
  322. package/.agent/skills/deployment-patterns/SKILL.md +427 -0
  323. package/.agent/skills/deployment-procedures/SKILL.md +241 -241
  324. package/.agent/skills/design-system/SKILL.md +82 -0
  325. package/.agent/skills/django-patterns/SKILL.md +734 -0
  326. package/.agent/skills/django-security/SKILL.md +593 -0
  327. package/.agent/skills/django-tdd/SKILL.md +729 -0
  328. package/.agent/skills/django-verification/SKILL.md +469 -0
  329. package/.agent/skills/dmux-workflows/SKILL.md +191 -0
  330. package/.agent/skills/doc.md +177 -177
  331. package/.agent/skills/docker-patterns/SKILL.md +364 -0
  332. package/.agent/skills/documentation-lookup/SKILL.md +90 -0
  333. package/.agent/skills/documentation-templates/SKILL.md +194 -194
  334. package/.agent/skills/dotnet-patterns/SKILL.md +321 -0
  335. package/.agent/skills/e2e-testing/SKILL.md +326 -0
  336. package/.agent/skills/energy-procurement/SKILL.md +228 -0
  337. package/.agent/skills/enterprise-agent-ops/SKILL.md +50 -0
  338. package/.agent/skills/eval-harness/SKILL.md +270 -0
  339. package/.agent/skills/exa-search/SKILL.md +103 -0
  340. package/.agent/skills/fal-ai-media/SKILL.md +284 -0
  341. package/.agent/skills/flutter-dart-code-review/SKILL.md +435 -0
  342. package/.agent/skills/foundation-models-on-device/SKILL.md +243 -0
  343. package/.agent/skills/frontend-design/SKILL.md +452 -452
  344. package/.agent/skills/frontend-design/animation-guide.md +331 -331
  345. package/.agent/skills/frontend-design/color-system.md +311 -311
  346. package/.agent/skills/frontend-design/decision-trees.md +418 -418
  347. package/.agent/skills/frontend-design/motion-graphics.md +306 -306
  348. package/.agent/skills/frontend-design/scripts/accessibility_checker.py +183 -183
  349. package/.agent/skills/frontend-design/scripts/ux_audit.py +722 -722
  350. package/.agent/skills/frontend-design/typography-system.md +345 -345
  351. package/.agent/skills/frontend-design/ux-psychology.md +1116 -1116
  352. package/.agent/skills/frontend-design/visual-effects.md +383 -383
  353. package/.agent/skills/frontend-patterns/SKILL.md +642 -0
  354. package/.agent/skills/frontend-slides/SKILL.md +184 -0
  355. package/.agent/skills/frontend-slides/style-presets.md +330 -0
  356. package/.agent/skills/game-development/2d-games/SKILL.md +119 -119
  357. package/.agent/skills/game-development/3d-games/SKILL.md +135 -135
  358. package/.agent/skills/game-development/SKILL.md +167 -167
  359. package/.agent/skills/game-development/game-art/SKILL.md +185 -185
  360. package/.agent/skills/game-development/game-audio/SKILL.md +190 -190
  361. package/.agent/skills/game-development/game-design/SKILL.md +129 -129
  362. package/.agent/skills/game-development/mobile-games/SKILL.md +108 -108
  363. package/.agent/skills/game-development/multiplayer/SKILL.md +132 -132
  364. package/.agent/skills/game-development/pc-games/SKILL.md +144 -144
  365. package/.agent/skills/game-development/vr-ar/SKILL.md +123 -123
  366. package/.agent/skills/game-development/web-games/SKILL.md +150 -150
  367. package/.agent/skills/gan-style-harness/SKILL.md +278 -0
  368. package/.agent/skills/geo-fundamentals/SKILL.md +156 -156
  369. package/.agent/skills/geo-fundamentals/scripts/geo_checker.py +289 -289
  370. package/.agent/skills/git-workflow/SKILL.md +715 -0
  371. package/.agent/skills/golang-patterns/SKILL.md +674 -0
  372. package/.agent/skills/golang-testing/SKILL.md +720 -0
  373. package/.agent/skills/google-workspace-ops/SKILL.md +95 -0
  374. package/.agent/skills/healthcare-cdss-patterns/SKILL.md +245 -0
  375. package/.agent/skills/healthcare-emr-patterns/SKILL.md +159 -0
  376. package/.agent/skills/healthcare-eval-harness/SKILL.md +207 -0
  377. package/.agent/skills/healthcare-phi-compliance/SKILL.md +145 -0
  378. package/.agent/skills/hexagonal-architecture/SKILL.md +276 -0
  379. package/.agent/skills/i18n-localization/SKILL.md +154 -154
  380. package/.agent/skills/i18n-localization/scripts/i18n_checker.py +241 -241
  381. package/.agent/skills/intelligent-routing/SKILL.md +335 -335
  382. package/.agent/skills/inventory-demand-planning/SKILL.md +247 -0
  383. package/.agent/skills/investor-materials/SKILL.md +96 -0
  384. package/.agent/skills/investor-outreach/SKILL.md +91 -0
  385. package/.agent/skills/iterative-retrieval/SKILL.md +211 -0
  386. package/.agent/skills/java-coding-standards/SKILL.md +147 -0
  387. package/.agent/skills/jira-integration/SKILL.md +293 -0
  388. package/.agent/skills/jpa-patterns/SKILL.md +151 -0
  389. package/.agent/skills/kotlin-coroutines-flows/SKILL.md +284 -0
  390. package/.agent/skills/kotlin-exposed-patterns/SKILL.md +719 -0
  391. package/.agent/skills/kotlin-ktor-patterns/SKILL.md +689 -0
  392. package/.agent/skills/kotlin-patterns/SKILL.md +711 -0
  393. package/.agent/skills/kotlin-testing/SKILL.md +824 -0
  394. package/.agent/skills/laravel-patterns/SKILL.md +415 -0
  395. package/.agent/skills/laravel-plugin-discovery/SKILL.md +229 -0
  396. package/.agent/skills/laravel-security/SKILL.md +285 -0
  397. package/.agent/skills/laravel-tdd/SKILL.md +283 -0
  398. package/.agent/skills/laravel-verification/SKILL.md +179 -0
  399. package/.agent/skills/lead-intelligence/SKILL.md +321 -0
  400. package/.agent/skills/lead-intelligence/agents/enrichment-agent.md +85 -0
  401. package/.agent/skills/lead-intelligence/agents/mutual-mapper.md +75 -0
  402. package/.agent/skills/lead-intelligence/agents/outreach-drafter.md +98 -0
  403. package/.agent/skills/lead-intelligence/agents/signal-scorer.md +60 -0
  404. package/.agent/skills/lint-and-validate/SKILL.md +45 -45
  405. package/.agent/skills/lint-and-validate/scripts/lint_runner.py +184 -184
  406. package/.agent/skills/lint-and-validate/scripts/type_coverage.py +173 -173
  407. package/.agent/skills/liquid-glass-design/SKILL.md +279 -0
  408. package/.agent/skills/logistics-exception-management/SKILL.md +222 -0
  409. package/.agent/skills/manim-video/SKILL.md +89 -0
  410. package/.agent/skills/manim-video/assets/network-graph-scene.py +52 -0
  411. package/.agent/skills/market-research/SKILL.md +75 -0
  412. package/.agent/skills/mcp-builder/SKILL.md +173 -113
  413. package/.agent/skills/mcp-builder/license.txt +202 -0
  414. package/.agent/skills/mcp-builder/reference/evaluation.md +602 -0
  415. package/.agent/skills/mcp-builder/reference/mcp-best-practices.md +249 -0
  416. package/.agent/skills/mcp-builder/reference/node-mcp-server.md +970 -0
  417. package/.agent/skills/mcp-builder/reference/python-mcp-server.md +719 -0
  418. package/.agent/skills/mcp-builder/scripts/connections.py +151 -0
  419. package/.agent/skills/mcp-builder/scripts/evaluation.py +373 -0
  420. package/.agent/skills/mcp-builder/scripts/example-evaluation.xml +22 -0
  421. package/.agent/skills/mcp-builder/scripts/requirements.txt +2 -0
  422. package/.agent/skills/mcp-server-patterns/SKILL.md +67 -0
  423. package/.agent/skills/mobile-design/SKILL.md +394 -394
  424. package/.agent/skills/mobile-design/decision-trees.md +516 -516
  425. package/.agent/skills/mobile-design/mobile-backend.md +491 -491
  426. package/.agent/skills/mobile-design/mobile-color-system.md +420 -420
  427. package/.agent/skills/mobile-design/mobile-debugging.md +122 -122
  428. package/.agent/skills/mobile-design/mobile-design-thinking.md +357 -357
  429. package/.agent/skills/mobile-design/mobile-navigation.md +458 -458
  430. package/.agent/skills/mobile-design/mobile-performance.md +767 -767
  431. package/.agent/skills/mobile-design/mobile-testing.md +356 -356
  432. package/.agent/skills/mobile-design/mobile-typography.md +433 -433
  433. package/.agent/skills/mobile-design/platform-android.md +666 -666
  434. package/.agent/skills/mobile-design/platform-ios.md +561 -561
  435. package/.agent/skills/mobile-design/scripts/mobile_audit.py +670 -670
  436. package/.agent/skills/mobile-design/touch-psychology.md +537 -537
  437. package/.agent/skills/nanoclaw-repl/SKILL.md +33 -0
  438. package/.agent/skills/nestjs-patterns/SKILL.md +230 -0
  439. package/.agent/skills/nextjs-react-expert/1-async-eliminating-waterfalls.md +351 -351
  440. package/.agent/skills/nextjs-react-expert/2-bundle-bundle-size-optimization.md +240 -240
  441. package/.agent/skills/nextjs-react-expert/3-server-server-side-performance.md +490 -490
  442. package/.agent/skills/nextjs-react-expert/4-client-client-side-data-fetching.md +264 -264
  443. package/.agent/skills/nextjs-react-expert/5-rerender-re-render-optimization.md +581 -581
  444. package/.agent/skills/nextjs-react-expert/6-rendering-rendering-performance.md +432 -432
  445. package/.agent/skills/nextjs-react-expert/7-js-javascript-performance.md +684 -684
  446. package/.agent/skills/nextjs-react-expert/8-advanced-advanced-patterns.md +150 -150
  447. package/.agent/skills/nextjs-react-expert/9-cache-components.md +103 -103
  448. package/.agent/skills/nextjs-react-expert/SKILL.md +293 -293
  449. package/.agent/skills/nextjs-react-expert/scripts/convert_rules.py +222 -222
  450. package/.agent/skills/nextjs-react-expert/scripts/react_performance_checker.py +252 -252
  451. package/.agent/skills/nextjs-turbopack/SKILL.md +44 -0
  452. package/.agent/skills/nodejs-best-practices/SKILL.md +333 -333
  453. package/.agent/skills/nutrient-document-processing/SKILL.md +167 -0
  454. package/.agent/skills/nuxt4-patterns/SKILL.md +100 -0
  455. package/.agent/skills/openclaw-persona-forge/SKILL.md +296 -0
  456. package/.agent/skills/openclaw-persona-forge/gacha.py +224 -0
  457. package/.agent/skills/openclaw-persona-forge/gacha.sh +5 -0
  458. package/.agent/skills/openclaw-persona-forge/references/avatar-style.md +124 -0
  459. package/.agent/skills/openclaw-persona-forge/references/boundary-rules.md +53 -0
  460. package/.agent/skills/openclaw-persona-forge/references/error-handling.md +53 -0
  461. package/.agent/skills/openclaw-persona-forge/references/identity-tension.md +48 -0
  462. package/.agent/skills/openclaw-persona-forge/references/naming-system.md +39 -0
  463. package/.agent/skills/openclaw-persona-forge/references/output-template.md +166 -0
  464. package/.agent/skills/opensource-pipeline/SKILL.md +255 -0
  465. package/.agent/skills/parallel-agents/SKILL.md +175 -175
  466. package/.agent/skills/performance-profiling/SKILL.md +143 -143
  467. package/.agent/skills/performance-profiling/scripts/lighthouse_audit.py +76 -76
  468. package/.agent/skills/perl-patterns/SKILL.md +504 -0
  469. package/.agent/skills/perl-security/SKILL.md +503 -0
  470. package/.agent/skills/perl-testing/SKILL.md +475 -0
  471. package/.agent/skills/plan-writing/SKILL.md +152 -152
  472. package/.agent/skills/plankton-code-quality/SKILL.md +236 -0
  473. package/.agent/skills/postgres-patterns/SKILL.md +147 -0
  474. package/.agent/skills/powershell-windows/SKILL.md +167 -167
  475. package/.agent/skills/product-lens/SKILL.md +85 -0
  476. package/.agent/skills/production-scheduling/SKILL.md +238 -0
  477. package/.agent/skills/project-flow-ops/SKILL.md +111 -0
  478. package/.agent/skills/project-guidelines-example/SKILL.md +349 -0
  479. package/.agent/skills/prompt-optimizer/SKILL.md +397 -0
  480. package/.agent/skills/python-patterns/SKILL.md +750 -441
  481. package/.agent/skills/python-testing/SKILL.md +816 -0
  482. package/.agent/skills/pytorch-patterns/SKILL.md +396 -0
  483. package/.agent/skills/quality-nonconformance/SKILL.md +260 -0
  484. package/.agent/skills/ralphinho-rfc-pipeline/SKILL.md +67 -0
  485. package/.agent/skills/red-team-tactics/SKILL.md +199 -199
  486. package/.agent/skills/regex-vs-llm-structured-text/SKILL.md +220 -0
  487. package/.agent/skills/remotion-video-creation/SKILL.md +43 -0
  488. package/.agent/skills/remotion-video-creation/rules/3d.md +86 -0
  489. package/.agent/skills/remotion-video-creation/rules/animations.md +29 -0
  490. package/.agent/skills/remotion-video-creation/rules/assets/charts-bar-chart.tsx +173 -0
  491. package/.agent/skills/remotion-video-creation/rules/assets/text-animations-typewriter.tsx +100 -0
  492. package/.agent/skills/remotion-video-creation/rules/assets/text-animations-word-highlight.tsx +108 -0
  493. package/.agent/skills/remotion-video-creation/rules/assets.md +78 -0
  494. package/.agent/skills/remotion-video-creation/rules/audio.md +172 -0
  495. package/.agent/skills/remotion-video-creation/rules/calculate-metadata.md +104 -0
  496. package/.agent/skills/remotion-video-creation/rules/can-decode.md +75 -0
  497. package/.agent/skills/remotion-video-creation/rules/charts.md +58 -0
  498. package/.agent/skills/remotion-video-creation/rules/compositions.md +146 -0
  499. package/.agent/skills/remotion-video-creation/rules/display-captions.md +126 -0
  500. package/.agent/skills/remotion-video-creation/rules/extract-frames.md +229 -0
  501. package/.agent/skills/remotion-video-creation/rules/fonts.md +152 -0
  502. package/.agent/skills/remotion-video-creation/rules/get-audio-duration.md +58 -0
  503. package/.agent/skills/remotion-video-creation/rules/get-video-dimensions.md +68 -0
  504. package/.agent/skills/remotion-video-creation/rules/get-video-duration.md +58 -0
  505. package/.agent/skills/remotion-video-creation/rules/gifs.md +138 -0
  506. package/.agent/skills/remotion-video-creation/rules/images.md +130 -0
  507. package/.agent/skills/remotion-video-creation/rules/import-srt-captions.md +67 -0
  508. package/.agent/skills/remotion-video-creation/rules/lottie.md +67 -0
  509. package/.agent/skills/remotion-video-creation/rules/measuring-dom-nodes.md +34 -0
  510. package/.agent/skills/remotion-video-creation/rules/measuring-text.md +143 -0
  511. package/.agent/skills/remotion-video-creation/rules/sequencing.md +106 -0
  512. package/.agent/skills/remotion-video-creation/rules/tailwind.md +11 -0
  513. package/.agent/skills/remotion-video-creation/rules/text-animations.md +20 -0
  514. package/.agent/skills/remotion-video-creation/rules/timing.md +179 -0
  515. package/.agent/skills/remotion-video-creation/rules/transcribe-captions.md +19 -0
  516. package/.agent/skills/remotion-video-creation/rules/transitions.md +122 -0
  517. package/.agent/skills/remotion-video-creation/rules/trimming.md +52 -0
  518. package/.agent/skills/remotion-video-creation/rules/videos.md +171 -0
  519. package/.agent/skills/repo-scan/SKILL.md +78 -0
  520. package/.agent/skills/returns-reverse-logistics/SKILL.md +240 -0
  521. package/.agent/skills/rules-distill/SKILL.md +264 -0
  522. package/.agent/skills/rules-distill/scripts/scan-rules.sh +58 -0
  523. package/.agent/skills/rules-distill/scripts/scan-skills.sh +129 -0
  524. package/.agent/skills/rust-patterns/SKILL.md +499 -0
  525. package/.agent/skills/rust-pro/SKILL.md +175 -175
  526. package/.agent/skills/rust-testing/SKILL.md +500 -0
  527. package/.agent/skills/safety-guard/SKILL.md +75 -0
  528. package/.agent/skills/santa-method/SKILL.md +306 -0
  529. package/.agent/skills/search-first/SKILL.md +161 -0
  530. package/.agent/skills/security-review/SKILL.md +495 -0
  531. package/.agent/skills/security-review/cloud-infrastructure-security.md +361 -0
  532. package/.agent/skills/security-scan/SKILL.md +165 -0
  533. package/.agent/skills/seo-fundamentals/SKILL.md +129 -129
  534. package/.agent/skills/seo-fundamentals/scripts/seo_checker.py +219 -219
  535. package/.agent/skills/server-management/SKILL.md +161 -161
  536. package/.agent/skills/skill-comply/SKILL.md +58 -0
  537. package/.agent/skills/skill-comply/fixtures/compliant-trace.jsonl +5 -0
  538. package/.agent/skills/skill-comply/fixtures/noncompliant-trace.jsonl +3 -0
  539. package/.agent/skills/skill-comply/fixtures/tdd-spec.yaml +44 -0
  540. package/.agent/skills/skill-comply/prompts/classifier.md +24 -0
  541. package/.agent/skills/skill-comply/prompts/scenario-generator.md +62 -0
  542. package/.agent/skills/skill-comply/prompts/spec-generator.md +42 -0
  543. package/.agent/skills/skill-comply/pyproject.toml +15 -0
  544. package/.agent/skills/skill-comply/scripts/classifier.py +85 -0
  545. package/.agent/skills/skill-comply/scripts/grader.py +122 -0
  546. package/.agent/skills/skill-comply/scripts/init.py +0 -0
  547. package/.agent/skills/skill-comply/scripts/parser.py +107 -0
  548. package/.agent/skills/skill-comply/scripts/report.py +170 -0
  549. package/.agent/skills/skill-comply/scripts/run.py +127 -0
  550. package/.agent/skills/skill-comply/scripts/runner.py +161 -0
  551. package/.agent/skills/skill-comply/scripts/scenario-generator.py +70 -0
  552. package/.agent/skills/skill-comply/scripts/spec-generator.py +72 -0
  553. package/.agent/skills/skill-comply/scripts/utils.py +13 -0
  554. package/.agent/skills/skill-comply/tests/test-grader.py +137 -0
  555. package/.agent/skills/skill-comply/tests/test-parser.py +90 -0
  556. package/.agent/skills/skill-creator/SKILL.md +485 -0
  557. package/.agent/skills/skill-creator/agents/analyzer.md +274 -0
  558. package/.agent/skills/skill-creator/agents/comparator.md +202 -0
  559. package/.agent/skills/skill-creator/agents/grader.md +223 -0
  560. package/.agent/skills/skill-creator/assets/eval-review.html +146 -0
  561. package/.agent/skills/skill-creator/eval-viewer/generate-review.py +471 -0
  562. package/.agent/skills/skill-creator/eval-viewer/viewer.html +1325 -0
  563. package/.agent/skills/skill-creator/license.txt +202 -0
  564. package/.agent/skills/skill-creator/references/schemas.md +430 -0
  565. package/.agent/skills/skill-creator/scripts/aggregate-benchmark.py +401 -0
  566. package/.agent/skills/skill-creator/scripts/generate-report.py +326 -0
  567. package/.agent/skills/skill-creator/scripts/improve-description.py +247 -0
  568. package/.agent/skills/skill-creator/scripts/init.py +0 -0
  569. package/.agent/skills/skill-creator/scripts/package-skill.py +136 -0
  570. package/.agent/skills/skill-creator/scripts/quick-validate.py +103 -0
  571. package/.agent/skills/skill-creator/scripts/run-eval.py +310 -0
  572. package/.agent/skills/skill-creator/scripts/run-loop.py +328 -0
  573. package/.agent/skills/skill-creator/scripts/utils.py +47 -0
  574. package/.agent/skills/skill-stocktake/SKILL.md +193 -0
  575. package/.agent/skills/skill-stocktake/scripts/quick-diff.sh +87 -0
  576. package/.agent/skills/skill-stocktake/scripts/save-results.sh +56 -0
  577. package/.agent/skills/skill-stocktake/scripts/scan.sh +170 -0
  578. package/.agent/skills/social-graph-ranker/SKILL.md +154 -0
  579. package/.agent/skills/springboot-patterns/SKILL.md +314 -0
  580. package/.agent/skills/springboot-security/SKILL.md +272 -0
  581. package/.agent/skills/springboot-tdd/SKILL.md +158 -0
  582. package/.agent/skills/springboot-verification/SKILL.md +231 -0
  583. package/.agent/skills/strategic-compact/SKILL.md +131 -0
  584. package/.agent/skills/strategic-compact/suggest-compact.sh +54 -0
  585. package/.agent/skills/swift-actor-persistence/SKILL.md +143 -0
  586. package/.agent/skills/swift-concurrency-6-2/SKILL.md +216 -0
  587. package/.agent/skills/swift-protocol-di-testing/SKILL.md +190 -0
  588. package/.agent/skills/swiftui-patterns/SKILL.md +259 -0
  589. package/.agent/skills/systematic-debugging/SKILL.md +109 -109
  590. package/.agent/skills/tailwind-patterns/SKILL.md +269 -269
  591. package/.agent/skills/tdd-workflow/SKILL.md +463 -149
  592. package/.agent/skills/team-builder/SKILL.md +168 -0
  593. package/.agent/skills/testing-patterns/SKILL.md +178 -178
  594. package/.agent/skills/testing-patterns/scripts/test_runner.py +219 -219
  595. package/.agent/skills/token-budget-advisor/SKILL.md +133 -0
  596. package/.agent/skills/ui-demo/SKILL.md +465 -0
  597. package/.agent/skills/ui-ux-pro-max/SKILL.md +292 -292
  598. package/.agent/skills/ui-ux-pro-max/data/icons.csv +101 -101
  599. package/.agent/skills/ui-ux-pro-max/data/landing.csv +3 -3
  600. package/.agent/skills/ui-ux-pro-max/data/react-performance.csv +45 -45
  601. package/.agent/skills/ui-ux-pro-max/data/stacks/astro.csv +54 -54
  602. package/.agent/skills/ui-ux-pro-max/data/stacks/jetpack-compose.csv +53 -53
  603. package/.agent/skills/ui-ux-pro-max/data/stacks/nuxt-ui.csv +51 -51
  604. package/.agent/skills/ui-ux-pro-max/data/stacks/nuxtjs.csv +59 -59
  605. package/.agent/skills/ui-ux-pro-max/data/stacks/shadcn.csv +61 -61
  606. package/.agent/skills/ui-ux-pro-max/data/typography.csv +57 -57
  607. package/.agent/skills/ui-ux-pro-max/data/ui-reasoning.csv +101 -101
  608. package/.agent/skills/ui-ux-pro-max/data/web-interface.csv +31 -31
  609. package/.agent/skills/ui-ux-pro-max/scripts/core.py +253 -253
  610. package/.agent/skills/ui-ux-pro-max/scripts/design_system.py +1067 -1067
  611. package/.agent/skills/verification-loop/SKILL.md +126 -0
  612. package/.agent/skills/video-editing/SKILL.md +310 -0
  613. package/.agent/skills/videodb/SKILL.md +374 -0
  614. package/.agent/skills/videodb/reference/api-reference.md +550 -0
  615. package/.agent/skills/videodb/reference/capture-reference.md +407 -0
  616. package/.agent/skills/videodb/reference/capture.md +101 -0
  617. package/.agent/skills/videodb/reference/editor.md +443 -0
  618. package/.agent/skills/videodb/reference/generative.md +331 -0
  619. package/.agent/skills/videodb/reference/rtstream-reference.md +564 -0
  620. package/.agent/skills/videodb/reference/rtstream.md +65 -0
  621. package/.agent/skills/videodb/reference/search.md +230 -0
  622. package/.agent/skills/videodb/reference/streaming.md +406 -0
  623. package/.agent/skills/videodb/reference/use-cases.md +118 -0
  624. package/.agent/skills/videodb/scripts/ws-listener.py +282 -0
  625. package/.agent/skills/visa-doc-translate/SKILL.md +117 -0
  626. package/.agent/skills/visa-doc-translate/readme.md +86 -0
  627. package/.agent/skills/vulnerability-scanner/SKILL.md +276 -276
  628. package/.agent/skills/vulnerability-scanner/checklists.md +121 -121
  629. package/.agent/skills/vulnerability-scanner/scripts/security_scan.py +458 -458
  630. package/.agent/skills/web-design-guidelines/SKILL.md +57 -57
  631. package/.agent/skills/webapp-testing/SKILL.md +187 -187
  632. package/.agent/skills/webapp-testing/scripts/playwright_runner.py +173 -173
  633. package/.agent/skills/workspace-surface-audit/SKILL.md +125 -0
  634. package/.agent/skills/x-api/SKILL.md +230 -0
  635. package/.agent/tasks/lessons.md +40 -40
  636. package/.agent/tasks/todo.md +33 -33
  637. package/.agent/tasks/two-track-merge-contract.md +29 -0
  638. package/.agent/workflows/aside.md +3 -3
  639. package/.agent/workflows/brainstorm.md +113 -113
  640. package/.agent/workflows/claw.md +13 -41
  641. package/.agent/workflows/clean-memory.md +34 -0
  642. package/.agent/workflows/code-review.md +260 -11
  643. package/.agent/workflows/context-budget.md +12 -18
  644. package/.agent/workflows/cpp-build.md +1 -1
  645. package/.agent/workflows/cpp-review.md +4 -4
  646. package/.agent/workflows/create.md +59 -59
  647. package/.agent/workflows/debug.md +103 -103
  648. package/.agent/workflows/deploy.md +176 -176
  649. package/.agent/workflows/devfleet.md +13 -82
  650. package/.agent/workflows/docs.md +13 -21
  651. package/.agent/workflows/e2e.md +38 -135
  652. package/.agent/workflows/enhance.md +63 -63
  653. package/.agent/workflows/eval.md +15 -112
  654. package/.agent/workflows/flutter-build.md +164 -0
  655. package/.agent/workflows/flutter-review.md +116 -0
  656. package/.agent/workflows/flutter-test.md +144 -0
  657. package/.agent/workflows/gan-build.md +99 -0
  658. package/.agent/workflows/gan-design.md +35 -0
  659. package/.agent/workflows/go-build.md +1 -1
  660. package/.agent/workflows/go-review.md +4 -4
  661. package/.agent/workflows/harness-audit.md +5 -3
  662. package/.agent/workflows/init-docs.md +46 -46
  663. package/.agent/workflows/instinct-import.md +4 -4
  664. package/.agent/workflows/jira.md +106 -0
  665. package/.agent/workflows/kotlin-build.md +1 -1
  666. package/.agent/workflows/kotlin-review.md +5 -5
  667. package/.agent/workflows/learn-eval.md +9 -9
  668. package/.agent/workflows/multi-plan.md +10 -10
  669. package/.agent/workflows/orchestrate.md +23 -119
  670. package/.agent/workflows/plan.md +2 -0
  671. package/.agent/workflows/preview.md +81 -81
  672. package/.agent/workflows/prompt-optimize.md +13 -28
  673. package/.agent/workflows/prp-commit.md +112 -0
  674. package/.agent/workflows/prp-implement.md +385 -0
  675. package/.agent/workflows/prp-plan.md +502 -0
  676. package/.agent/workflows/prp-pr.md +184 -0
  677. package/.agent/workflows/prp-prd.md +447 -0
  678. package/.agent/workflows/python-review.md +5 -5
  679. package/.agent/workflows/refactor-clean.md +1 -1
  680. package/.agent/workflows/resume-session.md +10 -10
  681. package/.agent/workflows/rules-distill.md +14 -5
  682. package/.agent/workflows/santa-loop.md +175 -0
  683. package/.agent/workflows/save-session.md +9 -9
  684. package/.agent/workflows/status.md +86 -86
  685. package/.agent/workflows/tdd.md +30 -127
  686. package/.agent/workflows/test-coverage.md +1 -1
  687. package/.agent/workflows/test.md +144 -144
  688. package/.agent/workflows/ui-ux-pro-max.md +295 -295
  689. package/.agent/workflows/verify.md +15 -51
  690. package/README.md +144 -136
  691. package/RELEASE.md +32 -36
  692. package/package.json +87 -79
  693. package/scripts/release-check.js +1 -1
  694. package/src/bin/cli.js +354 -78
  695. package/src/lib/installer.js +151 -117
  696. package/src/lib/manifests/stacks.js +122 -0
  697. package/src/lib/slash-commands.js +28 -0
  698. package/src/templates/claude/CLAUDE.en.md +42 -0
  699. package/src/templates/claude/CLAUDE.md +42 -0
  700. package/src/templates/claude/CLAUDE.vi.md +42 -0
  701. package/src/templates/codex/AGENTS.en.md +40 -0
  702. package/src/templates/codex/AGENTS.md +40 -0
  703. package/src/templates/codex/AGENTS.vi.md +40 -0
  704. package/src/templates/cursor/pilo-masterkit.mdc +20 -0
  705. package/src/templates/gemini/GEMINI.en.md +56 -0
  706. package/src/templates/gemini/GEMINI.md +56 -0
  707. package/src/templates/gemini/GEMINI.vi.md +56 -0
  708. package/src/templates/github/copilot-instructions.md +16 -0
@@ -1,357 +1,357 @@
1
- # Mobile Design Thinking
2
-
3
- > **This file prevents AI from using memorized patterns and forces genuine thinking.**
4
- > Mechanisms to prevent standard AI training defaults in mobile development.
5
- > **The mobile equivalent of frontend's layout decomposition approach.**
6
-
7
- ---
8
-
9
- ## 🧠 DEEP MOBILE THINKING PROTOCOL
10
-
11
- ### This Process is Mandatory Before Every Mobile Project
12
-
13
- ```
14
- ┌─────────────────────────────────────────────────────────────────┐
15
- │ DEEP MOBILE THINKING │
16
- ├─────────────────────────────────────────────────────────────────┤
17
- │ │
18
- │ 1️⃣ CONTEXT SCAN │
19
- │ └── What are my assumptions for this project? │
20
- │ └── QUESTION these assumptions │
21
- │ │
22
- │ 2️⃣ ANTI-DEFAULT ANALYSIS │
23
- │ └── Am I applying a memorized pattern? │
24
- │ └── Is this pattern REALLY the best for THIS project? │
25
- │ │
26
- │ 3️⃣ PLATFORM DECOMPOSITION │
27
- │ └── Did I think about iOS and Android separately? │
28
- │ └── What are the platform-specific patterns? │
29
- │ │
30
- │ 4️⃣ TOUCH INTERACTION BREAKDOWN │
31
- │ └── Did I analyze each interaction individually? │
32
- │ └── Did I apply Fitts' Law, Thumb Zone? │
33
- │ │
34
- │ 5️⃣ PERFORMANCE IMPACT ANALYSIS │
35
- │ └── Did I consider performance impact of each component? │
36
- │ └── Is the default solution performant? │
37
- │ │
38
- └─────────────────────────────────────────────────────────────────┘
39
- ```
40
-
41
- ---
42
-
43
- ## 🚫 AI MOBILE DEFAULTS (FORBIDDEN LIST)
44
-
45
- ### Using These Patterns Automatically is FORBIDDEN!
46
-
47
- The following patterns are "defaults" that AIs learned from training data.
48
- Before using any of these, **QUESTION them and CONSIDER ALTERNATIVES!**
49
-
50
- ```
51
- ┌─────────────────────────────────────────────────────────────────┐
52
- │ 🚫 AI MOBILE SAFE HARBOR │
53
- │ (Default Patterns - Never Use Without Questioning) │
54
- ├─────────────────────────────────────────────────────────────────┤
55
- │ │
56
- │ NAVIGATION DEFAULTS: │
57
- │ ├── Tab bar for every project (Would drawer be better?) │
58
- │ ├── Fixed 5 tabs (Are 3 enough? For 6+, drawer?) │
59
- │ ├── "Home" tab on left (What does user behavior say?) │
60
- │ └── Hamburger menu (Is it outdated now?) │
61
- │ │
62
- │ STATE MANAGEMENT DEFAULTS: │
63
- │ ├── Redux everywhere (Is Zustand/Jotai sufficient?) │
64
- │ ├── Global state for everything (Isn't local state enough?) │
65
- │ ├── Context Provider hell (Is atom-based better?) │
66
- │ └── BLoC for every Flutter project (Is Riverpod more modern?) │
67
- │ │
68
- │ LIST IMPLEMENTATION DEFAULTS: │
69
- │ ├── FlatList as default (Is FlashList more performant?) │
70
- │ ├── windowSize=21 (Is it really needed?) │
71
- │ ├── removeClippedSubviews (Always?) │
72
- │ └── ListView.builder (Is ListView.separated better?) │
73
- │ │
74
- │ UI PATTERN DEFAULTS: │
75
- │ ├── FAB bottom-right (Is bottom-left more accessible?) │
76
- │ ├── Pull-to-refresh on every list (Is it needed everywhere?) │
77
- │ ├── Swipe-to-delete from left (Is right better?) │
78
- │ └── Bottom sheet for every modal (Is full screen better?) │
79
- │ │
80
- └─────────────────────────────────────────────────────────────────┘
81
- ```
82
-
83
- ---
84
-
85
- ## 🔍 COMPONENT DECOMPOSITION (MANDATORY)
86
-
87
- ### Decomposition Analysis for Every Screen
88
-
89
- Before designing any screen, perform this analysis:
90
-
91
- ```
92
- SCREEN: [Screen Name]
93
- ├── PRIMARY ACTION: [What is the main action?]
94
- │ └── Is it in thumb zone? [Yes/No → Why?]
95
-
96
- ├── TOUCH TARGETS: [All tappable elements]
97
- │ ├── [Element 1]: [Size]pt → Sufficient?
98
- │ ├── [Element 2]: [Size]pt → Sufficient?
99
- │ └── Spacing: [Gap]pt → Accidental tap risk?
100
-
101
- ├── SCROLLABLE CONTENT:
102
- │ ├── Is it a list? → FlatList/FlashList [Why this choice?]
103
- │ ├── Item count: ~[N] → Performance consideration?
104
- │ └── Fixed height? → Is getItemLayout needed?
105
-
106
- ├── STATE REQUIREMENTS:
107
- │ ├── Is local state sufficient?
108
- │ ├── Do I need to lift state?
109
- │ └── Is global required? [Why?]
110
-
111
- ├── PLATFORM DIFFERENCES:
112
- │ ├── iOS: [Anything different needed?]
113
- │ └── Android: [Anything different needed?]
114
-
115
- ├── OFFLINE CONSIDERATION:
116
- │ ├── Should this screen work offline?
117
- │ └── Cache strategy: [Yes/No/Which one?]
118
-
119
- └── PERFORMANCE IMPACT:
120
- ├── Any heavy components?
121
- ├── Is memoization needed?
122
- └── Animation performance?
123
- ```
124
-
125
- ---
126
-
127
- ## 🎯 PATTERN QUESTIONING MATRIX
128
-
129
- Ask these questions for every default pattern:
130
-
131
- ### Navigation Pattern Questioning
132
-
133
- | Assumption | Question | Alternative |
134
- |------------|----------|-------------|
135
- | "I'll use tab bar" | How many destinations? | 3 → minimal tabs, 6+ → drawer |
136
- | "5 tabs" | Are all equally important? | "More" tab? Drawer hybrid? |
137
- | "Bottom nav" | iPad/tablet support? | Navigation rail alternative |
138
- | "Stack navigation" | Did I consider deep links? | URL structure = navigation structure |
139
-
140
- ### State Pattern Questioning
141
-
142
- | Assumption | Question | Alternative |
143
- |------------|----------|-------------|
144
- | "I'll use Redux" | How complex is the app? | Simple: Zustand, Server: TanStack |
145
- | "Global state" | Is this state really global? | Local lift, Context selector |
146
- | "Context Provider" | Will re-render be an issue? | Zustand, Jotai (atom-based) |
147
- | "BLoC pattern" | Is the boilerplate worth it? | Riverpod (less code) |
148
-
149
- ### List Pattern Questioning
150
-
151
- | Assumption | Question | Alternative |
152
- |------------|----------|-------------|
153
- | "FlatList" | Is performance critical? | FlashList (faster) |
154
- | "Standard renderItem" | Is it memoized? | useCallback + React.memo |
155
- | "Index key" | Does data order change? | Use item.id |
156
- | "ListView" | Are there separators? | ListView.separated |
157
-
158
- ### UI Pattern Questioning
159
-
160
- | Assumption | Question | Alternative |
161
- |------------|----------|-------------|
162
- | "FAB bottom-right" | User handedness? | Accessibility settings |
163
- | "Pull-to-refresh" | Does this list need refresh? | Only when necessary |
164
- | "Modal bottom sheet" | How much content? | Full screen modal might be better |
165
- | "Swipe actions" | Discoverability? | Visible button alternative |
166
-
167
- ---
168
-
169
- ## 🧪 ANTI-MEMORIZATION TEST
170
-
171
- ### Ask Yourself Before Every Solution
172
-
173
- ```
174
- ┌─────────────────────────────────────────────────────────────────┐
175
- │ ANTI-MEMORIZATION CHECKLIST │
176
- ├─────────────────────────────────────────────────────────────────┤
177
- │ │
178
- │ □ Did I pick this solution "because I always do it this way"? │
179
- │ → If YES: STOP. Consider alternatives. │
180
- │ │
181
- │ □ Is this a pattern I've seen frequently in training data? │
182
- │ → If YES: Is it REALLY suitable for THIS project? │
183
- │ │
184
- │ □ Did I write this solution automatically without thinking? │
185
- │ → If YES: Step back, do decomposition. │
186
- │ │
187
- │ □ Did I consider an alternative approach? │
188
- │ → If NO: Think of at least 2 alternatives, then decide. │
189
- │ │
190
- │ □ Did I think platform-specifically? │
191
- │ → If NO: Analyze iOS and Android separately. │
192
- │ │
193
- │ □ Did I consider performance impact of this solution? │
194
- │ → If NO: What is the memory, CPU, battery impact? │
195
- │ │
196
- │ □ Is this solution suitable for THIS project's CONTEXT? │
197
- │ → If NO: Customize based on context. │
198
- │ │
199
- └─────────────────────────────────────────────────────────────────┘
200
- ```
201
-
202
- ---
203
-
204
- ## 📊 CONTEXT-BASED DECISION PROTOCOL
205
-
206
- ### Think Differently Based on Project Type
207
-
208
- ```
209
- DETERMINE PROJECT TYPE:
210
-
211
- ├── E-Commerce App
212
- │ ├── Navigation: Tab (Home, Search, Cart, Account)
213
- │ ├── Lists: Product grids (memoized, image optimized)
214
- │ ├── Performance: Image caching CRITICAL
215
- │ ├── Offline: Cart persistence, product cache
216
- │ └── Special: Checkout flow, payment security
217
-
218
- ├── Social/Content App
219
- │ ├── Navigation: Tab (Feed, Search, Create, Notify, Profile)
220
- │ ├── Lists: Infinite scroll, complex items
221
- │ ├── Performance: Feed rendering CRITICAL
222
- │ ├── Offline: Feed cache, draft posts
223
- │ └── Special: Real-time updates, media handling
224
-
225
- ├── Productivity/SaaS App
226
- │ ├── Navigation: Drawer or adaptive (mobile tab, tablet rail)
227
- │ ├── Lists: Data tables, forms
228
- │ ├── Performance: Data sync
229
- │ ├── Offline: Full offline editing
230
- │ └── Special: Conflict resolution, background sync
231
-
232
- ├── Utility App
233
- │ ├── Navigation: Minimal (stack-only possible)
234
- │ ├── Lists: Probably minimal
235
- │ ├── Performance: Fast startup
236
- │ ├── Offline: Core feature offline
237
- │ └── Special: Widget, shortcuts
238
-
239
- └── Media/Streaming App
240
- ├── Navigation: Tab (Home, Search, Library, Profile)
241
- ├── Lists: Horizontal carousels, vertical feeds
242
- ├── Performance: Preloading, buffering
243
- ├── Offline: Download management
244
- └── Special: Background playback, casting
245
- ```
246
-
247
- ---
248
-
249
- ## 🔄 INTERACTION BREAKDOWN
250
-
251
- ### Analysis for Every Gesture
252
-
253
- Before adding any gesture:
254
-
255
- ```
256
- GESTURE: [Gesture Type]
257
- ├── DISCOVERABILITY:
258
- │ └── How will users discover this gesture?
259
- │ ├── Is there a visual hint?
260
- │ ├── Will it be shown in onboarding?
261
- │ └── Is there a button alternative? (MANDATORY)
262
-
263
- ├── PLATFORM CONVENTION:
264
- │ ├── What does this gesture mean on iOS?
265
- │ ├── What does this gesture mean on Android?
266
- │ └── Am I deviating from platform convention?
267
-
268
- ├── ACCESSIBILITY:
269
- │ ├── Can motor-impaired users perform this gesture?
270
- │ ├── Is there a VoiceOver/TalkBack alternative?
271
- │ └── Does it work with switch control?
272
-
273
- ├── CONFLICT CHECK:
274
- │ ├── Does it conflict with system gestures?
275
- │ │ ├── iOS: Edge swipe back
276
- │ │ ├── Android: Back gesture
277
- │ │ └── Home indicator swipe
278
- │ └── Is it consistent with other app gestures?
279
-
280
- └── FEEDBACK:
281
- ├── Is haptic feedback defined?
282
- ├── Is visual feedback sufficient?
283
- └── Is audio feedback needed?
284
- ```
285
-
286
- ---
287
-
288
- ## 🎭 SPIRIT OVER CHECKLIST (Mobile Edition)
289
-
290
- ### Passing the Checklist is Not Enough!
291
-
292
- | ❌ Self-Deception | ✅ Honest Assessment |
293
- |-------------------|----------------------|
294
- | "Touch target is 44px" (but on edge, unreachable) | "Can user reach it one-handed?" |
295
- | "I used FlatList" (but didn't memoize) | "Is scroll smooth?" |
296
- | "Platform-specific nav" (but only icons differ) | "Does iOS feel like iOS, Android like Android?" |
297
- | "Offline support exists" (but error message is generic) | "What can user actually do offline?" |
298
- | "Loading state exists" (but just a spinner) | "Does user know how long to wait?" |
299
-
300
- > 🔴 **Passing the checklist is NOT the goal. Creating great mobile UX IS the goal.**
301
-
302
- ---
303
-
304
- ## 📝 MOBILE DESIGN COMMITMENT
305
-
306
- ### Fill This at the Start of Every Mobile Project
307
-
308
- ```
309
- 📱 MOBILE DESIGN COMMITMENT
310
-
311
- Project: _______________
312
- Platform: iOS / Android / Both
313
-
314
- 1. Default pattern I will NOT use in this project:
315
- └── _______________
316
-
317
- 2. Context-specific focus for this project:
318
- └── _______________
319
-
320
- 3. Platform-specific differences I will implement:
321
- └── iOS: _______________
322
- └── Android: _______________
323
-
324
- 4. Area I will specifically optimize for performance:
325
- └── _______________
326
-
327
- 5. Unique challenge of this project:
328
- └── _______________
329
-
330
- 🧠 If I can't fill this commitment → I don't understand the project well enough.
331
- → Go back, understand context better, ask the user.
332
- ```
333
-
334
- ---
335
-
336
- ## 🚨 MANDATORY: Before Every Mobile Work
337
-
338
- ```
339
- ┌─────────────────────────────────────────────────────────────────┐
340
- │ PRE-WORK VALIDATION │
341
- ├─────────────────────────────────────────────────────────────────┤
342
- │ │
343
- │ □ Did I complete Component Decomposition? │
344
- │ □ Did I fill the Pattern Questioning Matrix? │
345
- │ □ Did I pass the Anti-Memorization Test? │
346
- │ □ Did I make context-based decisions? │
347
- │ □ Did I analyze Interaction Breakdown? │
348
- │ □ Did I fill the Mobile Design Commitment? │
349
- │ │
350
- │ ⚠️ Do not write code without completing these! │
351
- │ │
352
- └─────────────────────────────────────────────────────────────────┘
353
- ```
354
-
355
- ---
356
-
357
- > **Remember:** If you chose a solution "because that's how it's always done," you chose WITHOUT THINKING. Every project is unique. Every context is different. Every user behavior is specific. **THINK, then code.**
1
+ # Mobile Design Thinking
2
+
3
+ > **This file prevents AI from using memorized patterns and forces genuine thinking.**
4
+ > Mechanisms to prevent standard AI training defaults in mobile development.
5
+ > **The mobile equivalent of frontend's layout decomposition approach.**
6
+
7
+ ---
8
+
9
+ ## 🧠 DEEP MOBILE THINKING PROTOCOL
10
+
11
+ ### This Process is Mandatory Before Every Mobile Project
12
+
13
+ ```
14
+ ┌─────────────────────────────────────────────────────────────────┐
15
+ │ DEEP MOBILE THINKING │
16
+ ├─────────────────────────────────────────────────────────────────┤
17
+ │ │
18
+ │ 1️⃣ CONTEXT SCAN │
19
+ │ └── What are my assumptions for this project? │
20
+ │ └── QUESTION these assumptions │
21
+ │ │
22
+ │ 2️⃣ ANTI-DEFAULT ANALYSIS │
23
+ │ └── Am I applying a memorized pattern? │
24
+ │ └── Is this pattern REALLY the best for THIS project? │
25
+ │ │
26
+ │ 3️⃣ PLATFORM DECOMPOSITION │
27
+ │ └── Did I think about iOS and Android separately? │
28
+ │ └── What are the platform-specific patterns? │
29
+ │ │
30
+ │ 4️⃣ TOUCH INTERACTION BREAKDOWN │
31
+ │ └── Did I analyze each interaction individually? │
32
+ │ └── Did I apply Fitts' Law, Thumb Zone? │
33
+ │ │
34
+ │ 5️⃣ PERFORMANCE IMPACT ANALYSIS │
35
+ │ └── Did I consider performance impact of each component? │
36
+ │ └── Is the default solution performant? │
37
+ │ │
38
+ └─────────────────────────────────────────────────────────────────┘
39
+ ```
40
+
41
+ ---
42
+
43
+ ## 🚫 AI MOBILE DEFAULTS (FORBIDDEN LIST)
44
+
45
+ ### Using These Patterns Automatically is FORBIDDEN!
46
+
47
+ The following patterns are "defaults" that AIs learned from training data.
48
+ Before using any of these, **QUESTION them and CONSIDER ALTERNATIVES!**
49
+
50
+ ```
51
+ ┌─────────────────────────────────────────────────────────────────┐
52
+ │ 🚫 AI MOBILE SAFE HARBOR │
53
+ │ (Default Patterns - Never Use Without Questioning) │
54
+ ├─────────────────────────────────────────────────────────────────┤
55
+ │ │
56
+ │ NAVIGATION DEFAULTS: │
57
+ │ ├── Tab bar for every project (Would drawer be better?) │
58
+ │ ├── Fixed 5 tabs (Are 3 enough? For 6+, drawer?) │
59
+ │ ├── "Home" tab on left (What does user behavior say?) │
60
+ │ └── Hamburger menu (Is it outdated now?) │
61
+ │ │
62
+ │ STATE MANAGEMENT DEFAULTS: │
63
+ │ ├── Redux everywhere (Is Zustand/Jotai sufficient?) │
64
+ │ ├── Global state for everything (Isn't local state enough?) │
65
+ │ ├── Context Provider hell (Is atom-based better?) │
66
+ │ └── BLoC for every Flutter project (Is Riverpod more modern?) │
67
+ │ │
68
+ │ LIST IMPLEMENTATION DEFAULTS: │
69
+ │ ├── FlatList as default (Is FlashList more performant?) │
70
+ │ ├── windowSize=21 (Is it really needed?) │
71
+ │ ├── removeClippedSubviews (Always?) │
72
+ │ └── ListView.builder (Is ListView.separated better?) │
73
+ │ │
74
+ │ UI PATTERN DEFAULTS: │
75
+ │ ├── FAB bottom-right (Is bottom-left more accessible?) │
76
+ │ ├── Pull-to-refresh on every list (Is it needed everywhere?) │
77
+ │ ├── Swipe-to-delete from left (Is right better?) │
78
+ │ └── Bottom sheet for every modal (Is full screen better?) │
79
+ │ │
80
+ └─────────────────────────────────────────────────────────────────┘
81
+ ```
82
+
83
+ ---
84
+
85
+ ## 🔍 COMPONENT DECOMPOSITION (MANDATORY)
86
+
87
+ ### Decomposition Analysis for Every Screen
88
+
89
+ Before designing any screen, perform this analysis:
90
+
91
+ ```
92
+ SCREEN: [Screen Name]
93
+ ├── PRIMARY ACTION: [What is the main action?]
94
+ │ └── Is it in thumb zone? [Yes/No → Why?]
95
+
96
+ ├── TOUCH TARGETS: [All tappable elements]
97
+ │ ├── [Element 1]: [Size]pt → Sufficient?
98
+ │ ├── [Element 2]: [Size]pt → Sufficient?
99
+ │ └── Spacing: [Gap]pt → Accidental tap risk?
100
+
101
+ ├── SCROLLABLE CONTENT:
102
+ │ ├── Is it a list? → FlatList/FlashList [Why this choice?]
103
+ │ ├── Item count: ~[N] → Performance consideration?
104
+ │ └── Fixed height? → Is getItemLayout needed?
105
+
106
+ ├── STATE REQUIREMENTS:
107
+ │ ├── Is local state sufficient?
108
+ │ ├── Do I need to lift state?
109
+ │ └── Is global required? [Why?]
110
+
111
+ ├── PLATFORM DIFFERENCES:
112
+ │ ├── iOS: [Anything different needed?]
113
+ │ └── Android: [Anything different needed?]
114
+
115
+ ├── OFFLINE CONSIDERATION:
116
+ │ ├── Should this screen work offline?
117
+ │ └── Cache strategy: [Yes/No/Which one?]
118
+
119
+ └── PERFORMANCE IMPACT:
120
+ ├── Any heavy components?
121
+ ├── Is memoization needed?
122
+ └── Animation performance?
123
+ ```
124
+
125
+ ---
126
+
127
+ ## 🎯 PATTERN QUESTIONING MATRIX
128
+
129
+ Ask these questions for every default pattern:
130
+
131
+ ### Navigation Pattern Questioning
132
+
133
+ | Assumption | Question | Alternative |
134
+ |------------|----------|-------------|
135
+ | "I'll use tab bar" | How many destinations? | 3 → minimal tabs, 6+ → drawer |
136
+ | "5 tabs" | Are all equally important? | "More" tab? Drawer hybrid? |
137
+ | "Bottom nav" | iPad/tablet support? | Navigation rail alternative |
138
+ | "Stack navigation" | Did I consider deep links? | URL structure = navigation structure |
139
+
140
+ ### State Pattern Questioning
141
+
142
+ | Assumption | Question | Alternative |
143
+ |------------|----------|-------------|
144
+ | "I'll use Redux" | How complex is the app? | Simple: Zustand, Server: TanStack |
145
+ | "Global state" | Is this state really global? | Local lift, Context selector |
146
+ | "Context Provider" | Will re-render be an issue? | Zustand, Jotai (atom-based) |
147
+ | "BLoC pattern" | Is the boilerplate worth it? | Riverpod (less code) |
148
+
149
+ ### List Pattern Questioning
150
+
151
+ | Assumption | Question | Alternative |
152
+ |------------|----------|-------------|
153
+ | "FlatList" | Is performance critical? | FlashList (faster) |
154
+ | "Standard renderItem" | Is it memoized? | useCallback + React.memo |
155
+ | "Index key" | Does data order change? | Use item.id |
156
+ | "ListView" | Are there separators? | ListView.separated |
157
+
158
+ ### UI Pattern Questioning
159
+
160
+ | Assumption | Question | Alternative |
161
+ |------------|----------|-------------|
162
+ | "FAB bottom-right" | User handedness? | Accessibility settings |
163
+ | "Pull-to-refresh" | Does this list need refresh? | Only when necessary |
164
+ | "Modal bottom sheet" | How much content? | Full screen modal might be better |
165
+ | "Swipe actions" | Discoverability? | Visible button alternative |
166
+
167
+ ---
168
+
169
+ ## 🧪 ANTI-MEMORIZATION TEST
170
+
171
+ ### Ask Yourself Before Every Solution
172
+
173
+ ```
174
+ ┌─────────────────────────────────────────────────────────────────┐
175
+ │ ANTI-MEMORIZATION CHECKLIST │
176
+ ├─────────────────────────────────────────────────────────────────┤
177
+ │ │
178
+ │ □ Did I pick this solution "because I always do it this way"? │
179
+ │ → If YES: STOP. Consider alternatives. │
180
+ │ │
181
+ │ □ Is this a pattern I've seen frequently in training data? │
182
+ │ → If YES: Is it REALLY suitable for THIS project? │
183
+ │ │
184
+ │ □ Did I write this solution automatically without thinking? │
185
+ │ → If YES: Step back, do decomposition. │
186
+ │ │
187
+ │ □ Did I consider an alternative approach? │
188
+ │ → If NO: Think of at least 2 alternatives, then decide. │
189
+ │ │
190
+ │ □ Did I think platform-specifically? │
191
+ │ → If NO: Analyze iOS and Android separately. │
192
+ │ │
193
+ │ □ Did I consider performance impact of this solution? │
194
+ │ → If NO: What is the memory, CPU, battery impact? │
195
+ │ │
196
+ │ □ Is this solution suitable for THIS project's CONTEXT? │
197
+ │ → If NO: Customize based on context. │
198
+ │ │
199
+ └─────────────────────────────────────────────────────────────────┘
200
+ ```
201
+
202
+ ---
203
+
204
+ ## 📊 CONTEXT-BASED DECISION PROTOCOL
205
+
206
+ ### Think Differently Based on Project Type
207
+
208
+ ```
209
+ DETERMINE PROJECT TYPE:
210
+
211
+ ├── E-Commerce App
212
+ │ ├── Navigation: Tab (Home, Search, Cart, Account)
213
+ │ ├── Lists: Product grids (memoized, image optimized)
214
+ │ ├── Performance: Image caching CRITICAL
215
+ │ ├── Offline: Cart persistence, product cache
216
+ │ └── Special: Checkout flow, payment security
217
+
218
+ ├── Social/Content App
219
+ │ ├── Navigation: Tab (Feed, Search, Create, Notify, Profile)
220
+ │ ├── Lists: Infinite scroll, complex items
221
+ │ ├── Performance: Feed rendering CRITICAL
222
+ │ ├── Offline: Feed cache, draft posts
223
+ │ └── Special: Real-time updates, media handling
224
+
225
+ ├── Productivity/SaaS App
226
+ │ ├── Navigation: Drawer or adaptive (mobile tab, tablet rail)
227
+ │ ├── Lists: Data tables, forms
228
+ │ ├── Performance: Data sync
229
+ │ ├── Offline: Full offline editing
230
+ │ └── Special: Conflict resolution, background sync
231
+
232
+ ├── Utility App
233
+ │ ├── Navigation: Minimal (stack-only possible)
234
+ │ ├── Lists: Probably minimal
235
+ │ ├── Performance: Fast startup
236
+ │ ├── Offline: Core feature offline
237
+ │ └── Special: Widget, shortcuts
238
+
239
+ └── Media/Streaming App
240
+ ├── Navigation: Tab (Home, Search, Library, Profile)
241
+ ├── Lists: Horizontal carousels, vertical feeds
242
+ ├── Performance: Preloading, buffering
243
+ ├── Offline: Download management
244
+ └── Special: Background playback, casting
245
+ ```
246
+
247
+ ---
248
+
249
+ ## 🔄 INTERACTION BREAKDOWN
250
+
251
+ ### Analysis for Every Gesture
252
+
253
+ Before adding any gesture:
254
+
255
+ ```
256
+ GESTURE: [Gesture Type]
257
+ ├── DISCOVERABILITY:
258
+ │ └── How will users discover this gesture?
259
+ │ ├── Is there a visual hint?
260
+ │ ├── Will it be shown in onboarding?
261
+ │ └── Is there a button alternative? (MANDATORY)
262
+
263
+ ├── PLATFORM CONVENTION:
264
+ │ ├── What does this gesture mean on iOS?
265
+ │ ├── What does this gesture mean on Android?
266
+ │ └── Am I deviating from platform convention?
267
+
268
+ ├── ACCESSIBILITY:
269
+ │ ├── Can motor-impaired users perform this gesture?
270
+ │ ├── Is there a VoiceOver/TalkBack alternative?
271
+ │ └── Does it work with switch control?
272
+
273
+ ├── CONFLICT CHECK:
274
+ │ ├── Does it conflict with system gestures?
275
+ │ │ ├── iOS: Edge swipe back
276
+ │ │ ├── Android: Back gesture
277
+ │ │ └── Home indicator swipe
278
+ │ └── Is it consistent with other app gestures?
279
+
280
+ └── FEEDBACK:
281
+ ├── Is haptic feedback defined?
282
+ ├── Is visual feedback sufficient?
283
+ └── Is audio feedback needed?
284
+ ```
285
+
286
+ ---
287
+
288
+ ## 🎭 SPIRIT OVER CHECKLIST (Mobile Edition)
289
+
290
+ ### Passing the Checklist is Not Enough!
291
+
292
+ | ❌ Self-Deception | ✅ Honest Assessment |
293
+ |-------------------|----------------------|
294
+ | "Touch target is 44px" (but on edge, unreachable) | "Can user reach it one-handed?" |
295
+ | "I used FlatList" (but didn't memoize) | "Is scroll smooth?" |
296
+ | "Platform-specific nav" (but only icons differ) | "Does iOS feel like iOS, Android like Android?" |
297
+ | "Offline support exists" (but error message is generic) | "What can user actually do offline?" |
298
+ | "Loading state exists" (but just a spinner) | "Does user know how long to wait?" |
299
+
300
+ > 🔴 **Passing the checklist is NOT the goal. Creating great mobile UX IS the goal.**
301
+
302
+ ---
303
+
304
+ ## 📝 MOBILE DESIGN COMMITMENT
305
+
306
+ ### Fill This at the Start of Every Mobile Project
307
+
308
+ ```
309
+ 📱 MOBILE DESIGN COMMITMENT
310
+
311
+ Project: _______________
312
+ Platform: iOS / Android / Both
313
+
314
+ 1. Default pattern I will NOT use in this project:
315
+ └── _______________
316
+
317
+ 2. Context-specific focus for this project:
318
+ └── _______________
319
+
320
+ 3. Platform-specific differences I will implement:
321
+ └── iOS: _______________
322
+ └── Android: _______________
323
+
324
+ 4. Area I will specifically optimize for performance:
325
+ └── _______________
326
+
327
+ 5. Unique challenge of this project:
328
+ └── _______________
329
+
330
+ 🧠 If I can't fill this commitment → I don't understand the project well enough.
331
+ → Go back, understand context better, ask the user.
332
+ ```
333
+
334
+ ---
335
+
336
+ ## 🚨 MANDATORY: Before Every Mobile Work
337
+
338
+ ```
339
+ ┌─────────────────────────────────────────────────────────────────┐
340
+ │ PRE-WORK VALIDATION │
341
+ ├─────────────────────────────────────────────────────────────────┤
342
+ │ │
343
+ │ □ Did I complete Component Decomposition? │
344
+ │ □ Did I fill the Pattern Questioning Matrix? │
345
+ │ □ Did I pass the Anti-Memorization Test? │
346
+ │ □ Did I make context-based decisions? │
347
+ │ □ Did I analyze Interaction Breakdown? │
348
+ │ □ Did I fill the Mobile Design Commitment? │
349
+ │ │
350
+ │ ⚠️ Do not write code without completing these! │
351
+ │ │
352
+ └─────────────────────────────────────────────────────────────────┘
353
+ ```
354
+
355
+ ---
356
+
357
+ > **Remember:** If you chose a solution "because that's how it's always done," you chose WITHOUT THINKING. Every project is unique. Every context is different. Every user behavior is specific. **THINK, then code.**