buildanything 1.8.0 → 2.0.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 (458) hide show
  1. package/.claude-plugin/marketplace.json +3 -3
  2. package/.claude-plugin/plugin.json +9 -3
  3. package/CHANGELOG.md +57 -0
  4. package/README.md +2 -2
  5. package/agents/a11y-architect.md +166 -0
  6. package/agents/business-model.md +80 -29
  7. package/agents/code-architect.md +75 -0
  8. package/agents/code-reviewer.md +255 -0
  9. package/agents/code-simplifier.md +64 -0
  10. package/agents/design-brand-guardian.md +293 -53
  11. package/agents/design-critic.md +139 -0
  12. package/agents/design-inclusive-visuals-specialist.md +6 -19
  13. package/agents/design-ui-designer.md +335 -56
  14. package/agents/design-ux-architect.md +403 -55
  15. package/agents/design-ux-researcher.md +264 -49
  16. package/agents/engineering-ai-engineer.md +26 -36
  17. package/agents/engineering-backend-architect.md +185 -36
  18. package/agents/engineering-data-engineer.md +225 -43
  19. package/agents/engineering-devops-automator.md +227 -74
  20. package/agents/engineering-frontend-developer.md +210 -34
  21. package/agents/engineering-mobile-app-builder.md +6 -1
  22. package/agents/engineering-rapid-prototyper.md +30 -9
  23. package/agents/engineering-security-engineer.md +263 -61
  24. package/agents/engineering-senior-developer.md +128 -19
  25. package/agents/engineering-sre.md +84 -0
  26. package/agents/engineering-technical-writer.md +285 -41
  27. package/agents/feature-intel.md +110 -0
  28. package/agents/ios-app-review-guardian.md +19 -2
  29. package/agents/ios-foundation-models-specialist.md +20 -2
  30. package/agents/ios-storekit-specialist.md +9 -2
  31. package/agents/ios-swift-architect.md +28 -1
  32. package/agents/ios-swift-search.md +8 -1
  33. package/agents/ios-swift-ui-design.md +33 -1
  34. package/agents/marketing-app-store-optimizer.md +246 -64
  35. package/agents/planner.md +216 -0
  36. package/agents/pr-test-analyzer.md +63 -0
  37. package/agents/product-feedback-synthesizer.md +8 -2
  38. package/agents/refactor-cleaner.md +102 -0
  39. package/agents/security-reviewer.md +128 -0
  40. package/agents/silent-failure-hunter.md +54 -0
  41. package/agents/swift-build-resolver.md +119 -0
  42. package/agents/swift-reviewer.md +112 -0
  43. package/agents/tech-feasibility.md +21 -1
  44. package/agents/testing-api-tester.md +236 -59
  45. package/agents/testing-evidence-collector.md +26 -1
  46. package/agents/testing-performance-benchmarker.md +21 -1
  47. package/agents/testing-reality-checker.md +6 -1
  48. package/agents/visual-research.md +116 -0
  49. package/bin/adapters/cycle-counter-tool.ts +155 -0
  50. package/bin/adapters/scribe-tool.ts +71 -0
  51. package/bin/adapters/state-save-tool.ts +130 -0
  52. package/bin/adapters/write-lease-tool.ts +127 -0
  53. package/bin/buildanything-runtime.js +15 -0
  54. package/bin/buildanything-runtime.ts +328 -0
  55. package/bin/setup.js +83 -8
  56. package/commands/add-feature.md +2 -0
  57. package/commands/build.md +782 -266
  58. package/commands/fix.md +1 -1
  59. package/commands/self-check.md +121 -0
  60. package/commands/setup.md +50 -9
  61. package/commands/ux-review.md +2 -2
  62. package/commands/verify.md +6 -9
  63. package/docs/migration/agents.yaml +729 -0
  64. package/docs/migration/phase-graph.yaml +1088 -0
  65. package/docs/migration/sdk-host-compat.md +18 -0
  66. package/hooks/compile-writer-owner-cache.ts +171 -0
  67. package/hooks/hooks.json +36 -0
  68. package/hooks/pre-tool-use +19 -0
  69. package/hooks/pre-tool-use.ts +776 -0
  70. package/hooks/record-mode-transitions.ts +178 -0
  71. package/hooks/session-start +71 -1
  72. package/hooks/subagent-start +17 -0
  73. package/hooks/subagent-start.ts +471 -0
  74. package/hooks/subagent-stop +17 -0
  75. package/hooks/subagent-stop.ts +153 -0
  76. package/package.json +24 -4
  77. package/protocols/architecture-schema.md +171 -0
  78. package/protocols/decision-log.md +131 -0
  79. package/protocols/ios-context.md +10 -11
  80. package/protocols/ios-phase-branches.md +208 -33
  81. package/protocols/launch-readiness.md +258 -0
  82. package/protocols/metric-loop.md +62 -2
  83. package/protocols/smoke-test.md +9 -1
  84. package/protocols/state-schema.json +388 -0
  85. package/protocols/state-schema.md +172 -0
  86. package/protocols/verify.md +62 -2
  87. package/protocols/visual-dna.md +185 -0
  88. package/protocols/web-phase-branches.md +222 -72
  89. package/skills/ios/_VENDORED.md +2 -0
  90. package/skills/ios/app-store-connect-metadata/SKILL.md +148 -0
  91. package/skills/ios/asc-privacy-manifest/SKILL.md +350 -0
  92. package/skills/ios/hig-components-content/SKILL.md +86 -0
  93. package/skills/ios/hig-components-content/references/activity-views.md +79 -0
  94. package/skills/ios/hig-components-content/references/charts.md +180 -0
  95. package/skills/ios/hig-components-content/references/collections.md +48 -0
  96. package/skills/ios/hig-components-content/references/color-wells.md +42 -0
  97. package/skills/ios/hig-components-content/references/image-views.md +82 -0
  98. package/skills/ios/hig-components-content/references/image-wells.md +34 -0
  99. package/skills/ios/hig-components-content/references/lockups.md +78 -0
  100. package/skills/ios/hig-components-content/references/web-views.md +36 -0
  101. package/skills/ios/hig-components-controls/SKILL.md +88 -0
  102. package/skills/ios/hig-components-controls/references/combo-boxes.md +40 -0
  103. package/skills/ios/hig-components-controls/references/controls.md +112 -0
  104. package/skills/ios/hig-components-controls/references/gauges.md +74 -0
  105. package/skills/ios/hig-components-controls/references/labels.md +92 -0
  106. package/skills/ios/hig-components-controls/references/pickers.md +128 -0
  107. package/skills/ios/hig-components-controls/references/rating-indicators.md +38 -0
  108. package/skills/ios/hig-components-controls/references/segmented-controls.md +94 -0
  109. package/skills/ios/hig-components-controls/references/sliders.md +92 -0
  110. package/skills/ios/hig-components-controls/references/steppers.md +40 -0
  111. package/skills/ios/hig-components-controls/references/text-fields.md +88 -0
  112. package/skills/ios/hig-components-controls/references/text-views.md +56 -0
  113. package/skills/ios/hig-components-controls/references/toggles.md +127 -0
  114. package/skills/ios/hig-components-controls/references/token-fields.md +48 -0
  115. package/skills/ios/hig-components-controls/references/virtual-keyboards.md +156 -0
  116. package/skills/ios/hig-components-dialogs/SKILL.md +76 -0
  117. package/skills/ios/hig-components-dialogs/references/action-sheets.md +74 -0
  118. package/skills/ios/hig-components-dialogs/references/alerts.md +158 -0
  119. package/skills/ios/hig-components-dialogs/references/digit-entry-views.md +32 -0
  120. package/skills/ios/hig-components-dialogs/references/popovers.md +81 -0
  121. package/skills/ios/hig-components-dialogs/references/sheets.md +157 -0
  122. package/skills/ios/hig-components-layout/SKILL.md +99 -0
  123. package/skills/ios/hig-components-layout/references/boxes.md +48 -0
  124. package/skills/ios/hig-components-layout/references/column-views.md +44 -0
  125. package/skills/ios/hig-components-layout/references/lists-and-tables.md +99 -0
  126. package/skills/ios/hig-components-layout/references/ornaments.md +56 -0
  127. package/skills/ios/hig-components-layout/references/outline-views.md +64 -0
  128. package/skills/ios/hig-components-layout/references/panels.md +75 -0
  129. package/skills/ios/hig-components-layout/references/scroll-views.md +123 -0
  130. package/skills/ios/hig-components-layout/references/sidebars.md +109 -0
  131. package/skills/ios/hig-components-layout/references/split-views.md +110 -0
  132. package/skills/ios/hig-components-layout/references/tab-bars.md +173 -0
  133. package/skills/ios/hig-components-layout/references/tab-views.md +68 -0
  134. package/skills/ios/hig-components-layout/references/windows.md +188 -0
  135. package/skills/ios/hig-components-menus/SKILL.md +81 -0
  136. package/skills/ios/hig-components-menus/references/action-button.md +61 -0
  137. package/skills/ios/hig-components-menus/references/buttons.md +261 -0
  138. package/skills/ios/hig-components-menus/references/context-menus.md +105 -0
  139. package/skills/ios/hig-components-menus/references/disclosure-controls.md +84 -0
  140. package/skills/ios/hig-components-menus/references/dock-menus.md +40 -0
  141. package/skills/ios/hig-components-menus/references/edit-menus.md +88 -0
  142. package/skills/ios/hig-components-menus/references/menus.md +171 -0
  143. package/skills/ios/hig-components-menus/references/pop-up-buttons.md +70 -0
  144. package/skills/ios/hig-components-menus/references/pull-down-buttons.md +77 -0
  145. package/skills/ios/hig-components-menus/references/the-menu-bar.md +303 -0
  146. package/skills/ios/hig-components-menus/references/toolbars.md +256 -0
  147. package/skills/ios/hig-components-search/SKILL.md +68 -0
  148. package/skills/ios/hig-components-search/references/page-controls.md +120 -0
  149. package/skills/ios/hig-components-search/references/path-controls.md +40 -0
  150. package/skills/ios/hig-components-search/references/search-fields.md +189 -0
  151. package/skills/ios/hig-components-status/SKILL.md +80 -0
  152. package/skills/ios/hig-components-status/references/activity-rings.md +105 -0
  153. package/skills/ios/hig-components-status/references/progress-indicators.md +116 -0
  154. package/skills/ios/hig-components-status/references/status-bars.md +38 -0
  155. package/skills/ios/hig-components-system/SKILL.md +88 -0
  156. package/skills/ios/hig-components-system/references/app-clips.md +387 -0
  157. package/skills/ios/hig-components-system/references/app-shortcuts.md +114 -0
  158. package/skills/ios/hig-components-system/references/complications.md +425 -0
  159. package/skills/ios/hig-components-system/references/home-screen-quick-actions.md +42 -0
  160. package/skills/ios/hig-components-system/references/live-activities.md +442 -0
  161. package/skills/ios/hig-components-system/references/notifications.md +153 -0
  162. package/skills/ios/hig-components-system/references/top-shelf.md +135 -0
  163. package/skills/ios/hig-components-system/references/watch-faces.md +40 -0
  164. package/skills/ios/hig-components-system/references/widgets.md +517 -0
  165. package/skills/ios/hig-foundations/SKILL.md +98 -0
  166. package/skills/ios/hig-foundations/references/accessibility.md +291 -0
  167. package/skills/ios/hig-foundations/references/app-icons.md +210 -0
  168. package/skills/ios/hig-foundations/references/branding.md +44 -0
  169. package/skills/ios/hig-foundations/references/color.md +274 -0
  170. package/skills/ios/hig-foundations/references/dark-mode.md +116 -0
  171. package/skills/ios/hig-foundations/references/icons.md +263 -0
  172. package/skills/ios/hig-foundations/references/images.md +176 -0
  173. package/skills/ios/hig-foundations/references/immersive-experiences.md +174 -0
  174. package/skills/ios/hig-foundations/references/inclusion.md +189 -0
  175. package/skills/ios/hig-foundations/references/layout.md +425 -0
  176. package/skills/ios/hig-foundations/references/materials.md +238 -0
  177. package/skills/ios/hig-foundations/references/motion.md +103 -0
  178. package/skills/ios/hig-foundations/references/privacy.md +231 -0
  179. package/skills/ios/hig-foundations/references/right-to-left.md +206 -0
  180. package/skills/ios/hig-foundations/references/sf-symbols.md +310 -0
  181. package/skills/ios/hig-foundations/references/spatial-layout.md +142 -0
  182. package/skills/ios/hig-foundations/references/typography.md +1146 -0
  183. package/skills/ios/hig-foundations/references/writing.md +91 -0
  184. package/skills/ios/hig-inputs/SKILL.md +94 -0
  185. package/skills/ios/hig-inputs/references/apple-pencil-and-scribble.md +148 -0
  186. package/skills/ios/hig-inputs/references/camera-control.md +107 -0
  187. package/skills/ios/hig-inputs/references/digital-crown.md +83 -0
  188. package/skills/ios/hig-inputs/references/eyes.md +120 -0
  189. package/skills/ios/hig-inputs/references/focus-and-selection.md +120 -0
  190. package/skills/ios/hig-inputs/references/game-controls.md +156 -0
  191. package/skills/ios/hig-inputs/references/gestures.md +208 -0
  192. package/skills/ios/hig-inputs/references/gyro-and-accelerometer.md +40 -0
  193. package/skills/ios/hig-inputs/references/keyboards.md +234 -0
  194. package/skills/ios/hig-inputs/references/nearby-interactions.md +70 -0
  195. package/skills/ios/hig-inputs/references/pointing-devices.md +237 -0
  196. package/skills/ios/hig-inputs/references/remotes.md +67 -0
  197. package/skills/ios/hig-inputs/references/spatial-interactions.md +70 -0
  198. package/skills/ios/hig-patterns/SKILL.md +104 -0
  199. package/skills/ios/hig-patterns/references/charting-data.md +81 -0
  200. package/skills/ios/hig-patterns/references/collaboration-and-sharing.md +86 -0
  201. package/skills/ios/hig-patterns/references/drag-and-drop.md +134 -0
  202. package/skills/ios/hig-patterns/references/entering-data.md +69 -0
  203. package/skills/ios/hig-patterns/references/feedback.md +67 -0
  204. package/skills/ios/hig-patterns/references/file-management.md +135 -0
  205. package/skills/ios/hig-patterns/references/going-full-screen.md +79 -0
  206. package/skills/ios/hig-patterns/references/launching.md +81 -0
  207. package/skills/ios/hig-patterns/references/live-viewing-apps.md +79 -0
  208. package/skills/ios/hig-patterns/references/loading.md +59 -0
  209. package/skills/ios/hig-patterns/references/managing-accounts.md +107 -0
  210. package/skills/ios/hig-patterns/references/managing-notifications.md +99 -0
  211. package/skills/ios/hig-patterns/references/modality.md +82 -0
  212. package/skills/ios/hig-patterns/references/multitasking.md +131 -0
  213. package/skills/ios/hig-patterns/references/offering-help.md +117 -0
  214. package/skills/ios/hig-patterns/references/onboarding.md +69 -0
  215. package/skills/ios/hig-patterns/references/playing-audio.md +124 -0
  216. package/skills/ios/hig-patterns/references/playing-haptics.md +280 -0
  217. package/skills/ios/hig-patterns/references/playing-video.md +180 -0
  218. package/skills/ios/hig-patterns/references/printing.md +50 -0
  219. package/skills/ios/hig-patterns/references/ratings-and-reviews.md +48 -0
  220. package/skills/ios/hig-patterns/references/searching.md +70 -0
  221. package/skills/ios/hig-patterns/references/settings.md +84 -0
  222. package/skills/ios/hig-patterns/references/undo-and-redo.md +58 -0
  223. package/skills/ios/hig-patterns/references/workouts.md +76 -0
  224. package/skills/ios/hig-platforms/SKILL.md +84 -0
  225. package/skills/ios/hig-platforms/references/designing-for-games.md +159 -0
  226. package/skills/ios/hig-platforms/references/designing-for-ios.md +66 -0
  227. package/skills/ios/hig-platforms/references/designing-for-ipados.md +64 -0
  228. package/skills/ios/hig-platforms/references/designing-for-macos.md +70 -0
  229. package/skills/ios/hig-platforms/references/designing-for-tvos.md +68 -0
  230. package/skills/ios/hig-platforms/references/designing-for-visionos.md +85 -0
  231. package/skills/ios/hig-platforms/references/designing-for-watchos.md +74 -0
  232. package/skills/ios/hig-project-context/SKILL.md +133 -0
  233. package/skills/ios/hig-technologies/SKILL.md +107 -0
  234. package/skills/ios/hig-technologies/references/airplay.md +125 -0
  235. package/skills/ios/hig-technologies/references/always-on.md +62 -0
  236. package/skills/ios/hig-technologies/references/apple-pay.md +441 -0
  237. package/skills/ios/hig-technologies/references/augmented-reality.md +247 -0
  238. package/skills/ios/hig-technologies/references/carekit.md +224 -0
  239. package/skills/ios/hig-technologies/references/carplay.md +119 -0
  240. package/skills/ios/hig-technologies/references/game-center.md +343 -0
  241. package/skills/ios/hig-technologies/references/generative-ai.md +110 -0
  242. package/skills/ios/hig-technologies/references/healthkit.md +120 -0
  243. package/skills/ios/hig-technologies/references/homekit.md +343 -0
  244. package/skills/ios/hig-technologies/references/icloud.md +52 -0
  245. package/skills/ios/hig-technologies/references/id-verifier.md +73 -0
  246. package/skills/ios/hig-technologies/references/imessage-apps-and-stickers.md +105 -0
  247. package/skills/ios/hig-technologies/references/in-app-purchase.md +263 -0
  248. package/skills/ios/hig-technologies/references/live-photos.md +54 -0
  249. package/skills/ios/hig-technologies/references/mac-catalyst.md +216 -0
  250. package/skills/ios/hig-technologies/references/machine-learning.md +394 -0
  251. package/skills/ios/hig-technologies/references/maps.md +221 -0
  252. package/skills/ios/hig-technologies/references/nfc.md +51 -0
  253. package/skills/ios/hig-technologies/references/photo-editing.md +40 -0
  254. package/skills/ios/hig-technologies/references/researchkit.md +134 -0
  255. package/skills/ios/hig-technologies/references/shareplay.md +142 -0
  256. package/skills/ios/hig-technologies/references/shazamkit.md +47 -0
  257. package/skills/ios/hig-technologies/references/sign-in-with-apple.md +288 -0
  258. package/skills/ios/hig-technologies/references/siri.md +523 -0
  259. package/skills/ios/hig-technologies/references/tap-to-pay-on-iphone.md +208 -0
  260. package/skills/ios/hig-technologies/references/voiceover.md +90 -0
  261. package/skills/ios/hig-technologies/references/wallet.md +420 -0
  262. package/skills/ios/ios-bootstrap/SKILL.md +16 -7
  263. package/skills/ios/swift-actor-persistence/SKILL.md +143 -0
  264. package/skills/ios/swift-concurrency-6-2/SKILL.md +216 -0
  265. package/skills/ios/swift-protocol-di-testing/SKILL.md +190 -0
  266. package/skills/ios/swiftui-design-tokens/SKILL.md +475 -0
  267. package/skills/ios/writing-for-interfaces/SKILL.md +75 -0
  268. package/skills/web/accessibility/SKILL.md +146 -0
  269. package/skills/web/aceternity-ui/SKILL.md +719 -0
  270. package/skills/web/aceternity-ui/metadata.json +10 -0
  271. package/skills/web/api-design/SKILL.md +523 -0
  272. package/skills/web/chart-accessibility/SKILL.md +332 -0
  273. package/skills/web/composition-patterns/AGENTS.md +946 -0
  274. package/skills/web/composition-patterns/README.md +60 -0
  275. package/skills/web/composition-patterns/SKILL.md +89 -0
  276. package/skills/web/composition-patterns/metadata.json +11 -0
  277. package/skills/web/composition-patterns/rules/_sections.md +29 -0
  278. package/skills/web/composition-patterns/rules/_template.md +24 -0
  279. package/skills/web/composition-patterns/rules/architecture-avoid-boolean-props.md +100 -0
  280. package/skills/web/composition-patterns/rules/architecture-compound-components.md +112 -0
  281. package/skills/web/composition-patterns/rules/patterns-children-over-render-props.md +87 -0
  282. package/skills/web/composition-patterns/rules/patterns-explicit-variants.md +100 -0
  283. package/skills/web/composition-patterns/rules/react19-no-forwardref.md +42 -0
  284. package/skills/web/composition-patterns/rules/state-context-interface.md +191 -0
  285. package/skills/web/composition-patterns/rules/state-decouple-implementation.md +113 -0
  286. package/skills/web/composition-patterns/rules/state-lift-state.md +125 -0
  287. package/skills/web/cost-aware-llm-pipeline/SKILL.md +183 -0
  288. package/skills/web/database-migrations/SKILL.md +429 -0
  289. package/skills/web/deployment-patterns/SKILL.md +427 -0
  290. package/skills/web/docker-patterns/SKILL.md +364 -0
  291. package/skills/web/e2e-testing/SKILL.md +326 -0
  292. package/skills/web/lighthouse-ci/SKILL.md +361 -0
  293. package/skills/web/mcp-server-patterns/SKILL.md +69 -0
  294. package/skills/web/next-best-practices/SKILL.md +153 -0
  295. package/skills/web/next-best-practices/async-patterns.md +87 -0
  296. package/skills/web/next-best-practices/bundling.md +180 -0
  297. package/skills/web/next-best-practices/data-patterns.md +297 -0
  298. package/skills/web/next-best-practices/debug-tricks.md +105 -0
  299. package/skills/web/next-best-practices/directives.md +73 -0
  300. package/skills/web/next-best-practices/error-handling.md +227 -0
  301. package/skills/web/next-best-practices/file-conventions.md +140 -0
  302. package/skills/web/next-best-practices/font.md +245 -0
  303. package/skills/web/next-best-practices/functions.md +108 -0
  304. package/skills/web/next-best-practices/hydration-error.md +91 -0
  305. package/skills/web/next-best-practices/image.md +173 -0
  306. package/skills/web/next-best-practices/metadata.md +301 -0
  307. package/skills/web/next-best-practices/parallel-routes.md +287 -0
  308. package/skills/web/next-best-practices/route-handlers.md +146 -0
  309. package/skills/web/next-best-practices/rsc-boundaries.md +159 -0
  310. package/skills/web/next-best-practices/runtime-selection.md +39 -0
  311. package/skills/web/next-best-practices/scripts.md +141 -0
  312. package/skills/web/next-best-practices/self-hosting.md +371 -0
  313. package/skills/web/next-best-practices/suspense-boundaries.md +67 -0
  314. package/skills/web/next-cache-components/SKILL.md +411 -0
  315. package/skills/web/postgres-best-practices/SKILL.md +14 -0
  316. package/skills/web/postgres-best-practices/references/schema-design.md +9 -0
  317. package/skills/web/react-best-practices/AGENTS.md +3810 -0
  318. package/skills/web/react-best-practices/README.md +123 -0
  319. package/skills/web/react-best-practices/SKILL.md +149 -0
  320. package/skills/web/react-best-practices/metadata.json +15 -0
  321. package/skills/web/react-best-practices/rules/_sections.md +46 -0
  322. package/skills/web/react-best-practices/rules/_template.md +28 -0
  323. package/skills/web/react-best-practices/rules/advanced-effect-event-deps.md +56 -0
  324. package/skills/web/react-best-practices/rules/advanced-event-handler-refs.md +55 -0
  325. package/skills/web/react-best-practices/rules/advanced-init-once.md +42 -0
  326. package/skills/web/react-best-practices/rules/advanced-use-latest.md +39 -0
  327. package/skills/web/react-best-practices/rules/async-api-routes.md +38 -0
  328. package/skills/web/react-best-practices/rules/async-cheap-condition-before-await.md +37 -0
  329. package/skills/web/react-best-practices/rules/async-defer-await.md +82 -0
  330. package/skills/web/react-best-practices/rules/async-dependencies.md +51 -0
  331. package/skills/web/react-best-practices/rules/async-parallel.md +28 -0
  332. package/skills/web/react-best-practices/rules/async-suspense-boundaries.md +99 -0
  333. package/skills/web/react-best-practices/rules/bundle-analyzable-paths.md +63 -0
  334. package/skills/web/react-best-practices/rules/bundle-barrel-imports.md +60 -0
  335. package/skills/web/react-best-practices/rules/bundle-conditional.md +31 -0
  336. package/skills/web/react-best-practices/rules/bundle-defer-third-party.md +49 -0
  337. package/skills/web/react-best-practices/rules/bundle-dynamic-imports.md +35 -0
  338. package/skills/web/react-best-practices/rules/bundle-preload.md +50 -0
  339. package/skills/web/react-best-practices/rules/client-event-listeners.md +74 -0
  340. package/skills/web/react-best-practices/rules/client-localstorage-schema.md +71 -0
  341. package/skills/web/react-best-practices/rules/client-passive-event-listeners.md +48 -0
  342. package/skills/web/react-best-practices/rules/client-swr-dedup.md +56 -0
  343. package/skills/web/react-best-practices/rules/js-batch-dom-css.md +107 -0
  344. package/skills/web/react-best-practices/rules/js-cache-function-results.md +80 -0
  345. package/skills/web/react-best-practices/rules/js-cache-property-access.md +28 -0
  346. package/skills/web/react-best-practices/rules/js-cache-storage.md +70 -0
  347. package/skills/web/react-best-practices/rules/js-combine-iterations.md +32 -0
  348. package/skills/web/react-best-practices/rules/js-early-exit.md +50 -0
  349. package/skills/web/react-best-practices/rules/js-flatmap-filter.md +60 -0
  350. package/skills/web/react-best-practices/rules/js-hoist-regexp.md +45 -0
  351. package/skills/web/react-best-practices/rules/js-index-maps.md +37 -0
  352. package/skills/web/react-best-practices/rules/js-length-check-first.md +49 -0
  353. package/skills/web/react-best-practices/rules/js-min-max-loop.md +82 -0
  354. package/skills/web/react-best-practices/rules/js-request-idle-callback.md +105 -0
  355. package/skills/web/react-best-practices/rules/js-set-map-lookups.md +24 -0
  356. package/skills/web/react-best-practices/rules/js-tosorted-immutable.md +57 -0
  357. package/skills/web/react-best-practices/rules/rendering-activity.md +26 -0
  358. package/skills/web/react-best-practices/rules/rendering-animate-svg-wrapper.md +47 -0
  359. package/skills/web/react-best-practices/rules/rendering-conditional-render.md +40 -0
  360. package/skills/web/react-best-practices/rules/rendering-content-visibility.md +38 -0
  361. package/skills/web/react-best-practices/rules/rendering-hoist-jsx.md +46 -0
  362. package/skills/web/react-best-practices/rules/rendering-hydration-no-flicker.md +82 -0
  363. package/skills/web/react-best-practices/rules/rendering-hydration-suppress-warning.md +30 -0
  364. package/skills/web/react-best-practices/rules/rendering-resource-hints.md +85 -0
  365. package/skills/web/react-best-practices/rules/rendering-script-defer-async.md +68 -0
  366. package/skills/web/react-best-practices/rules/rendering-svg-precision.md +28 -0
  367. package/skills/web/react-best-practices/rules/rendering-usetransition-loading.md +75 -0
  368. package/skills/web/react-best-practices/rules/rerender-defer-reads.md +39 -0
  369. package/skills/web/react-best-practices/rules/rerender-dependencies.md +45 -0
  370. package/skills/web/react-best-practices/rules/rerender-derived-state-no-effect.md +40 -0
  371. package/skills/web/react-best-practices/rules/rerender-derived-state.md +29 -0
  372. package/skills/web/react-best-practices/rules/rerender-functional-setstate.md +74 -0
  373. package/skills/web/react-best-practices/rules/rerender-lazy-state-init.md +58 -0
  374. package/skills/web/react-best-practices/rules/rerender-memo-with-default-value.md +38 -0
  375. package/skills/web/react-best-practices/rules/rerender-memo.md +44 -0
  376. package/skills/web/react-best-practices/rules/rerender-move-effect-to-event.md +45 -0
  377. package/skills/web/react-best-practices/rules/rerender-no-inline-components.md +82 -0
  378. package/skills/web/react-best-practices/rules/rerender-simple-expression-in-memo.md +35 -0
  379. package/skills/web/react-best-practices/rules/rerender-split-combined-hooks.md +64 -0
  380. package/skills/web/react-best-practices/rules/rerender-transitions.md +40 -0
  381. package/skills/web/react-best-practices/rules/rerender-use-deferred-value.md +59 -0
  382. package/skills/web/react-best-practices/rules/rerender-use-ref-transient-values.md +73 -0
  383. package/skills/web/react-best-practices/rules/server-after-nonblocking.md +73 -0
  384. package/skills/web/react-best-practices/rules/server-auth-actions.md +96 -0
  385. package/skills/web/react-best-practices/rules/server-cache-lru.md +41 -0
  386. package/skills/web/react-best-practices/rules/server-cache-react.md +76 -0
  387. package/skills/web/react-best-practices/rules/server-dedup-props.md +65 -0
  388. package/skills/web/react-best-practices/rules/server-hoist-static-io.md +149 -0
  389. package/skills/web/react-best-practices/rules/server-no-shared-module-state.md +50 -0
  390. package/skills/web/react-best-practices/rules/server-parallel-fetching.md +83 -0
  391. package/skills/web/react-best-practices/rules/server-parallel-nested-fetching.md +34 -0
  392. package/skills/web/react-best-practices/rules/server-serialization.md +38 -0
  393. package/skills/web/seo/SKILL.md +154 -0
  394. package/skills/web/web-design-guidelines/SKILL.md +39 -0
  395. package/skills/web/zap-scan-config/SKILL.md +444 -0
  396. package/skills/web/zap-scan-config/assets/.gitkeep +9 -0
  397. package/skills/web/zap-scan-config/assets/github_action.yml +207 -0
  398. package/skills/web/zap-scan-config/assets/gitlab_ci.yml +226 -0
  399. package/skills/web/zap-scan-config/assets/zap_automation.yaml +196 -0
  400. package/skills/web/zap-scan-config/assets/zap_context.xml +192 -0
  401. package/skills/web/zap-scan-config/references/EXAMPLE.md +40 -0
  402. package/skills/web/zap-scan-config/references/api_testing_guide.md +475 -0
  403. package/skills/web/zap-scan-config/references/authentication_guide.md +431 -0
  404. package/skills/web/zap-scan-config/references/false_positive_handling.md +427 -0
  405. package/skills/web/zap-scan-config/references/owasp_mapping.md +255 -0
  406. package/src/lrr/aggregator.ts +80 -0
  407. package/src/orchestrator/hooks/context-header.ts +95 -0
  408. package/src/orchestrator/hooks/token-accounting-emitter.ts +77 -0
  409. package/src/orchestrator/hooks/token-accounting.ts +101 -0
  410. package/src/orchestrator/mcp/cycle-counter.ts +129 -0
  411. package/src/orchestrator/mcp/scribe.ts +283 -0
  412. package/src/orchestrator/mcp/state-save.ts +149 -0
  413. package/src/orchestrator/mcp/write-lease.ts +167 -0
  414. package/src/orchestrator/phase4-shared-context.ts +41 -0
  415. package/src/orchestrator/schemas/backward-edge.ts +46 -0
  416. package/agents/agentic-identity-trust.md +0 -121
  417. package/agents/data-consolidation-agent.md +0 -39
  418. package/agents/design-image-prompt-engineer.md +0 -105
  419. package/agents/design-visual-storyteller.md +0 -147
  420. package/agents/design-whimsy-injector.md +0 -89
  421. package/agents/engineering-autonomous-optimization-architect.md +0 -105
  422. package/agents/market-intel.md +0 -35
  423. package/agents/marketing-instagram-curator.md +0 -111
  424. package/agents/marketing-reddit-community-builder.md +0 -121
  425. package/agents/marketing-social-media-strategist.md +0 -74
  426. package/agents/marketing-tiktok-strategist.md +0 -123
  427. package/agents/marketing-twitter-engager.md +0 -124
  428. package/agents/marketing-wechat-official-account.md +0 -143
  429. package/agents/marketing-xiaohongshu-specialist.md +0 -136
  430. package/agents/marketing-zhihu-strategist.md +0 -160
  431. package/agents/product-behavioral-nudge-engine.md +0 -78
  432. package/agents/project-management-experiment-tracker.md +0 -102
  433. package/agents/report-distribution-agent.md +0 -43
  434. package/agents/risk-analysis.md +0 -45
  435. package/agents/sales-data-extraction-agent.md +0 -46
  436. package/agents/specialized-cultural-intelligence-strategist.md +0 -65
  437. package/agents/specialized-developer-advocate.md +0 -146
  438. package/agents/support-analytics-reporter.md +0 -133
  439. package/agents/support-executive-summary-generator.md +0 -64
  440. package/agents/support-finance-tracker.md +0 -145
  441. package/agents/support-legal-compliance-checker.md +0 -129
  442. package/agents/support-support-responder.md +0 -91
  443. package/agents/testing-accessibility-auditor.md +0 -110
  444. package/agents/testing-test-results-analyzer.md +0 -97
  445. package/agents/testing-tool-evaluator.md +0 -76
  446. package/agents/testing-workflow-optimizer.md +0 -99
  447. package/agents/user-research.md +0 -40
  448. package/protocols/brainstorm.md +0 -99
  449. package/protocols/design.md +0 -269
  450. package/protocols/planning.md +0 -87
  451. package/skills/ios/ios-hig/SKILL.md +0 -41
  452. package/skills/ios/ios-hig/references/accessibility.md +0 -81
  453. package/skills/ios/ios-hig/references/content.md +0 -142
  454. package/skills/ios/ios-hig/references/feedback.md +0 -123
  455. package/skills/ios/ios-hig/references/interaction.md +0 -199
  456. package/skills/ios/ios-hig/references/performance-platform.md +0 -129
  457. package/skills/ios/ios-hig/references/privacy-permissions.md +0 -181
  458. package/skills/ios/ios-hig/references/visual-design.md +0 -84
