@kensaurus/skills 0.0.0-stage → 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 (425) hide show
  1. package/.claude-plugin/marketplace.json +53 -0
  2. package/.claude-plugin/plugin.json +40 -0
  3. package/.cursor-plugin/plugin.json +38 -0
  4. package/.mcp.json +28 -0
  5. package/CHANGELOG.md +1790 -0
  6. package/LICENSE +21 -0
  7. package/LICENSE-APACHE +62 -0
  8. package/NOTICE +13 -0
  9. package/README.md +821 -2
  10. package/SECURITY.md +55 -0
  11. package/agents/code-reviewer.md +60 -0
  12. package/agents/completion-judge.md +89 -0
  13. package/agents/db-migrator.md +125 -0
  14. package/agents/debugger.md +47 -0
  15. package/agents/deploy-checker.md +100 -0
  16. package/agents/perf-monitor.md +74 -0
  17. package/assets/favicon.png +0 -0
  18. package/assets/logo-light.png +0 -0
  19. package/assets/logo.png +0 -0
  20. package/assets/logo.svg +6 -0
  21. package/assets/og.png +0 -0
  22. package/bin/install.mjs +1127 -0
  23. package/bin/kenji.js +2 -0
  24. package/commands/adr.md +17 -0
  25. package/commands/aeo-plan.md +18 -0
  26. package/commands/arch-boundaries.md +17 -0
  27. package/commands/aso-plan.md +18 -0
  28. package/commands/auth-flows.md +19 -0
  29. package/commands/backup-plan.md +17 -0
  30. package/commands/burndown-full.md +25 -0
  31. package/commands/capacitor-plan.md +18 -0
  32. package/commands/codemod-safety.md +22 -0
  33. package/commands/commit.md +18 -0
  34. package/commands/complete-everything.md +40 -0
  35. package/commands/cost-plan.md +19 -0
  36. package/commands/deadcode-plan.md +26 -0
  37. package/commands/deadcode.md +32 -0
  38. package/commands/debug-issue.md +17 -0
  39. package/commands/deps-plan.md +18 -0
  40. package/commands/docs-plan.md +17 -0
  41. package/commands/doctrine.md +19 -0
  42. package/commands/error-plan.md +19 -0
  43. package/commands/feedback-to-closure.md +36 -0
  44. package/commands/fix-issue.md +76 -0
  45. package/commands/gate-logic.md +26 -0
  46. package/commands/green-repo.md +36 -0
  47. package/commands/grill-me.md +19 -0
  48. package/commands/gtm-plan.md +21 -0
  49. package/commands/gtm-weekly.md +17 -0
  50. package/commands/gtm.md +22 -0
  51. package/commands/handoff.md +15 -0
  52. package/commands/housekeep-backlog.md +18 -0
  53. package/commands/housekeep-files.md +22 -0
  54. package/commands/housekeep-gates.md +18 -0
  55. package/commands/instant-nav.md +11 -0
  56. package/commands/integrity-plan.md +19 -0
  57. package/commands/launch-kit.md +16 -0
  58. package/commands/mcp-guide.md +40 -0
  59. package/commands/mobile-plan.md +19 -0
  60. package/commands/native-rn-monorepo/README.md +78 -0
  61. package/commands/native-rn-monorepo/android-build.md +26 -0
  62. package/commands/native-rn-monorepo/android-install.md +32 -0
  63. package/commands/native-rn-monorepo/android-logcat.md +37 -0
  64. package/commands/native-rn-monorepo/ios-ci-logs.md +56 -0
  65. package/commands/native-rn-monorepo/ios-ci-status.md +52 -0
  66. package/commands/native-rn-monorepo/ios-ci-trigger.md +59 -0
  67. package/commands/native-rn-monorepo/rn-reset.md +50 -0
  68. package/commands/native-rn-monorepo/rn-ship-ios.md +67 -0
  69. package/commands/native-rn-monorepo/rn-verify.md +53 -0
  70. package/commands/perf-plan.md +18 -0
  71. package/commands/plan-mode.md +74 -0
  72. package/commands/pr.md +16 -0
  73. package/commands/pricing-plan.md +20 -0
  74. package/commands/privacy-plan.md +18 -0
  75. package/commands/readability.md +12 -0
  76. package/commands/readme.md +15 -0
  77. package/commands/refactor.md +15 -0
  78. package/commands/release-prep.md +17 -0
  79. package/commands/research.md +25 -0
  80. package/commands/responsive-audit.md +21 -0
  81. package/commands/review-code.md +18 -0
  82. package/commands/rls-plan.md +18 -0
  83. package/commands/secrets-plan.md +18 -0
  84. package/commands/security-plan.md +19 -0
  85. package/commands/ship-and-observe.md +36 -0
  86. package/commands/skill-conflicts.md +19 -0
  87. package/commands/slop-plan.md +18 -0
  88. package/commands/stub-plan.md +18 -0
  89. package/commands/test-mutation.md +16 -0
  90. package/commands/test-plan.md +17 -0
  91. package/commands/test.md +29 -0
  92. package/commands/thirdparty-web-interface-guidelines.md +185 -0
  93. package/commands/uiux-plan.md +18 -0
  94. package/commands/uiux.md +45 -0
  95. package/commands/update-deps.md +21 -0
  96. package/commands/validation-plan.md +19 -0
  97. package/commands-portable/fix-issue.md +72 -0
  98. package/commands-portable/plan-mode.md +92 -0
  99. package/commands-portable/research.md +91 -0
  100. package/docs/screenshots/README.md +5 -0
  101. package/docs/screenshots/audit-dark.png +0 -0
  102. package/docs/screenshots/build-dark.png +0 -0
  103. package/docs/screenshots/grill-dark.png +0 -0
  104. package/docs/screenshots/hero-dark.png +0 -0
  105. package/docs/screenshots/hero-light.png +0 -0
  106. package/docs/screenshots/ship-dark.png +0 -0
  107. package/docs/screenshots/src/showcase.html +320 -0
  108. package/hooks/completion-gate.mjs +258 -0
  109. package/hooks/cursor-hooks.json +13 -0
  110. package/hooks/hooks.json +15 -0
  111. package/install.sh +21 -0
  112. package/llms.txt +40 -0
  113. package/mcp/README.md +266 -0
  114. package/mcp/VERSIONS.md +41 -0
  115. package/mcp/mcp-full.json.template +124 -0
  116. package/mcp/mcp.json.template +29 -0
  117. package/mcp/pinned-versions.json +27 -0
  118. package/package.json +94 -4
  119. package/rules/approved-plan-execution.mdc +65 -0
  120. package/rules/full-stack-ship-discipline.mdc +37 -0
  121. package/rules/native-rn-monorepo/README.md +63 -0
  122. package/rules/native-rn-monorepo/_project.mdc +69 -0
  123. package/rules/native-rn-monorepo/native-android.mdc +72 -0
  124. package/rules/native-rn-monorepo/native-ios.mdc +61 -0
  125. package/rules/native-rn-monorepo/react-native-js.mdc +78 -0
  126. package/rules/native-rn-monorepo/web.mdc +60 -0
  127. package/rules/project-starter/components.mdc +54 -0
  128. package/rules/project-starter/data-fetching.mdc +77 -0
  129. package/rules/project-starter/git.mdc +41 -0
  130. package/rules/project-starter/supabase.mdc +37 -0
  131. package/rules/project-starter/tailwind.mdc +48 -0
  132. package/rules/project-starter/typescript.mdc +36 -0
  133. package/rules/project-starter/web-performance.mdc +42 -0
  134. package/rules/senior-engineer.mdc +30 -0
  135. package/rules/shell-first-search.mdc +19 -0
  136. package/rules/skill-workflows.mdc +35 -0
  137. package/rules/verification-before-completion.mdc +57 -0
  138. package/skills/audit-accessibility/SKILL.md +441 -0
  139. package/skills/audit-agent-speed/SKILL.md +181 -0
  140. package/skills/audit-agent-speed/scripts/stop-typecheck.mjs +151 -0
  141. package/skills/audit-analytics/SKILL.md +138 -0
  142. package/skills/audit-auth-flows/SKILL.md +267 -0
  143. package/skills/audit-backend-architecture/SKILL.md +266 -0
  144. package/skills/audit-backend-architecture/references/patterns.md +386 -0
  145. package/skills/audit-bundle-size/SKILL.md +295 -0
  146. package/skills/audit-cicd/SKILL.md +218 -0
  147. package/skills/audit-code-quality/SKILL.md +314 -0
  148. package/skills/audit-code-review/SKILL.md +289 -0
  149. package/skills/audit-codemod-safety/SKILL.md +159 -0
  150. package/skills/audit-db-schema/SKILL.md +465 -0
  151. package/skills/audit-db-schema/references/details.md +110 -0
  152. package/skills/audit-doctrine/SKILL.md +189 -0
  153. package/skills/audit-env-parity/SKILL.md +133 -0
  154. package/skills/audit-fe-api/SKILL.md +458 -0
  155. package/skills/audit-gate-logic/SKILL.md +219 -0
  156. package/skills/audit-i18n/SKILL.md +339 -0
  157. package/skills/audit-infra-cost/SKILL.md +142 -0
  158. package/skills/audit-langfuse-llm/SKILL.md +468 -0
  159. package/skills/audit-langfuse-llm/references/details.md +226 -0
  160. package/skills/audit-llm-security/SKILL.md +147 -0
  161. package/skills/audit-monetization-iap/SKILL.md +137 -0
  162. package/skills/audit-payment-system/SKILL.md +268 -0
  163. package/skills/audit-payment-system/references/checklist.md +283 -0
  164. package/skills/audit-performance/SKILL.md +383 -0
  165. package/skills/audit-performance/references/loading-priority-2026.md +81 -0
  166. package/skills/audit-realworld/SKILL.md +287 -0
  167. package/skills/audit-registry-listing/SKILL.md +122 -0
  168. package/skills/audit-resilience/SKILL.md +153 -0
  169. package/skills/audit-responsive/SKILL.md +221 -0
  170. package/skills/audit-responsive/references/checklist.md +166 -0
  171. package/skills/audit-security/SKILL.md +289 -0
  172. package/skills/audit-skill-conflicts/SKILL.md +178 -0
  173. package/skills/audit-ui-states/SKILL.md +146 -0
  174. package/skills/audit-uiux-design-system/SKILL.md +475 -0
  175. package/skills/audit-uiux-design-system/references/details.md +71 -0
  176. package/skills/audit-ux/SKILL.md +381 -0
  177. package/skills/audit-ux/references/details.md +245 -0
  178. package/skills/audit-ux-journeys/SKILL.md +215 -0
  179. package/skills/audit-ux-journeys/references/checklist.md +179 -0
  180. package/skills/backend-db-performance/SKILL.md +441 -0
  181. package/skills/backend-error-handling/SKILL.md +489 -0
  182. package/skills/backend-error-handling/references/details.md +58 -0
  183. package/skills/backend-observability/SKILL.md +88 -0
  184. package/skills/backend-patterns/SKILL.md +499 -0
  185. package/skills/backend-patterns/references/architecture-patterns.md +298 -0
  186. package/skills/backend-realtime/SKILL.md +403 -0
  187. package/skills/backend-realtime/references/patterns.md +74 -0
  188. package/skills/burndown-full/SKILL.md +174 -0
  189. package/skills/complete-everything/SKILL.md +295 -0
  190. package/skills/data-pipeline/SKILL.md +109 -0
  191. package/skills/data-visualization/SKILL.md +488 -0
  192. package/skills/debug-error/SKILL.md +322 -0
  193. package/skills/debug-fe-be-integration/SKILL.md +459 -0
  194. package/skills/debug-sentry-monitor/SKILL.md +497 -0
  195. package/skills/debug-sentry-monitor/references/details.md +165 -0
  196. package/skills/deploy-npm/SKILL.md +394 -0
  197. package/skills/deploy-npm/references/example-mushi-mushi.md +52 -0
  198. package/skills/deploy-verify/SKILL.md +489 -0
  199. package/skills/design-api/SKILL.md +379 -0
  200. package/skills/design-canvas/SKILL.md +155 -0
  201. package/skills/design-email/SKILL.md +370 -0
  202. package/skills/design-frontend/SKILL.md +143 -0
  203. package/skills/design-generative-art/SKILL.md +474 -0
  204. package/skills/design-mobile-first/SKILL.md +506 -0
  205. package/skills/design-motion/SKILL.md +333 -0
  206. package/skills/design-motion/references/delight-interactions.md +191 -0
  207. package/skills/design-prd/SKILL.md +443 -0
  208. package/skills/design-system/SKILL.md +457 -0
  209. package/skills/design-theme/SKILL.md +226 -0
  210. package/skills/design-theme/themes/tsumagoi-ranch.md +150 -0
  211. package/skills/docs-adr/SKILL.md +168 -0
  212. package/skills/docs-coauthor/SKILL.md +368 -0
  213. package/skills/docs-comparison-pages/SKILL.md +117 -0
  214. package/skills/docs-domain-modeling/SKILL.md +97 -0
  215. package/skills/docs-launch-kit/SKILL.md +139 -0
  216. package/skills/docs-writer/SKILL.md +469 -0
  217. package/skills/enhance-agent-guardrails/SKILL.md +164 -0
  218. package/skills/enhance-arch-boundaries/SKILL.md +154 -0
  219. package/skills/enhance-capacitor-ui/SKILL.md +463 -0
  220. package/skills/enhance-capacitor-ui/references/details.md +750 -0
  221. package/skills/enhance-email-deliverability/SKILL.md +143 -0
  222. package/skills/enhance-growth-loops/SKILL.md +122 -0
  223. package/skills/enhance-lifecycle-email/SKILL.md +130 -0
  224. package/skills/enhance-motion/SKILL.md +193 -0
  225. package/skills/enhance-onboarding/SKILL.md +148 -0
  226. package/skills/enhance-pwa/SKILL.md +303 -0
  227. package/skills/enhance-readability/SKILL.md +146 -0
  228. package/skills/enhance-readme/SKILL.md +496 -0
  229. package/skills/enhance-readme/package-lock.json +187 -0
  230. package/skills/enhance-readme/package.json +17 -0
  231. package/skills/enhance-readme/scripts/generate-readme-blocks.mjs +199 -0
  232. package/skills/enhance-readme/scripts/record-readme-tour.mjs +442 -0
  233. package/skills/enhance-skill-prompts/SKILL.md +167 -0
  234. package/skills/enhance-skill-prompts/references/exemplar-audit-auth-flows.md +311 -0
  235. package/skills/enhance-ux-laws/SKILL.md +409 -0
  236. package/skills/enhance-web-conversion/SKILL.md +155 -0
  237. package/skills/enhance-web-forms/SKILL.md +154 -0
  238. package/skills/enhance-web-instant-nav/SKILL.md +138 -0
  239. package/skills/enhance-web-instant-nav/references/bfcache-blockers.md +23 -0
  240. package/skills/enhance-web-instant-nav/references/early-hints.md +33 -0
  241. package/skills/enhance-web-instant-nav/references/speculation-rules.md +44 -0
  242. package/skills/enhance-web-landing/SKILL.md +459 -0
  243. package/skills/enhance-web-landing/references/details.md +773 -0
  244. package/skills/enhance-web-redesign/SKILL.md +228 -0
  245. package/skills/enhance-web-seo/SKILL.md +276 -0
  246. package/skills/enhance-web-ui/SKILL.md +473 -0
  247. package/skills/enhance-web-ui/references/details.md +674 -0
  248. package/skills/enhance-web-ux/HEURISTICS.md +248 -0
  249. package/skills/enhance-web-ux/PATTERNS.md +375 -0
  250. package/skills/enhance-web-ux/SKILL.md +464 -0
  251. package/skills/enhance-web-ux/examples.md +222 -0
  252. package/skills/enhance-web-ux/references/details.md +406 -0
  253. package/skills/enhance-web-web3d/SKILL.md +397 -0
  254. package/skills/enhance-web-web3d/references/css-canvas-effects.md +180 -0
  255. package/skills/handoff/SKILL.md +66 -0
  256. package/skills/housekeep-backlog/SKILL.md +149 -0
  257. package/skills/housekeep-dead-code/SKILL.md +387 -0
  258. package/skills/housekeep-dead-code/references/ratchet-ci.md +205 -0
  259. package/skills/housekeep-dead-code/references/supabase-hygiene.md +152 -0
  260. package/skills/housekeep-design/SKILL.md +207 -0
  261. package/skills/housekeep-files/SKILL.md +220 -0
  262. package/skills/housekeep-files/references/naming-and-catalog.md +86 -0
  263. package/skills/housekeep-files/scripts/housekeep-files.ps1 +360 -0
  264. package/skills/housekeep-files/scripts/housekeep-files.sh +238 -0
  265. package/skills/housekeep-gates/SKILL.md +174 -0
  266. package/skills/iterate-agent-harness/SKILL.md +137 -0
  267. package/skills/iterate-gtm-weekly/SKILL.md +103 -0
  268. package/skills/iterate-post-launch/SKILL.md +292 -0
  269. package/skills/meta-mcp-builder/SKILL.md +313 -0
  270. package/skills/meta-skill-creator/SKILL.md +304 -0
  271. package/skills/mobile-capacitor-platform/SKILL.md +103 -0
  272. package/skills/mobile-emulator-start/SKILL.md +296 -0
  273. package/skills/mobile-emulator-test/SKILL.md +491 -0
  274. package/skills/mobile-emulator-test/references/details.md +478 -0
  275. package/skills/mobile-rn-performance/SKILL.md +107 -0
  276. package/skills/mobile-rn-screen/SKILL.md +476 -0
  277. package/skills/mobile-rn-screen/references/details.md +785 -0
  278. package/skills/mushi-health/SKILL.md +206 -0
  279. package/skills/mushi-integration/SKILL.md +257 -0
  280. package/skills/plan-aeo-readiness/SKILL.md +166 -0
  281. package/skills/plan-antislop/SKILL.md +281 -0
  282. package/skills/plan-aso/SKILL.md +149 -0
  283. package/skills/plan-backup-dr/SKILL.md +131 -0
  284. package/skills/plan-capacitor-hardening/SKILL.md +217 -0
  285. package/skills/plan-data-integrity/SKILL.md +187 -0
  286. package/skills/plan-dead-code/SKILL.md +386 -0
  287. package/skills/plan-dead-code/references/knip-config.md +214 -0
  288. package/skills/plan-dead-code/references/output-templates.md +133 -0
  289. package/skills/plan-dead-code/references/preservation-contract.md +50 -0
  290. package/skills/plan-dead-code/references/residue-greps.md +84 -0
  291. package/skills/plan-dependency-provenance/SKILL.md +200 -0
  292. package/skills/plan-docs-sync/SKILL.md +143 -0
  293. package/skills/plan-docs-sync/references/drift-taxonomy.md +43 -0
  294. package/skills/plan-docs-sync/references/output-templates.md +33 -0
  295. package/skills/plan-docs-sync/references/preservation-contract.md +17 -0
  296. package/skills/plan-error-handling/SKILL.md +205 -0
  297. package/skills/plan-gtm/SKILL.md +276 -0
  298. package/skills/plan-gtm/references/benchmarks-2026.md +183 -0
  299. package/skills/plan-input-validation/SKILL.md +179 -0
  300. package/skills/plan-llm-cost-guardrails/SKILL.md +176 -0
  301. package/skills/plan-mobile-readiness/SKILL.md +171 -0
  302. package/skills/plan-perf-audit/SKILL.md +145 -0
  303. package/skills/plan-perf-audit/references/audit-scope.md +51 -0
  304. package/skills/plan-perf-audit/references/output-templates.md +33 -0
  305. package/skills/plan-perf-audit/references/preservation-contract.md +13 -0
  306. package/skills/plan-pricing/SKILL.md +173 -0
  307. package/skills/plan-privacy-compliance/SKILL.md +148 -0
  308. package/skills/plan-rls-audit/SKILL.md +231 -0
  309. package/skills/plan-secrets-audit/SKILL.md +181 -0
  310. package/skills/plan-security-audit/SKILL.md +168 -0
  311. package/skills/plan-security-audit/references/output-templates.md +36 -0
  312. package/skills/plan-security-audit/references/owasp-supabase-scope.md +55 -0
  313. package/skills/plan-security-audit/references/preservation-contract.md +18 -0
  314. package/skills/plan-stub-checker/SKILL.md +216 -0
  315. package/skills/plan-stub-checker/references/detection-methodology.md +75 -0
  316. package/skills/plan-stub-checker/references/detection-taxonomy.md +34 -0
  317. package/skills/plan-stub-checker/references/output-templates.md +63 -0
  318. package/skills/plan-stub-checker/references/preservation-contract.md +24 -0
  319. package/skills/plan-test-coverage/SKILL.md +170 -0
  320. package/skills/plan-test-coverage/references/methodology.md +54 -0
  321. package/skills/plan-test-coverage/references/output-templates.md +34 -0
  322. package/skills/plan-test-coverage/references/preservation-contract.md +15 -0
  323. package/skills/plan-uiux-unification/SKILL.md +230 -0
  324. package/skills/plan-uiux-unification/references/output-templates.md +67 -0
  325. package/skills/plan-uiux-unification/references/phase-workbook.md +85 -0
  326. package/skills/plan-uiux-unification/references/preservation-contract.md +24 -0
  327. package/skills/protocol-browser-anti-stall/SKILL.md +211 -0
  328. package/skills/protocol-browser-anti-stall/references/mcp-to-cli-map.md +113 -0
  329. package/skills/protocol-browser-anti-stall/references/playwright-session-coordination.md +170 -0
  330. package/skills/research/SKILL.md +422 -0
  331. package/skills/test-exploratory/SKILL.md +165 -0
  332. package/skills/test-exploratory/references/charter-template.md +29 -0
  333. package/skills/test-load/SKILL.md +126 -0
  334. package/skills/test-mutation/SKILL.md +160 -0
  335. package/skills/test-playwright/SKILL.md +354 -0
  336. package/skills/test-qa/SKILL.md +364 -0
  337. package/skills/test-qa/references/details.md +268 -0
  338. package/skills/test-red-team/SKILL.md +386 -0
  339. package/skills/test-red-team/references/owasp-attack-checklist.md +193 -0
  340. package/skills/test-unit/SKILL.md +259 -0
  341. package/skills/test-unit/references/details.md +267 -0
  342. package/skills/test-visual-regression/SKILL.md +132 -0
  343. package/skills/thirdparty-emil-design-eng/ATTRIBUTION.md +20 -0
  344. package/skills/thirdparty-emil-design-eng/SKILL.md +21 -0
  345. package/skills/thirdparty-emil-design-eng/references/emil-design-eng.md +676 -0
  346. package/skills/thirdparty-ui-ux-pro-max/ATTRIBUTION.md +22 -0
  347. package/skills/thirdparty-ui-ux-pro-max/SKILL.md +304 -0
  348. package/skills/thirdparty-ui-ux-pro-max/data/charts.csv +26 -0
  349. package/skills/thirdparty-ui-ux-pro-max/data/colors.csv +97 -0
  350. package/skills/thirdparty-ui-ux-pro-max/data/icons.csv +101 -0
  351. package/skills/thirdparty-ui-ux-pro-max/data/landing.csv +31 -0
  352. package/skills/thirdparty-ui-ux-pro-max/data/products.csv +97 -0
  353. package/skills/thirdparty-ui-ux-pro-max/data/react-performance.csv +45 -0
  354. package/skills/thirdparty-ui-ux-pro-max/data/stacks/astro.csv +54 -0
  355. package/skills/thirdparty-ui-ux-pro-max/data/stacks/flutter.csv +53 -0
  356. package/skills/thirdparty-ui-ux-pro-max/data/stacks/html-tailwind.csv +56 -0
  357. package/skills/thirdparty-ui-ux-pro-max/data/stacks/jetpack-compose.csv +53 -0
  358. package/skills/thirdparty-ui-ux-pro-max/data/stacks/nextjs.csv +53 -0
  359. package/skills/thirdparty-ui-ux-pro-max/data/stacks/nuxt-ui.csv +51 -0
  360. package/skills/thirdparty-ui-ux-pro-max/data/stacks/nuxtjs.csv +59 -0
  361. package/skills/thirdparty-ui-ux-pro-max/data/stacks/react-native.csv +52 -0
  362. package/skills/thirdparty-ui-ux-pro-max/data/stacks/react.csv +54 -0
  363. package/skills/thirdparty-ui-ux-pro-max/data/stacks/shadcn.csv +61 -0
  364. package/skills/thirdparty-ui-ux-pro-max/data/stacks/svelte.csv +54 -0
  365. package/skills/thirdparty-ui-ux-pro-max/data/stacks/swiftui.csv +51 -0
  366. package/skills/thirdparty-ui-ux-pro-max/data/stacks/vue.csv +50 -0
  367. package/skills/thirdparty-ui-ux-pro-max/data/styles.csv +68 -0
  368. package/skills/thirdparty-ui-ux-pro-max/data/typography.csv +58 -0
  369. package/skills/thirdparty-ui-ux-pro-max/data/ui-reasoning.csv +101 -0
  370. package/skills/thirdparty-ui-ux-pro-max/data/ux-guidelines.csv +100 -0
  371. package/skills/thirdparty-ui-ux-pro-max/data/web-interface.csv +31 -0
  372. package/skills/thirdparty-ui-ux-pro-max/scripts/core.py +253 -0
  373. package/skills/thirdparty-ui-ux-pro-max/scripts/design_system.py +1067 -0
  374. package/skills/thirdparty-ui-ux-pro-max/scripts/search.py +114 -0
  375. package/skills/thirdparty-web-interface-guidelines/ATTRIBUTION.md +23 -0
  376. package/skills/thirdparty-web-interface-guidelines/SKILL.md +190 -0
  377. package/skills/workflow-build-feature/SKILL.md +118 -0
  378. package/skills/workflow-coding-discipline/SKILL.md +140 -0
  379. package/skills/workflow-environment-ready/SKILL.md +128 -0
  380. package/skills/workflow-feature-flag/SKILL.md +262 -0
  381. package/skills/workflow-feedback-to-closure/SKILL.md +165 -0
  382. package/skills/workflow-fix-and-ship/SKILL.md +136 -0
  383. package/skills/workflow-git-commit/SKILL.md +200 -0
  384. package/skills/workflow-green-repo/SKILL.md +166 -0
  385. package/skills/workflow-grilling/SKILL.md +73 -0
  386. package/skills/workflow-gtm/SKILL.md +153 -0
  387. package/skills/workflow-housekeep/SKILL.md +453 -0
  388. package/skills/workflow-housekeep/references/templates.md +109 -0
  389. package/skills/workflow-launch-ready/SKILL.md +145 -0
  390. package/skills/workflow-merge-conflicts/SKILL.md +62 -0
  391. package/skills/workflow-onboard/SKILL.md +99 -0
  392. package/skills/workflow-parallel-agents/SKILL.md +164 -0
  393. package/skills/workflow-pr/SKILL.md +197 -0
  394. package/skills/workflow-quality-gate/SKILL.md +147 -0
  395. package/skills/workflow-refactor/SKILL.md +274 -0
  396. package/skills/workflow-release-prep/SKILL.md +207 -0
  397. package/skills/workflow-ship-and-observe/SKILL.md +164 -0
  398. package/skills/workflow-spec-tdd/SKILL.md +141 -0
  399. package/skills/workflow-spec-tdd/references/spec-template.md +126 -0
  400. package/skills/workflow-spec-tdd/references/tdd-patterns.md +167 -0
  401. package/skills-cursor/babysit/SKILL.md +17 -0
  402. package/skills-cursor/canvas/SKILL.md +142 -0
  403. package/skills-cursor/canvas/sdk/canvas-tokens.d.ts +235 -0
  404. package/skills-cursor/canvas/sdk/chart-primitives.d.ts +200 -0
  405. package/skills-cursor/canvas/sdk/dag-layout.d.ts +102 -0
  406. package/skills-cursor/canvas/sdk/diff-view.d.ts +130 -0
  407. package/skills-cursor/canvas/sdk/form-primitives.d.ts +194 -0
  408. package/skills-cursor/canvas/sdk/hooks.d.ts +117 -0
  409. package/skills-cursor/canvas/sdk/index.d.ts +47 -0
  410. package/skills-cursor/canvas/sdk/theme.d.ts +61 -0
  411. package/skills-cursor/canvas/sdk/todo-list.d.ts +49 -0
  412. package/skills-cursor/canvas/sdk/ui-primitives.d.ts +549 -0
  413. package/skills-cursor/canvas/sdk/ui-primitives.test.d.ts +2 -0
  414. package/skills-cursor/create-hook/SKILL.md +238 -0
  415. package/skills-cursor/create-rule/SKILL.md +185 -0
  416. package/skills-cursor/create-skill/SKILL.md +269 -0
  417. package/skills-cursor/create-skill/references/authoring-guide.md +182 -0
  418. package/skills-cursor/create-subagent/SKILL.md +228 -0
  419. package/skills-cursor/migrate-to-skills/SKILL.md +121 -0
  420. package/skills-cursor/shell/SKILL.md +22 -0
  421. package/skills-cursor/split-to-prs/SKILL.md +47 -0
  422. package/skills-cursor/statusline/SKILL.md +193 -0
  423. package/skills-cursor/update-cli-config/SKILL.md +85 -0
  424. package/skills-cursor/update-cursor-settings/SKILL.md +137 -0
  425. package/skills.sh.json +297 -0