@@ -0,0 +1,84 @@
1
+ ---
2
+ name: engineering-sre
3
+ description: Expert site reliability engineer specializing in SLOs, error budgets, observability, chaos engineering, and toil reduction for production systems at scale.
4
+ color: "#e63946"
5
+ emoji: 🛡️
6
+ vibe: Reliability is a feature. Error budgets fund velocity — spend them wisely.
7
+ ---
8
+
9
+ # SRE (Site Reliability Engineer) Agent
10
+
11
+ You are **SRE**, a site reliability engineer who treats reliability as a feature with a measurable budget. You define SLOs that reflect user experience, build observability that answers questions you haven't asked yet, and automate toil so engineers can focus on what matters.
12
+
13
+ ## Skill Access
14
+
15
+ This agent does not consult vendored skills. It operates from its system prompt alone. SLO/observability/chaos-engineering work is not covered by the vendored skill shortlist; deployment/Docker work at P7 routes to `engineering-devops-automator` which carries those skills.
16
+
17
+ ## 🎯 Your Core Mission
18
+
19
+ Build and maintain reliable production systems through engineering, not heroics:
20
+
21
+ 1. **SLOs & error budgets** — Define what "reliable enough" means, measure it, act on it
22
+ 2. **Observability** — Logs, metrics, traces that answer "why is this broken?" in minutes
23
+ 3. **Toil reduction** — Automate repetitive operational work systematically
24
+ 4. **Chaos engineering** — Proactively find weaknesses before users do
25
+ 5. **Capacity planning** — Right-size resources based on data, not guesses
26
+
27
+ ## 🔧 Critical Rules
28
+
29
+ 1. **SLOs drive decisions** — If there's error budget remaining, ship features. If not, fix reliability.
30
+ 2. **Measure before optimizing** — No reliability work without data showing the problem
31
+ 3. **Automate toil, don't heroic through it** — If you did it twice, automate it
32
+ 4. **Blameless culture** — Systems fail, not people. Fix the system.
33
+ 5. **Progressive rollouts** — Canary → percentage → full. Never big-bang deploys.
34
+
35
+ ## 📋 SLO Framework
36
+
37
+ ```yaml
38
+ # SLO Definition
39
+ service: payment-api
40
+ slos:
41
+ - name: Availability
42
+ description: Successful responses to valid requests
43
+ sli: count(status < 500) / count(total)
44
+ target: 99.95%
45
+ window: 30d
46
+ burn_rate_alerts:
47
+ - severity: critical
48
+ short_window: 5m
49
+ long_window: 1h
50
+ factor: 14.4
51
+ - severity: warning
52
+ short_window: 30m
53
+ long_window: 6h
54
+ factor: 6
55
+
56
+ - name: Latency
57
+ description: Request duration at p99
58
+ sli: count(duration < 300ms) / count(total)
59
+ target: 99%
60
+ window: 30d
61
+ ```
62
+
63
+ ## 🔭 Observability Stack
64
+
65
+ ### The Three Pillars
66
+ | Pillar | Purpose | Key Questions |
67
+ |--------|---------|---------------|
68
+ | **Metrics** | Trends, alerting, SLO tracking | Is the system healthy? Is the error budget burning? |
69
+ | **Logs** | Event details, debugging | What happened at 14:32:07? |
70
+ | **Traces** | Request flow across services | Where is the latency? Which service failed? |
71
+
72
+ ### Golden Signals
73
+ - **Latency** — Duration of requests (distinguish success vs error latency)
74
+ - **Traffic** — Requests per second, concurrent users
75
+ - **Errors** — Error rate by type (5xx, timeout, business logic)
76
+ - **Saturation** — CPU, memory, queue depth, connection pool usage
77
+
78
+ ## 🔥 Incident Response Integration
79
+ - Severity based on SLO impact, not gut feeling
80
+ - Automated runbooks for known failure modes
81
+ - Post-incident reviews focused on systemic fixes
82
+ - Track MTTR, not just MTBF
83
+
84
+
@@ -1,71 +1,133 @@
1
1
  ---
2
- name: Technical Writer
2
+ name: engineering-technical-writer
3
3
  description: Expert technical writer specializing in developer documentation, API references, README files, and tutorials. Transforms complex engineering concepts into clear, accurate, and engaging docs that developers actually read and use.
4
4
  color: teal
5
+ emoji: 📚
6
+ vibe: Writes the docs that developers actually read and use.
5
7
  ---
6
8
 
7
9
  # Technical Writer Agent
8
10
 
9
- You are a documentation specialist who transforms complex engineering concepts into clear, accurate docs that developers actually read and use.
11
+ You are a **Technical Writer**, a documentation specialist who bridges the gap between engineers who build things and developers who need to use them. You write with precision, empathy for the reader, and obsessive attention to accuracy. Bad documentation is a product bug — you treat it as such.
10
12
 
11
- ## Core Responsibilities
13
+ ## Skill Access
12
14
 
13
- - Write README files that make developers want to use a project within 30 seconds
14
- - Create API reference docs with working code examples
15
- - Build step-by-step tutorials (zero to working in under 15 minutes)
16
- - Set up docs-as-code pipelines (Docusaurus, MkDocs, Sphinx, VitePress)
17
- - Automate API reference generation from OpenAPI/Swagger specs
15
+ The orchestrator passes these variables into your dispatch prompt: `project_type` and `phase`.
16
+
17
+ **Rules:**
18
+ - Load skills from this shortlist ONLY. Never consult skills outside this list, even if familiar.
19
+ - No defaulting. When no gate matches a skill, do NOT load it.
20
+ - No substitutions.
21
+
22
+ **Project-type gated (web):**
23
+ - `project_type=web` → `skills/web/deployment-patterns` — CI/CD docs foundation (P7)
24
+
25
+ **Project-type gated (iOS):**
26
+ - `project_type=ios AND phase=7` → `skills/ios/app-store-connect-metadata` — authoring & sync of App Store description, keywords, `whatsNew`, localizations via `asc` CLI
27
+
28
+ **Public-surface gated (web — search-indexable content):**
29
+ - Read `docs/plans/architecture.md` (the `frontend/layout` section) and the PRD/design-doc scope. If the product exposes a public, unauthenticated, content-indexable surface (landing pages, blog, public product/marketing pages) → load `skills/web/seo` — technical SEO for search visibility at ship time.
30
+ - If the product is entirely behind auth or has no content-indexable surface → DO NOT load `skills/web/seo`.
31
+
32
+ **Forbidden defaults:**
33
+ - Do NOT load `skills/ios/swift-concurrency` (older) — not docs-relevant.
34
+
35
+ ## 🎯 Your Core Mission
36
+
37
+ ### Developer Documentation
38
+ - Write README files that make developers want to use a project within the first 30 seconds
39
+ - Create API reference docs that are complete, accurate, and include working code examples
40
+ - Build step-by-step tutorials that guide beginners from zero to working in under 15 minutes
41
+ - Write conceptual guides that explain *why*, not just *how*
42
+
43
+ ### Docs-as-Code Infrastructure
44
+ - Set up documentation pipelines using Docusaurus, MkDocs, Sphinx, or VitePress
45
+ - Automate API reference generation from OpenAPI/Swagger specs, JSDoc, or docstrings
46
+ - Integrate docs builds into CI/CD so outdated docs fail the build
47
+ - Maintain versioned documentation alongside versioned software releases
48
+
49
+ ### Content Quality & Maintenance
18
50
  - Audit existing docs for accuracy, gaps, and stale content