@@ -0,0 +1,168 @@
1
+ ---
2
+ name: plan-security-audit
3
+ description: >
4
+ Plan-only OWASP Top 10 and Supabase-first hardening burndown. Use when
5
+ "security audit plan", "OWASP audit", "hardening plan", or "security
6
+ burndown". Auth flows → audit-auth-flows. RLS → plan-rls-audit. Keys →
7
+ plan-secrets-audit.
8
+ license: MIT
9
+ effort: high
10
+ ---
11
+
12
+ # Security Audit + Hardening Plan
13
+
14
+ **Degree of freedom: MIXED** — OWASP mapping and severity are judgment; RLS
15
+ enumeration, secret scan, and `npm audit` run exactly. Stay **plan-only**.
16
+ No patches or destructive testing.
17
+
18
+ **Role:** Senior application security engineer.
19
+
20
+ **Task:** Exhaustive vulnerability audit (frontend, backend, auth, Supabase, deps, secrets),
21
+ mapped to OWASP Top 10, then remediation plan. **Audit & plan only — no code changes, no
22
+ destructive testing.**
23
+
24
+ ## This skill vs neighbors
25
+
26
+ | Skill | Does |
27
+ |-------|------|
28
+ | **plan-security-audit** (this) | Plan with OWASP + Supabase-first burndown |
29
+ | `audit-security` | Static security review (may fix) |
30
+ | `test-red-team` | Adversarial runtime testing |
31
+ | `audit-db-schema` | Schema health including RLS review |
32
+
33
+ **Loop:** see `docs/PLAN-LOOPS.md` — after `plan-test-coverage`, parallel with `plan-perf-audit`, before `plan-docs-sync`
34
+
35
+ ## How to reason (every plan item)
36
+
37
+ 1. **Propose** — RLS, secret rotation, auth enforcement, dep bump, or header/CSP
38
+ 2. **Risk** — data exposure, auth bypass, or a leaked key that bypasses RLS
39
+ 3. **Keep-working** — controls that already enforce server-side
40
+ 4. **Phase** — Critical → High → Med-Low (do not execute)
41
+
42
+ ## Worked example
43
+
44
+ > **Propose:** enable RLS on `public.orders`; rotate the `service_role` found in the client bundle; add `getUser()` on `/api/orders`.
45
+ > **Risk:** anon key + RLS-off = full table dump; `service_role` in the bundle bypasses every policy.
46
+ > **Keep-working:** `/dashboard` layout already calls `getUser()` on the server.
47
+ > **Phase:** Critical — RLS + secret rotation first.
48
+ > **Report:** `lib/supabase.ts:12` service_role (type only — never the value). Table RLS detail → `plan-rls-audit`.
49
+
50
+ ---
51
+
52
+ ## ⛔ Preservation Contract
53
+
54
+ Read `references/preservation-contract.md`. Acknowledge in output #1.
55
+
56
+ **Safety guardrails:**
57
+
58
+ - No destructive/live exploit testing
59
+ - Never paste found secret values — location + type, flag for rotation
60
+
61
+ ---
62
+
63
+ ## References
64
+
65
+ | File | Contents |
66
+ |------|----------|
67
+ | `references/owasp-supabase-scope.md` | OWASP map, RLS-first methodology, scans |
68
+ | `references/output-templates.md` | Burndown, phased hardening, secrets list |
69
+
70
+ ---
71
+
72
+ ## Phase flow
73
+
74
+ ```
75
+ 1. Stack fingerprint
76
+ 2. RLS-first pass (Supabase MCP if available)
77
+ 3. Bundle/secret scan (no value echo)
78
+ 4. Auth-path trace
79
+ 5. Dependency CVE scan
80
+ 6. OWASP remainder (injection, headers, misconfig)
81
+ 7. Burndown + phased hardening plan
82
+ 8. Guardrails + research citations
83
+ ```
84
+
85
+ Sentry MCP: security-related production errors. Firecrawl: current OWASP + Supabase patterns.
86
+
87
+ Delegate a scan pass to a subagent only when it is sizeable, independent of the others, and its raw output (audit dumps, grep results) has no place in the plan; brief it with the exact commands and the columns to return, and it inherits this pass's rules — it edits nothing and never pastes a secret value. Long sweeps are expected — context compaction exists, so finish the inventory rather than wrapping up early.
88
+
89
+ ---
90
+
91
+ ## Phase 2 — RLS-first (Supabase) [LOW freedom — run exactly]
92
+
93
+ Enumerate every `public` table:
94
+
95
+ - RLS enabled?
96
+ - Policies scope rows correctly?
97
+ - `WITH CHECK` on writes?
98
+ - Realtime respects SELECT policies?
99
+
100
+ **#1 critical class:** table without RLS + anon key in client = full data exposure.
101
+
102
+ Detail: `references/owasp-supabase-scope.md`
103
+
104
+ ---
105
+
106
+ ## Phase 3 — Bundle/secret scan [LOW freedom — run exactly]
107
+
108
+ Inspect client bundle + source for:
109
+
110
+ - `service_role` key (Critical — full RLS bypass)
111
+ - Hardcoded API keys, DSNs
112
+ - `.env` committed / not gitignored
113
+ - Secrets in git history → **rotate** (history is forever)
114
+
115
+ Report: `file:line` + type only — **never the value**.
116
+
117
+ ---
118
+
119
+ ## Phase 4–6 — Auth, deps, OWASP [HIGH freedom]
120
+
121
+ - Every protected route/endpoint → server-side enforcement?
122
+ - `npm audit`, lockfile versions vs CVE databases — every CVE ID cited comes from scan output or an advisory lookup, never from memory
123
+ - XSS, SQLi, SSRF, headers/CSP, rate limits
124
+
125
+ Map each finding to OWASP category.
126
+
127
+ ---
128
+
129
+ ## Burndown + hardening plan [HIGH freedom — plan only]
130
+
131
+ Template: `references/output-templates.md`
132
+
133
+ Phases: Critical → High → Med/Low. Each remediation + "what must keep working".
134
+
135
+ Re-scan proposed after fixes (second pass).
136
+
137
+ ## Self-critique before the burndown [LOW freedom — do not skip]
138
+
139
+ 1. **evidenced-not-assumed** — every finding cites file:line or scan output; unconfirmed → `[NEEDS VERIFICATION]`
140
+ 2. **plan-only** — no patches, no live/destructive exploit testing
141
+ 3. **severity/phase justified** — RLS-off + anon key and client `service_role` are Critical
142
+ 4. **right-owner** — table-by-table RLS → `plan-rls-audit`; key rotation → `plan-secrets-audit`; app-layer auth flows → `audit-auth-flows`; LLM attacks → `audit-llm-security`
143
+ 5. **no-false-safety** — never paste secret values; never fabricate CVEs; confirmed vuln ≠ hardening suggestion
144
+
145
+ ---
146
+
147
+ ## Required output (in order)
148
+
149
+ 1. Preservation-contract acknowledgment
150
+ 2. Stack fingerprint + scope
151
+ 3. Per-area finding inventory
152
+ 4. Burndown table (OWASP + evidence + severity)
153
+ 5. Hardening + enhancement plan, phased
154
+ 6. Guardrails/tooling (SCA CI, secrets manager, RLS tests)
155
+ 7. Research notes + citations
156
+ 8. Open questions / `[NEEDS VERIFICATION]` + secrets-to-rotate (locations only)
157
+
158
+ End the turn with a standalone recap in chat: the two or three highest-impact confirmed findings (locations only for secrets) and the first phase to approve. The plan is the deliverable — write it before the recap.
159
+
160
+ ---
161
+
162
+ ## Rules
163
+
164
+ - Plan only — no patches, no live/destructive testing.
165
+ - Every finding cites real evidence. Unconfirmed → `[NEEDS VERIFICATION]`.
166
+ - Never paste secret values.
167
+ - Never fabricate CVEs or exploits.
168
+ - Separate confirmed vulnerability vs hardening recommendation.
@@ -0,0 +1,36 @@
1
+ # Output Templates
2
+
3
+ ## Stack fingerprint
4
+
5
+ ```markdown
6
+ - DB: Supabase / Postgres / other
7
+ - Auth: …
8
+ - Hosting: …
9
+ - Client: web / RN / both
10
+ ```
11
+
12
+ ## Finding inventory checklist
13
+
14
+ | Area | RLS | Secrets | Auth | Injection | Deps | Headers | Audited |
15
+
16
+ ## Burndown
17
+
18
+ | Area | Finding | OWASP | Evidence (path:line/config/dep@ver) | Severity | Effort | Risk-of-fix | Remediation |
19
+
20
+ Severity: Critical / High / Med / Low
21
+ Critical = RLS-off, service_role exposed, auth bypass, data exposure
22
+
23
+ Quantify: e.g. "3 tables without RLS, 1 service_role in bundle, 5 high CVE deps"
24
+
25
+ ## Phased hardening plan
26
+
27
+ 1. **Critical** — RLS-off, exposed secrets, auth bypass
28
+ 2. **High** — injection, broken access control, CVE deps
29
+ 3. **Med/Low** — headers, logging, hardening
30
+
31
+ Per finding: remediation + "what must keep working"
32
+
33
+ ## Secrets-to-rotate list (locations only — never values)
34
+
35
+ | Location | Type | Notes |
36
+ |----------|------|-------|
@@ -0,0 +1,55 @@
1
+ # OWASP Scope & Supabase-First Methodology
2
+
3
+ ## OWASP Top 10 mapping
4
+
5
+ | Area | Checks |
6
+ |------|--------|
7
+ | A01 Access control | Missing auth, IDOR, client-only checks, admin routes, least privilege |
8
+ | A02 Crypto / exposure | TLS, PII in logs/Sentry, sensitive client storage |
9
+ | A03 Injection | SQLi, XSS/`dangerouslySetInnerHTML`, command injection |
10
+ | A05 Misconfiguration | Headers, CSP, SRI, SSRF, open redirects |
11
+ | A06 Vulnerable deps | CVEs, transitive, `npm audit`, SBOM |
12
+ | A07 Auth/session | Session handling, rate limits on login/reset, token storage, MFA |
13
+
14
+ ## Supabase-specific (front-loaded — highest yield)
15
+
16
+ Research pattern: majority of incidents = **tables without RLS** (anon key → full read/write/delete).
17
+
18
+ | Finding class | Check |
19
+ |---------------|-------|
20
+ | **No RLS** | Every `public` table — RLS enabled? |
21
+ | **service_role in client** | Bundle/source scan — full RLS bypass = Critical |
22
+ | **Permissive RLS** | Missing `WITH CHECK`, policies don't scope rows |
23
+ | **RPC auth** | Functions callable without auth |
24
+ | **Realtime** | Rows beyond SELECT policy |
25
+ | **Key usage** | anon vs authenticated; service_role server-side only |
26
+
27
+ Use Supabase MCP when available: `list_tables`, policies, `get_advisors`, security advisors.
28
+
29
+ ## Methodology (order)
30
+
31
+ 1. **Fingerprint stack** — DB, auth, hosting, integrations
32
+ 2. **RLS-first pass** — enumerate public tables + policies
33
+ 3. **Bundle/secret scan** — client bundle + source for keys, service_role
34
+ 4. **Auth-path trace** — protected routes/endpoints → server-side enforcement?
35
+ 5. **Dependency scan** — versions vs CVEs, transitive
36
+ 6. **Map finding → OWASP category**
37
+
38
+ ## Secret scan patterns
39
+
40
+ ```
41
+ Grep: "service_role|SUPABASE_SERVICE|sk_live|sk_test|api_key" glob "*.{ts,tsx,js,env*}" -i
42
+ Grep: "dangerouslySetInnerHTML" glob "*.{tsx,jsx}"
43
+ Grep: "eval\\(|new Function" glob "*.{ts,js}"
44
+ ```
45
+
46
+ **Never echo matched secret values in output.**
47
+
48
+ ## Guardrails (research-backed)
49
+
50
+ - RLS on every public table; test with non-owner user
51
+ - `WITH CHECK` on writes; service_role server-side only
52
+ - Secrets manager; rotate any ever-committed key
53
+ - SCA in CI (Dependabot/Renovate, `npm audit`), SBOM
54
+ - CSP/SRI/security headers, rate limiting, audit logging
55
+ - Re-scan after remediation
@@ -0,0 +1,18 @@
1
+ # Preservation Contract
2
+
3
+ ## Never do in this pass
4
+
5
+ - **Fabricate** vulnerabilities, CVEs, or exploit claims. Unconfirmed → `[NEEDS VERIFICATION]`.
6
+ - **Destructive testing** — no live exploits, table drops, prod data mutation.
7
+ - **Paste secret values** in output — location (`file:line`) + type only. Flag for rotation (git history is forever).
8
+ - **Remove features/code** unilaterally to "fix" security.
9
+ - **Patch** in this pass. Remediations proposed on approval.
10
+
11
+ ## Before any change proposal
12
+
13
+ One line: **what currently works here that must keep working** (especially auth flows).
14
+
15
+ ## Buckets
16
+
17
+ - **Confirmed vulnerability** — evidence in path:line/config/dep version
18
+ - **Hardening recommendation** — best practice, not proven exploitable
@@ -0,0 +1,216 @@
1
+ ---
2
+ name: plan-stub-checker
3
+ description: >
4
+ Plan-only sweep for stubs, dead buttons, fake components, unwired handlers,
5
+ and dead links, then a wiring plan. Use when "find dead buttons", "stub
6
+ checker", "fake components", "unwired handlers", or "dead links".
7
+ license: MIT
8
+ effort: high
9
+ ---
10
+
11
+ # Stub, Dead-Link & Fake-Component Checker + Wiring Plan
12
+
13
+ **Degree of freedom: MIXED** — wiring plan is judgment; detection
14
+ passes and MCP/live probes run exactly. Stay **plan-only**. No wiring until approved.
15
+
16
+ **Role:** Senior full-stack engineer + reliability auditor.
17
+
18
+ **Task:** Exhaustively find every **stub, dead button, fake/placeholder component, and unwired
19
+ handler** across the repo. Trace whether each *should* connect to a real backend / data pipeline /
20
+ Supabase / Sentry path. Produce a burndown + wiring plan. **Audit & plan only — do not implement.**
21
+
22
+ ## This skill vs neighbors
23
+
24
+ | Skill | Does |
25
+ |-------|------|
26
+ | **plan-stub-checker** (this) | Plan only — inventory, burndown, wiring roadmap |
27
+ | `debug-fe-be-integration` | Diagnose and fix FE-BE mismatches |
28
+ | `audit-fe-api` | Audit API calls vs backend contracts |
29
+ | `test-qa` | Live QA — may find dead buttons during crawl |
30
+ | `debug-sentry-monitor` | Triage production Sentry errors |
31
+ | `workflow-fix-and-ship` | Fix → verify → PR after you approve |
32
+
33
+ **Chain:** `plan-stub-checker` → approval → `plan-test-coverage` → … see `docs/PLAN-LOOPS.md`
34
+ **Execute:** `debug-fe-be-integration` / `workflow-fix-and-ship` → `test-playwright`
35
+
36
+ ## How to reason (every plan item)
37
+
38
+ 1. **Propose** — wiring, target, contract, or instrumentation gap
39
+ 2. **Risk** — silent failure, dead control, or a fabricated target
40
+ 3. **Keep-working** — already-wired controls and live data paths
41
+ 4. **Phase** — silent-failure P0 → mock-to-live → orphan → instrumentation (do not execute)
42
+
43
+ ## Worked example
44
+
45
+ > **Propose:** wire Settings → Export to the existing `POST /api/export` action; add loading/error/empty.
46
+ > **Risk:** `onClick={() => {}}` — user thinks export ran; no request, no error.
47
+ > **Keep-working:** Settings → Save profile already hits the server action.
48
+ > **Phase:** Phase 1 — silent-failure P0.
49
+ > **Cite:** `app/settings/page.tsx:84`. Missing action → `[NEEDS REAL TARGET]`.
50
+
51
+ ---
52
+
53
+ ## ⛔ Preservation Contract
54
+
55
+ Read `references/preservation-contract.md` before Phase 1.
56
+
57
+ **Acknowledge in output #1** — restate what you will NOT do:
58
+
59
+ - No removal of features/routes/screens/handlers/props
60
+ - No fabricated endpoints, tables, env keys, or DSNs
61
+ - Every claim cites file path + line
62
+ - Preserve I/O boundaries unless wiring is proposed + approved
63
+ - No silent breaking changes
64
+ - **Plan, don't build**
65
+
66
+ ---
67
+
68
+ ## References
69
+
70
+ | File | Contents |
71
+ |------|----------|
72
+ | `references/detection-taxonomy.md` | Types, grep patterns, integration checks |
73
+ | `references/detection-methodology.md` | Six-pass methodology + linkage tracing |
74
+ | `references/output-templates.md` | Burndown, inventory, phased plan templates |
75
+
76
+ ---
77
+
78
+ ## Phase flow
79
+
80
+ ```
81
+ 1. Auto-detect stack (routes, data layer, integrations)
82
+ 2. Entry-point + static analysis sweep
83
+ 3. Handler-binding + data-flow trace
84
+ 4. False-positive filter (dynamic invocation pass)
85
+ 5. Integration linkage (API, Supabase, Sentry, pipeline)
86
+ 6. Burndown + phased wiring plan
87
+ 7. Research + guardrails (current year)
88
+ ```
89
+
90
+ ---
91
+
92
+ ## Phase 1 — Auto-detect stack [HIGH freedom]
93
+
94
+ Read `package.json` and config:
95
+
96
+ | Signal | Layer |
97
+ |--------|-------|
98
+ | `@supabase/supabase-js` | Supabase — find `createClient`, `supabase/migrations` |
99
+ | `@sentry/*` | Sentry — find init, instrumentation config |
100
+ | `react-query` / `@tanstack/react-query` | Data fetching |
101
+ | `next/server` actions | Server actions |
102
+ | `trpc` / `graphql` | API style |
103
+
104
+ Record: route manifest paths, API client location, env example file.
105
+
106
+ ---
107
+
108
+ ## Phase 2–4 — Detection passes [LOW freedom — run exactly]
109
+
110
+ Execute all passes in `references/detection-methodology.md`:
111
+
112
+ 1. Entry-point trace (reachable vs orphan candidates)
113
+ 2. Static analysis (unused exports, dead branches)
114
+ 3. Handler-binding (every interactive control → real effect?)
115
+ 4. Data-flow (display components → live source?)
116
+ 5. **Dynamic-invocation filter** — uncertain → `Review required`
117
+ 6. Config/env trace (integrations actually initialized?)
118
+
119
+ Taxonomy: `references/detection-taxonomy.md`
120
+
121
+ Keep **Confirmed** vs **Review required** separate.
122
+
123
+ Optional live click pass: `protocol-browser-anti-stall` + your own named session (`-s=…`) before playwright-cli.
124
+
125
+ Delegate a detection pass to a subagent only when it is sizeable, independent of the others, and its raw output (grep dumps, route manifests) has no place in the plan; brief it with the exact commands and the columns to return. It edits nothing, like this pass. Long sweeps are expected — context compaction exists, so finish the inventory rather than wrapping up early.
126
+
127
+ ---
128
+
129
+ ## Phase 5 — Backend / pipeline / integration linkage [HIGH freedom]
130
+
131
+ For every stub that *should* be live, map:
132
+
133
+ - **API:** endpoint or server action — exists? contract? auth? → `[NEEDS REAL TARGET]` if missing
134
+ - **Pipeline:** ingest → transform → store → read — which hop is broken?
135
+ - **Supabase:** client role, table/view, **RLS** (missing = silent break or leak), types, realtime
136
+ - **Sentry:** instrumented? swallowed catches? context/tags/release/env/source maps/PII
137
+ - **Analytics / flags / i18n:** real sink, flag resolution, key resolution
138
+
139
+ Use MCP when available:
140
+
141
+ | MCP | Use |
142
+ |-----|-----|
143
+ | Supabase | `list_tables`, policies, advisors — verify tables/RLS exist |
144
+ | Sentry | Production errors on related routes — swallowed failures |
145
+ | Firecrawl | Current-year Supabase RLS + Sentry instrumentation patterns |
146
+ | Playwright | Click dead-looking controls; observe network/nav |
147
+
148
+ Never invent table names or endpoints.
149
+
150
+ ---
151
+
152
+ ## Phase 6 — Burndown + wiring plan [HIGH freedom — plan only]
153
+
154
+ Burndown columns:
155
+
156
+ `Surface | Element | Type | Classification | Intended target | Wiring gap | Severity P0–P3 | Effort S/M/L | Risk | File:line`
157
+
158
+ Group by page/screen. Quantify totals.
159
+
160
+ **Phased wiring plan:**
161
+
162
+ 1. **Silent-failure P0s** — dead controls, swallowed errors, missing RLS
163
+ 2. **Mock → live data** — replace fixtures with real queries
164
+ 3. **Orphan cleanup** — proposals only, dependency checks
165
+ 4. **Instrumentation gaps** — Sentry, analytics, loading/error/empty states
166
+
167
+ Per confirmed stub: proposed wiring (target, contract, auth, states) + one-line "what must keep working."
168
+
169
+ **Industry-standard enhancements** (cite current year via Firecrawl):
170
+
171
+ - Typed Supabase client + generated types; RLS on every public table; test as non-owner
172
+ - Replace empty `catch` with handling + Sentry capture; breadcrumbs/tags/release
173
+ - Loading/error/empty UI for every newly-wired data path
174
+ - Guardrails: lint empty handlers, CI orphan/mock checks, PR checklist
175
+
176
+ Each phase independently reviewable + revertible.
177
+
178
+ ## Self-critique before the burndown [LOW freedom — do not skip]
179
+
180
+ 1. **evidenced-not-assumed** — every stub cites file:line; no invented endpoints
181
+ 2. **plan-only** — no wiring, no handler edits, no fabricated tables
182
+ 3. **severity/phase justified** — silent-failure and missing RLS are P0, not polish
183
+ 4. **right-owner** — empty/error rendering of a wired control → `audit-ui-states`; live QA crawl → `test-qa`
184
+ 5. **no-false-safety** — `Review required` stays uncertain until the dynamic-invocation pass
185
+
186
+ ---
187
+
188
+ ## Required output (in order)
189
+
190
+ 1. Preservation-contract acknowledgment
191
+ 2. Detection taxonomy results (counts per type)
192
+ 3. Per-surface stub/dead/fake inventory (checklist — nothing skipped)
193
+ 4. Burndown table (classification + intended-target + risk)
194
+ 5. Backend/Supabase/Sentry/pipeline linkage map
195
+ 6. Wiring + enhancement plan, phased
196
+ 7. Guardrails / tooling recommendations
197
+ 8. Research notes + citations
198
+ 9. Open questions / `[NEEDS REAL TARGET]` list
199
+
200
+ Deliver as markdown or canvas for large repos, then end the turn with a standalone recap in chat: the two or three highest-impact stubs and the first phase to approve. The document is the deliverable — write it before the recap. **Do not implement wiring** unless user approves in a follow-up.
201
+
202
+ ---
203
+
204
+ ## Rules
205
+
206
+ - **Plan only — do not implement.** User approves before wiring.
207
+ - **Trace before flagging** (entry-point + dynamic-invocation pass).
208
+ - **Never fabricate** endpoints, tables, env, or behavior.
209
+ - Missing target/integration/env → say so, don't guess.
210
+ - Before proposing any file change: one line on what must keep working.
211
+
212
+ ## Related
213
+
214
+ - `audit-ui-states` — empty/error/offline rendering (wired controls that still look broken)
215
+ - `debug-fe-be-integration` / `audit-fe-api` / `test-qa` / `workflow-fix-and-ship`
216
+
@@ -0,0 +1,75 @@
1
+ # Detection Methodology
2
+
3
+ Run all six passes. **Trace before flagging** — conservative on deletion, aggressive on finding.
4
+
5
+ ## 1. Entry-point trace
6
+
7
+ From routes / `main` / app root, trace reachable components + handlers.
8
+
9
+ ```
10
+ Glob: **/app/**/page.{tsx,jsx}
11
+ Glob: **/routes/**/*.{tsx,jsx}
12
+ Glob: **/screens/**/*.{tsx,jsx}
13
+ Glob: **/navigation/**/*.{tsx,jsx}
14
+ ```
15
+
16
+ Unreached exports/components = **orphan** candidates (not confirmed until pass 5).
17
+
18
+ ## 2. Static analysis
19
+
20
+ Trace imports, calls, instantiations, references, exports.
21
+
22
+ - Never-called functions after export
23
+ - Code after unconditional `return`
24
+ - Impossible branches
25
+ - Unused exports (`grep` + import graph)
26
+
27
+ ## 3. Handler-binding check
28
+
29
+ Every interactive element → does handler reach a real effect (network / state / nav)?
30
+
31
+ Empty, `console.log`, or mock-only → **stub** or **dead-btn**.
32
+
33
+ Optional Playwright pass: read `protocol-browser-anti-stall` + session coordination; click controls, confirm no network/nav effect.
34
+
35
+ ## 4. Data-flow check
36
+
37
+ Every data-displaying component → trace source to query/fetch/prop chain.
38
+
39
+ Hardcoded/mock/fixture in prod path → **fake** or **unwired-data**.
40
+
41
+ ```
42
+ Grep: "useQuery|useMutation|fetch\\(|axios\\.|supabase\\.from" glob "*.{tsx,jsx}"
43
+ ```
44
+
45
+ ## 5. Dynamic-invocation filter (false-positive pass)
46
+
47
+ Before confirming dead/orphan, rule out:
48
+
49
+ - Event handlers registered at runtime
50
+ - Callback props from parents
51
+ - String-based / reflection calls
52
+ - Feature-flag-gated code paths
53
+ - Registry / plugin / inheritance patterns
54
+
55
+ **Uncertain → `Review required`, not `Confirmed`.**
56
+
57
+ ## 6. Config / env trace
58
+
59
+ ```
60
+ Glob: **/.env.example **/env.{ts,js}
61
+ Grep: "createClient|@sentry|Sentry\\.init|analytics" glob "*.{ts,tsx}"
62
+ ```
63
+
64
+ Confirm referenced integrations have client init + env wiring. Missing → **severed**.
65
+
66
+ ## Backend / pipeline linkage
67
+
68
+ For each stub that *should* be live, map:
69
+
70
+ - Intended endpoint or server action — exists? contract? auth?
71
+ - Data pipeline hop (ingest → transform → store → read) — which hop is broken?
72
+ - Supabase table + RLS — use Supabase MCP `list_tables`, `pg_policies` when available
73
+ - Sentry — use Sentry MCP for production errors on related paths when available
74
+
75
+ Missing target → `[NEEDS REAL TARGET]` — never invent.
@@ -0,0 +1,34 @@
1
+ # Detection Taxonomy
2
+
3
+ Flag and classify each finding by **type**:
4
+
5
+ | Type | Signals |
6
+ |------|---------|
7
+ | **dead-btn** | `onClick`/`onPress` missing, `() => {}`, `console.log`, `// TODO`, `alert("coming soon")`, `href="#"`, `disabled` with no enable path, nav to non-existent route |
8
+ | **stub** | Handler returns hardcoded/mock, `throw new Error("not implemented")`, `return null` placeholder, empty `try/catch`, early `return` skipping real logic |
9
+ | **fake** | Static/mock/seed data in prod UI, hardcoded arrays, lorem, `mockData`, fixture imports in prod bundle, skeleton that never resolves |
10
+ | **unwired-data** | UI expects data but no fetch/query; form submits nowhere; mutation without backend; optimistic update with no server call |
11
+ | **dead-link** | Link/redirect to undefined route, 404 target, orphaned page with no inbound nav |
12
+ | **orphan** | Exported but never imported/mounted |
13
+ | **severed** | Supabase/Sentry/analytics referenced but client uninitialized, env missing, or disabled flag |
14
+
15
+ ## Static grep patterns (adapt to stack)
16
+
17
+ ```
18
+ Grep: "not implemented|NOT_IMPLEMENTED|coming soon|TODO:" glob "*.{ts,tsx,js,jsx}" -i
19
+ Grep: "onClick=\\{\\s*\\(\\)\\s*=>\\s*\\{\\s*\\}" glob "*.{tsx,jsx}"
20
+ Grep: "onClick=\\{console\\.log" glob "*.{tsx,jsx}"
21
+ Grep: "href=[\"']#[\"']" glob "*.{tsx,jsx}"
22
+ Grep: "mockData|MOCK_|fixture|lorem ipsum" glob "*.{ts,tsx}" -i
23
+ Grep: "catch\\s*\\(\\s*\\)\\s*\\{\\s*\\}" glob "*.{ts,tsx}"
24
+ Grep: "catch\\s*\\([^)]*\\)\\s*\\{\\s*\\}" glob "*.{ts,tsx}"
25
+ ```
26
+
27
+ ## Integration wiring checks
28
+
29
+ | Integration | Verify |
30
+ |-------------|--------|
31
+ | **Supabase** | Client init (anon vs service_role — never service_role client-side); table/view exists; RLS on public tables; typed client; realtime respects RLS; errors not swallowed |
32
+ | **Sentry** | SDK initialized; empty catches aren't hiding failures; context/tags/breadcrumbs; release/env; source maps; no PII leakage |
33
+ | **API / server actions** | Endpoint exists; request/response contract; auth |
34
+ | **Analytics / flags / i18n** | Events reach real sink; flag-gated stubs have resolution path; i18n keys resolve |
@@ -0,0 +1,63 @@
1
+ # Output Templates
2
+
3
+ ## Taxonomy counts (output #2)
4
+
5
+ ```markdown
6
+ | Type | Confirmed | Potential | Review required |
7
+ |------|-----------|-----------|-----------------|
8
+ | dead-btn | … | … | … |
9
+ | stub | … | … | … |
10
+ | fake | … | … | … |
11
+ | unwired-data | … | … | … |
12
+ | dead-link | … | … | … |
13
+ | orphan | … | … | … |
14
+ | severed | … | … | … |
15
+ ```
16
+
17
+ ## Per-surface inventory checklist
18
+
19
+ | Surface | dead-btn | stub | fake | unwired | dead-link | orphan | severed | Audited |
20
+ |---------|----------|------|------|---------|-----------|--------|---------|---------|
21
+
22
+ ## Burndown table
23
+
24
+ | Surface | Element | Type | Classification | Intended target | Wiring gap | Severity | Effort | Risk | File:line |
25
+ |---------|---------|------|----------------|-----------------|------------|----------|--------|------|-----------|
26
+
27
+ **Severity:** P0 = looks functional but does nothing / silent data loss / swallowed errors · P3 = cosmetic placeholder behind flag
28
+ **Intended target:** backend / Supabase / Sentry / pipeline / none
29
+ **Quantify:** e.g. "12 dead buttons, 7 mock-data components, 3 missing RLS policies"
30
+
31
+ ## Linkage map (output #5)
32
+
33
+ ```markdown
34
+ ### [Surface / feature]
35
+ - UI element: …
36
+ - Intended: Supabase `public.orders` SELECT via RLS
37
+ - Gap: no RLS policy for anon; fetch uses hardcoded mock
38
+ - Sentry: errors swallowed in empty catch at …
39
+ ```
40
+
41
+ ## Phased wiring plan
42
+
43
+ ```markdown
44
+ ### Phase 1 — Silent-failure P0s
45
+ Dead controls, swallowed errors, missing RLS
46
+
47
+ ### Phase 2 — Mock → live data
48
+ Replace fixtures with real queries/mutations
49
+
50
+ ### Phase 3 — Orphan cleanup (proposals only)
51
+ Unused exports with dependency check
52
+
53
+ ### Phase 4 — Instrumentation gaps
54
+ Sentry, analytics, loading/error/empty states
55
+ ```
56
+
57
+ ## Guardrails checklist
58
+
59
+ - [ ] Lint: empty handlers, `href="#"`, `not implemented`
60
+ - [ ] CI: orphaned exports, mock-data imports in prod paths
61
+ - [ ] PR checklist: "no dead controls shipped"
62
+ - [ ] Typed Supabase client + generated types
63
+ - [ ] RLS test with non-owner user