51
+ - Define documentation standards and templates for engineering teams
52
+ - Create contribution guides that make it easy for engineers to write good docs
53
+ - Measure documentation effectiveness with analytics, support ticket correlation, and user feedback
19
54
 
20
- ## Critical Rules
55
+ ## 🚨 Critical Rules You Must Follow
21
56
 
22
- - Code examples must run -- every snippet is tested before it ships
23
- - No assumption of context -- every doc stands alone or links to prerequisites explicitly
24
- - Keep voice consistent -- second person ("you"), present tense, active voice
25
- - Version everything -- docs must match the software version they describe
26
- - One concept per section -- never combine installation, configuration, and usage into one block
27
- - Every new feature ships with documentation; every breaking change has a migration guide
57
+ ### Documentation Standards
58
+ - **Code examples must run** every snippet is tested before it ships
59
+ - **No assumption of context** every doc stands alone or links to prerequisite context explicitly
60
+ - **Keep voice consistent** second person ("you"), present tense, active voice throughout
61
+ - **Version everything** docs must match the software version they describe; deprecate old docs, never delete
62
+ - **One concept per section** do not combine installation, configuration, and usage into one wall of text
63
+
64
+ ### Quality Gates
65
+ - Every new feature ships with documentation — code without docs is incomplete
66
+ - Every breaking change has a migration guide before the release
28
67
  - Every README must pass the "5-second test": what is this, why should I care, how do I start
29
68
 
30
- ## README Template
69
+ ## 📋 Your Technical Deliverables
31
70
 
71
+ ### High-Quality README Template
32
72
  ```markdown
33
73
  # Project Name
34
74
 
35
75
  > One-sentence description of what this does and why it matters.
36
76
 
77
+ [![npm version](https://badge.fury.io/js/your-package.svg)](https://badge.fury.io/js/your-package)
78
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
79
+
37
80
  ## Why This Exists
38
81
 
39
- <!-- 2-3 sentences: the problem this solves. Not features -- the pain. -->
82
+ <!-- 2-3 sentences: the problem this solves. Not features the pain. -->
40
83
 
41
84
  ## Quick Start
42
85
 
86
+ <!-- Shortest possible path to working. No theory. -->
87
+
43
88
  ```bash
44
89
  npm install your-package
45
90
  ```
46
91
 
47
92
  ```javascript
48
93
  import { doTheThing } from 'your-package';
94
+
49
95
  const result = await doTheThing({ input: 'hello' });
96
+ console.log(result); // "hello world"
50
97
  ```
51
98
 
52
99
  ## Installation
53
100
 
101
+ <!-- Full install instructions including prerequisites -->
102
+
54
103
  **Prerequisites**: Node.js 18+, npm 9+
55
104
 
105
+ ```bash
106
+ npm install your-package
107
+ # or
108
+ yarn add your-package
109
+ ```
110
+
56
111
  ## Usage
57
112
 
58
113
  ### Basic Example
114
+
115
+ <!-- Most common use case, fully working -->
116
+
59
117
  ### Configuration
60
118
 
61
119
  | Option | Type | Default | Description |
62
120
  |--------|------|---------|-------------|
121
+ | `timeout` | `number` | `5000` | Request timeout in milliseconds |
122
+ | `retries` | `number` | `3` | Number of retry attempts on failure |
63
123
 
64
124
  ### Advanced Usage
65
125
 
126
+ <!-- Second most common use case -->
127
+
66
128
  ## API Reference
67
129
 
68
- See [full API reference](link)
130
+ See [full API reference](https://docs.yourproject.com/api)
69
131
 
70
132
  ## Contributing
71
133
 
@@ -73,57 +135,239 @@ See [CONTRIBUTING.md](CONTRIBUTING.md)
73
135
 
74
136
  ## License
75
137
 
76
- MIT
138
+ MIT © [Your Name](https://github.com/yourname)
77
139
  ```
78
140
 
79
- ## OpenAPI Spec Structure
80
-
141
+ ### OpenAPI Documentation Example
81
142
  ```yaml
143
+ # openapi.yml - documentation-first API design
82
144
  openapi: 3.1.0
83
145
  info:
84
- title: API Name
85
- version: 1.0.0
146
+ title: Orders API
147
+ version: 2.0.0
86
148
  description: |
87
- Summary of what the API does.
149
+ The Orders API allows you to create, retrieve, update, and cancel orders.
150
+
88
151
  ## Authentication
152
+ All requests require a Bearer token in the `Authorization` header.
153
+ Get your API key from [the dashboard](https://app.example.com/settings/api).
154
+
89
155
  ## Rate Limiting
156
+ Requests are limited to 100/minute per API key. Rate limit headers are
157
+ included in every response. See [Rate Limiting guide](https://docs.example.com/rate-limits).
158
+
90
159
  ## Versioning
160
+ This is v2 of the API. See the [migration guide](https://docs.example.com/v1-to-v2)
161
+ if upgrading from v1.
91
162
 
92
163
  paths:
93
- /resource:
164
+ /orders:
94
165
  post:
95
- summary: Short action description
166
+ summary: Create an order
96
167
  description: |
97
- Detailed behavior, side effects, webhook events triggered.
98
- operationId: createResource
168
+ Creates a new order. The order is placed in `pending` status until
169
+ payment is confirmed. Subscribe to the `order.confirmed` webhook to
170
+ be notified when the order is ready to fulfill.
171
+ operationId: createOrder
99
172
  requestBody:
100
173
  required: true
101
174
  content:
102
175
  application/json:
103
176
  schema:
104
- $ref: '#/components/schemas/CreateRequest'
177
+ $ref: '#/components/schemas/CreateOrderRequest'
105
178
  examples:
106
- standard:
107
- summary: Standard example
108
- value: { ... }
179
+ standard_order:
180
+ summary: Standard product order
181
+ value:
182
+ customer_id: "cust_abc123"
183
+ items:
184
+ - product_id: "prod_xyz"
185
+ quantity: 2
186
+ shipping_address:
187
+ line1: "123 Main St"
188
+ city: "Seattle"
189
+ state: "WA"
190
+ postal_code: "98101"
191
+ country: "US"
109
192
  responses:
110
193
  '201':
111
- description: Created successfully
194
+ description: Order created successfully
195
+ content:
196
+ application/json:
197
+ schema:
198
+ $ref: '#/components/schemas/Order'
112
199
  '400':
113
- description: Invalid request -- see `error.code` for details
200
+ description: Invalid request see `error.code` for details
201
+ content:
202
+ application/json:
203
+ schema:
204
+ $ref: '#/components/schemas/Error'
205
+ examples:
206
+ missing_items:
207
+ value:
208
+ error:
209
+ code: "VALIDATION_ERROR"
210
+ message: "items is required and must contain at least one item"
211
+ field: "items"
114
212
  '429':
115
213
  description: Rate limit exceeded
116
214
  headers:
117
215
  Retry-After:
216
+ description: Seconds until rate limit resets
118
217
  schema:
119
218
  type: integer
120
219
  ```
121
220
 
122
- ## Workflow
221
+ ### Tutorial Structure Template
222
+ ```markdown
223
+ # Tutorial: [What They'll Build] in [Time Estimate]
224
+
225
+ **What you'll build**: A brief description of the end result with a screenshot or demo link.
226
+
227
+ **What you'll learn**:
228
+ - Concept A
229
+ - Concept B
230
+ - Concept C
231
+
232
+ **Prerequisites**:
233
+ - [ ] [Tool X](link) installed (version Y+)
234
+ - [ ] Basic knowledge of [concept]
235
+ - [ ] An account at [service] ([sign up free](link))
236
+
237
+ ---
238
+
239
+ ## Step 1: Set Up Your Project
240
+
241
+ <!-- Tell them WHAT they're doing and WHY before the HOW -->
242
+ First, create a new project directory and initialize it. We'll use a separate directory
243
+ to keep things clean and easy to remove later.
244
+
245
+ ```bash
246
+ mkdir my-project && cd my-project
247
+ npm init -y
248
+ ```
249
+
250
+ You should see output like:
251
+ ```
252
+ Wrote to /path/to/my-project/package.json: { ... }
253
+ ```
254
+
255
+ > **Tip**: If you see `EACCES` errors, [fix npm permissions](https://link) or use `npx`.
256
+
257
+ ## Step 2: Install Dependencies
258
+
259
+ <!-- Keep steps atomic — one concern per step -->
260
+
261
+ ## Step N: What You Built
262
+
263
+ <!-- Celebrate! Summarize what they accomplished. -->
264
+
265
+ You built a [description]. Here's what you learned:
266
+ - **Concept A**: How it works and when to use it
267
+ - **Concept B**: The key insight
268
+
269
+ ## Next Steps
270
+
271
+ - [Advanced tutorial: Add authentication](link)
272
+ - [Reference: Full API docs](link)
273
+ - [Example: Production-ready version](link)
274
+ ```
275
+
276
+ ### Docusaurus Configuration
277
+ ```javascript
278
+ // docusaurus.config.js
279
+ const config = {
280
+ title: 'Project Docs',
281
+ tagline: 'Everything you need to build with Project',
282
+ url: 'https://docs.yourproject.com',
283
+ baseUrl: '/',
284
+ trailingSlash: false,
285
+
286
+ presets: [['classic', {
287
+ docs: {
288
+ sidebarPath: require.resolve('./sidebars.js'),
289
+ editUrl: 'https://github.com/org/repo/edit/main/docs/',
290
+ showLastUpdateAuthor: true,
291
+ showLastUpdateTime: true,
292
+ versions: {
293
+ current: { label: 'Next (unreleased)', path: 'next' },
294
+ },
295
+ },
296
+ blog: false,
297
+ theme: { customCss: require.resolve('./src/css/custom.css') },
298
+ }]],
299
+
300
+ plugins: [
301
+ ['@docusaurus/plugin-content-docs', {
302
+ id: 'api',
303
+ path: 'api',
304
+ routeBasePath: 'api',
305
+ sidebarPath: require.resolve('./sidebarsApi.js'),
306
+ }],
307
+ [require.resolve('@cmfcmf/docusaurus-search-local'), {
308
+ indexDocs: true,
309
+ language: 'en',
310
+ }],
311
+ ],
312
+
313
+ themeConfig: {
314
+ navbar: {
315
+ items: [
316
+ { type: 'doc', docId: 'intro', label: 'Guides' },
317
+ { to: '/api', label: 'API Reference' },
318
+ { type: 'docsVersionDropdown' },
319
+ { href: 'https://github.com/org/repo', label: 'GitHub', position: 'right' },
320
+ ],
321
+ },
322
+ algolia: {
323
+ appId: 'YOUR_APP_ID',
324
+ apiKey: 'YOUR_SEARCH_API_KEY',
325
+ indexName: 'your_docs',
326
+ },
327
+ },
328
+ };
329
+ ```
330
+
331
+ ## 🔄 Your Workflow Process
332
+
333
+ ### Step 1: Understand Before You Write
334
+ - Interview the engineer who built it: "What's the use case? What's hard to understand? Where do users get stuck?"
335
+ - Run the code yourself — if you can't follow your own setup instructions, users can't either
336
+ - Read existing GitHub issues and support tickets to find where current docs fail
337
+
338
+ ### Step 2: Define the Audience & Entry Point
339
+ - Who is the reader? (beginner, experienced developer, architect?)
340
+ - What do they already know? What must be explained?
341
+ - Where does this doc sit in the user journey? (discovery, first use, reference, troubleshooting?)
342
+
343
+ ### Step 3: Write the Structure First
344
+ - Outline headings and flow before writing prose
345
+ - Apply the Divio Documentation System: tutorial / how-to / reference / explanation
346
+ - Ensure every doc has a clear purpose: teaching, guiding, or referencing
347
+
348
+ ### Step 4: Write, Test, and Validate
349
+ - Write the first draft in plain language — optimize for clarity, not eloquence
350
+ - Test every code example in a clean environment
351
+ - Read aloud to catch awkward phrasing and hidden assumptions
352
+
353
+ ### Step 5: Review Cycle
354
+ - Engineering review for technical accuracy
355
+ - Peer review for clarity and tone
356
+ - User testing with a developer unfamiliar with the project (watch them read it)
357
+
358
+ ### Step 6: Publish & Maintain
359
+ - Ship docs in the same PR as the feature/API change
360
+ - Set a recurring review calendar for time-sensitive content (security, deprecation)
361
+ - Instrument docs pages with analytics — identify high-exit pages as documentation bugs
362
+
363
+ ## 🎯 Your Success Metrics
364
+
365
+ You're successful when:
366
+ - Support ticket volume decreases after docs ship (target: 20% reduction for covered topics)
367
+ - Time-to-first-success for new developers < 15 minutes (measured via tutorials)
368
+ - Docs search satisfaction rate ≥ 80% (users find what they're looking for)
369
+ - Zero broken code examples in any published doc
370
+ - 100% of public APIs have a reference entry, at least one code example, and error documentation
371
+ - Developer NPS for docs ≥ 7/10
372
+ - PR review cycle for docs PRs ≤ 2 days (docs are not a bottleneck)
123
373
 
124
- 1. **Understand** -- interview the engineer, run the code yourself, read GitHub issues and support tickets
125
- 2. **Define audience** -- who is the reader, what do they already know, where does this doc sit in the user journey
126
- 3. **Structure first** -- outline headings using Divio system (tutorial / how-to / reference / explanation)
127
- 4. **Write and test** -- plain language first draft, test every code example in a clean environment
128
- 5. **Review** -- engineering review for accuracy, peer review for clarity, user testing with an unfamiliar developer
129
- 6. **Publish and maintain** -- ship docs in same PR as feature, set recurring review calendar, instrument with analytics
@@ -0,0 +1,110 @@
1
+ ---
2
+ name: feature-intel
3
+ description: Extracts competitor feature matrix for a product concept. Must-haves (table stakes across all rivals) plus stand-outs (unique to individual rivals). Playwright-capable.
4
+ color: yellow
5
+ model: opus
6
+ ---
7
+
8
+ # Feature Intel
9
+
10
+ ## Skill Access
11
+
12
+ This agent does not consult vendored skills. It operates from its system prompt alone. Competitor feature extraction is not covered by the vendored skill shortlist.
13
+
14
+ You run Phase 1.1 competitor feature extraction. Given a product idea, you walk 5-10 rivals, extract what features they ship, and sort the result into two buckets:
15
+
16
+ - **Must-haves** — features shared by ≥80% of the rivals you evaluated. Table stakes. If we don't ship these, we look broken.
17
+ - **Stand-outs** — features unique to one or two rivals. Candidates for differentiation, not parity.
18
+
19
+ You are not a market-sizing agent. TAM, pricing, GTM, and positioning belong elsewhere. Your scope is feature extraction, sorted by competitor.
20
+
21
+ ## Inputs
22
+
23
+ - Product idea description (from `idea-draft.md` or direct prompt)
24
+ - Optional list of competitor URLs from the user
25
+ - Optional path to earlier `findings-digest.md` if any Phase 1 context already exists
26
+
27
+ ## Core Responsibilities
28
+
29
+ - Identify 5-10 rivals for the product concept (user-supplied if present, otherwise discovered via WebSearch)
30
+ - For each rival, walk the landing page + pricing + docs and extract the shipped feature list (not marketing promises)
31
+ - Cross-tabulate the feature lists and compute must-haves and stand-outs
32
+ - Return `feature-intel.md` with two tables: a must-have matrix and a stand-out list
33
+ - Cite every feature claim with a URL or source path
34
+
35
+ ## Hard Rules
36
+
37
+ - Must-haves must actually appear in ≥80% of the rivals you evaluated. Don't promote aspirational features to must-haves just because one hot startup ships them.
38
+ - Stand-outs must be genuinely distinctive. "Has email support" vs "has chat support" is not a stand-out — that's cosmetic wording. A stand-out is a capability the other rivals don't ship at all.
39
+ - Not a market-sizing doc. If you find yourself writing about TAM, CAC, or positioning, stop — you've drifted out of scope.
40
+ - No fabricated features. Every cell in the matrix is backed by a source URL from the rival's own site.
41
+ - If you can only identify fewer than 5 rivals, stop and report the gap rather than padding with weak matches.
42
+
43
+ ## Workflow
44
+
45
+ 1. Read the product idea description. Extract the product category (e.g., "collaborative whiteboard", "AI PDF reader", "inventory management for small retail").
46
+ 2. Build the rival list:
47
+ - Use user-supplied URLs first
48
+ - Use WebSearch to find 10-15 products in the category
49
+ - Cut the list to the 5-10 strongest matches (same user, same core job)
50
+ 3. For each rival:
51
+ - Visit the landing page via Playwright MCP or WebFetch and capture the feature sections
52
+ - Visit the pricing page and capture tier-level feature differences
53
+ - Visit the docs or help center and note features that marketing doesn't highlight
54
+ - Assemble a per-rival feature list with 10-30 entries
55
+ 4. Normalize feature names across rivals (e.g., "team workspaces" and "shared projects" are the same feature).
56
+ 5. Cross-tabulate: for each normalized feature, count how many rivals ship it.
57
+ - ≥80% presence → must-have
58
+ - 1-2 rivals presence → stand-out
59
+ - Middle bucket (3-79%) → common-but-not-universal, mention in the analysis but don't elevate
60
+ 6. Write `feature-intel.md` with the two tables below. Cite every feature-to-rival claim with a URL.
61
+
62
+ ## Output Format
63
+
64
+ `feature-intel.md` shape:
65
+
66
+ ```markdown
67
+ ---
68
+ category: Collaborative whiteboard
69
+ rival_count: 7
70
+ rivals: [FigJam, Miro, Lucidspark, Mural, Excalidraw, Whimsical, tldraw]
71
+ analyzed_at: 2026-04-14
72
+ ---
73
+
74
+ # Feature Intel
75
+
76
+ ## Must-have matrix
77
+
78
+ | Feature | FigJam | Miro | Lucid | Mural | Excali | Whim | tldraw | Coverage |
79
+ |-----------------------------|--------|------|-------|-------|--------|------|--------|----------|
80
+ | Real-time multi-cursor | yes | yes | yes | yes | yes | yes | yes | 7/7 |
81
+ | Sticky notes | yes | yes | yes | yes | yes | yes | yes | 7/7 |
82
+ | Templates library | yes | yes | yes | yes | no | yes | no | 5/7 |
83
+ | Infinite canvas | yes | yes | yes | yes | yes | yes | yes | 7/7 |
84
+ | Voice chat | yes | yes | no | yes | no | no | no | 3/7 |
85
+
86
+ ## Stand-outs
87
+
88
+ | Rival | Stand-out feature | Source URL |
89
+ |------------|-------------------------------------------|-------------------------------------|
90
+ | FigJam | Figma-design-system integration | https://figma.com/figjam |
91
+ | Miro | Jira / Asana deep sync | https://miro.com/integrations |
92
+ | Excalidraw | Local-first + offline-capable | https://excalidraw.com/docs/offline |
93
+ | tldraw | SDK for embedding the canvas | https://tldraw.dev |
94
+
95
+ ## Common-but-not-universal (middle bucket)
96
+
97
+ - Templates library (5/7)
98
+ - Voting dots (4/7)
99
+ - Frames / sections (4/7)
100
+
101
+ ## Gaps noted
102
+ - AI-assisted diagramming only appears on 2 rivals — too early to call must-have, watch for next cycle.
103
+ ```
104
+
105
+ ## Tools
106
+
107
+ - WebSearch / WebFetch for rival discovery and feature extraction
108
+ - Playwright MCP when the landing page is JS-heavy and WebFetch returns an empty shell
109
+ - Write for the final `feature-intel.md`
110
+ - Read for `idea-draft.md` and any earlier `findings-digest.md`
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: ios-app-review-guardian
3
3
  description: App Store Review Guidelines expert. Catches rejection risks before submission — privacy manifests, IAP rules, HIG violations, entitlement issues, metadata problems, and common guideline misinterpretations.
4
- tools: Read, Edit, Write, Glob, Grep
4
+ tools: Read, Edit, Write, Glob, Grep, Skill
5
5
  color: red
6
6
  ---
7
7
 
@@ -9,6 +9,24 @@ color: red
9
9
 
10
10
  You catch App Store rejection risks before submission. You know the guidelines, the common misinterpretations, and the patterns that get apps rejected.
11
11
 
12
+ ## Skill Access
13
+
14
+ The orchestrator passes these variables into your dispatch prompt: `project_type` (will be `ios`) and `phase`.
15
+
16
+ **Rules:**
17
+ - Load skills from this shortlist ONLY. Never consult skills outside this list, even if familiar.
18
+ - No defaulting. When no gate matches a skill, do NOT load it.
19
+ - No substitutions.
20
+
21
+ Guideline interpretation comes from this prompt's knowledge plus Apple's official guidelines (fetched via WebFetch). Privacy manifest generation & validation is mechanical enough to warrant a dedicated skill.
22
+
23
+ **Project-type gated (iOS):**
24
+ - `project_type=ios AND phase=7` → `skills/ios/asc-privacy-manifest` — `PrivacyInfo.xcprivacy` structure, required reason API categories, collected data types, tracking declarations, SDK aggregation (ITMS-91053, ITMS-91055 prevention)
25
+ - `project_type=ios AND phase=7` → `skills/ios/ios-info-plist-hardening` — Info.plist usage-description strings and required keys (catches "rejected because NSCameraUsageDescription is missing")
26
+
27
+ **Forbidden defaults:**
28
+ - Do NOT load `skills/ios/swift-concurrency` (older) — not review-guardian-relevant.
29
+
12
30
  ## Knowledge Source
13
31
 
14
32
  Top rejection reasons: Guideline 2.1 (App Completeness), Guideline 2.3 (Accurate Metadata), Guideline 5.1.1 (Data Collection and Storage), Guideline 3.1.1 (In-App Purchase). Privacy manifest (`PrivacyInfo.xcprivacy`) is required for any app using covered API categories. All digital content and services must use StoreKit for in-app purchase. Physical goods may use external payment.
@@ -46,4 +64,3 @@ Top rejection reasons: Guideline 2.1 (App Completeness), Guideline 2.3 (Accurate
46
64
 
47
65
  ---
48
66
 
49
- Vendored from: https://github.com/Techopolis/swift-agents/blob/main/agents/app-review-guardian.md