agemon 0.1.0 → 6.3.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 (269) hide show
  1. package/README.md +983 -30
  2. package/assets/skills/architecture/agemon-architecture/LICENSE +21 -0
  3. package/assets/skills/architecture/agemon-architecture/NOTICE.md +9 -0
  4. package/assets/skills/architecture/agemon-architecture/SKILL.md +275 -0
  5. package/assets/skills/code-quality/agemon-clean-code/LICENSE +21 -0
  6. package/assets/skills/code-quality/agemon-clean-code/NOTICE.md +9 -0
  7. package/assets/skills/code-quality/agemon-clean-code/SKILL.md +78 -0
  8. package/assets/skills/code-quality/agemon-house-rules/SKILL.md +103 -0
  9. package/assets/skills/commit/agemon-commit/SKILL.md +87 -0
  10. package/assets/skills/design/agemon-design/LICENSE +21 -0
  11. package/assets/skills/design/agemon-design/NOTICE.md +43 -0
  12. package/assets/skills/design/agemon-design/SKILL.md +128 -0
  13. package/assets/skills/design/agemon-design/references/accessibility.md +182 -0
  14. package/assets/skills/design/agemon-design/references/actions.md +215 -0
  15. package/assets/skills/design/agemon-design/references/ai-chat.md +158 -0
  16. package/assets/skills/design/agemon-design/references/brief.md +190 -0
  17. package/assets/skills/design/agemon-design/references/color.md +216 -0
  18. package/assets/skills/design/agemon-design/references/components.md +91 -0
  19. package/assets/skills/design/agemon-design/references/copy.md +300 -0
  20. package/assets/skills/design/agemon-design/references/core-rules.md +166 -0
  21. package/assets/skills/design/agemon-design/references/craft-intent.md +162 -0
  22. package/assets/skills/design/agemon-design/references/dashboard.md +131 -0
  23. package/assets/skills/design/agemon-design/references/dataviz.md +197 -0
  24. package/assets/skills/design/agemon-design/references/finish-bar.md +243 -0
  25. package/assets/skills/design/agemon-design/references/forms.md +192 -0
  26. package/assets/skills/design/agemon-design/references/heuristics.md +319 -0
  27. package/assets/skills/design/agemon-design/references/inspiration.md +287 -0
  28. package/assets/skills/design/agemon-design/references/layout.md +236 -0
  29. package/assets/skills/design/agemon-design/references/loops.md +155 -0
  30. package/assets/skills/design/agemon-design/references/metadata.md +98 -0
  31. package/assets/skills/design/agemon-design/references/modern-css.md +448 -0
  32. package/assets/skills/design/agemon-design/references/motion.md +434 -0
  33. package/assets/skills/design/agemon-design/references/personas.md +206 -0
  34. package/assets/skills/design/agemon-design/references/preset-dashboard.md +109 -0
  35. package/assets/skills/design/agemon-design/references/preset-editorial.md +94 -0
  36. package/assets/skills/design/agemon-design/references/preset-minimal.md +93 -0
  37. package/assets/skills/design/agemon-design/references/principles-catalog.md +299 -0
  38. package/assets/skills/design/agemon-design/references/recipe-auth.md +88 -0
  39. package/assets/skills/design/agemon-design/references/recipe-dashboard.md +130 -0
  40. package/assets/skills/design/agemon-design/references/recipe-landing.md +120 -0
  41. package/assets/skills/design/agemon-design/references/responsive.md +168 -0
  42. package/assets/skills/design/agemon-design/references/review.md +340 -0
  43. package/assets/skills/design/agemon-design/references/routing.md +143 -0
  44. package/assets/skills/design/agemon-design/references/sound.md +150 -0
  45. package/assets/skills/design/agemon-design/references/spec.md +123 -0
  46. package/assets/skills/design/agemon-design/references/stack.md +522 -0
  47. package/assets/skills/design/agemon-design/references/stage-assets.md +106 -0
  48. package/assets/skills/design/agemon-design/references/stage-build.md +46 -0
  49. package/assets/skills/design/agemon-design/references/stage-critique.md +34 -0
  50. package/assets/skills/design/agemon-design/references/stage-directions.md +44 -0
  51. package/assets/skills/design/agemon-design/references/stage-intake.md +34 -0
  52. package/assets/skills/design/agemon-design/references/stage-verify.md +44 -0
  53. package/assets/skills/design/agemon-design/references/state-design.md +188 -0
  54. package/assets/skills/design/agemon-design/references/tells-2026-11.md +32 -0
  55. package/assets/skills/design/agemon-design/references/themes.md +233 -0
  56. package/assets/skills/design/agemon-design/references/third-party-licenses.md +323 -0
  57. package/assets/skills/design/agemon-design/references/tokens.md +350 -0
  58. package/assets/skills/design/agemon-design/references/typography.md +248 -0
  59. package/assets/skills/design/agemon-design/scripts/audit-page.js +532 -0
  60. package/assets/skills/design/agemon-design/scripts/check-source.mjs +358 -0
  61. package/assets/skills/design/agemon-design/scripts/deal.mjs +231 -0
  62. package/assets/skills/design/agemon-design/scripts/inventory.mjs +676 -0
  63. package/assets/skills/essentials/web-design-guidelines/LICENSE +21 -0
  64. package/assets/skills/essentials/web-design-guidelines/NOTICE.md +14 -0
  65. package/assets/skills/essentials/web-design-guidelines/SKILL.md +18 -0
  66. package/assets/skills/essentials/web-design-guidelines/references/guidelines.md +184 -0
  67. package/assets/skills/essentials/writing-guidelines/LICENSE +21 -0
  68. package/assets/skills/essentials/writing-guidelines/NOTICE.md +14 -0
  69. package/assets/skills/essentials/writing-guidelines/SKILL.md +18 -0
  70. package/assets/skills/essentials/writing-guidelines/references/guidelines.md +250 -0
  71. package/assets/skills/founder/agemon-founder-board/LICENSE +21 -0
  72. package/assets/skills/founder/agemon-founder-board/NOTICE.md +11 -0
  73. package/assets/skills/founder/agemon-founder-board/SKILL.md +111 -0
  74. package/assets/skills/founder/agemon-founder-board/lenses.md +84 -0
  75. package/assets/skills/founder/agemon-founder-brand/LICENSE +21 -0
  76. package/assets/skills/founder/agemon-founder-brand/NOTICE.md +12 -0
  77. package/assets/skills/founder/agemon-founder-brand/SKILL.md +77 -0
  78. package/assets/skills/founder/agemon-founder-cfo/LICENSE +21 -0
  79. package/assets/skills/founder/agemon-founder-cfo/NOTICE.md +12 -0
  80. package/assets/skills/founder/agemon-founder-cfo/SKILL.md +109 -0
  81. package/assets/skills/founder/agemon-founder-cfo/example.json +27 -0
  82. package/assets/skills/founder/agemon-founder-cfo/unit_economics.py +270 -0
  83. package/assets/skills/founder/agemon-founder-competitors/LICENSE +21 -0
  84. package/assets/skills/founder/agemon-founder-competitors/NOTICE.md +12 -0
  85. package/assets/skills/founder/agemon-founder-competitors/SKILL.md +84 -0
  86. package/assets/skills/founder/agemon-founder-consumer/LICENSE +21 -0
  87. package/assets/skills/founder/agemon-founder-consumer/NOTICE.md +11 -0
  88. package/assets/skills/founder/agemon-founder-consumer/SKILL.md +126 -0
  89. package/assets/skills/founder/agemon-founder-consumer/customer.example.json +34 -0
  90. package/assets/skills/founder/agemon-founder-consumer/panel.py +424 -0
  91. package/assets/skills/founder/agemon-founder-consumer/pitch.example.md +3 -0
  92. package/assets/skills/founder/agemon-founder-launch/LICENSE +21 -0
  93. package/assets/skills/founder/agemon-founder-launch/NOTICE.md +11 -0
  94. package/assets/skills/founder/agemon-founder-launch/SKILL.md +65 -0
  95. package/assets/skills/founder/agemon-founder-marketing/LICENSE +21 -0
  96. package/assets/skills/founder/agemon-founder-marketing/NOTICE.md +11 -0
  97. package/assets/skills/founder/agemon-founder-marketing/SKILL.md +80 -0
  98. package/assets/skills/founder/agemon-founder-offer/LICENSE +21 -0
  99. package/assets/skills/founder/agemon-founder-offer/NOTICE.md +11 -0
  100. package/assets/skills/founder/agemon-founder-offer/SKILL.md +75 -0
  101. package/assets/skills/founder/agemon-founder-ops/LICENSE +21 -0
  102. package/assets/skills/founder/agemon-founder-ops/NOTICE.md +12 -0
  103. package/assets/skills/founder/agemon-founder-ops/SKILL.md +77 -0
  104. package/assets/skills/founder/agemon-founder-plan/LICENSE +21 -0
  105. package/assets/skills/founder/agemon-founder-plan/NOTICE.md +11 -0
  106. package/assets/skills/founder/agemon-founder-plan/SKILL.md +88 -0
  107. package/assets/skills/founder/agemon-founder-plan/compile.py +178 -0
  108. package/assets/skills/founder/agemon-founder-pricing/LICENSE +21 -0
  109. package/assets/skills/founder/agemon-founder-pricing/NOTICE.md +12 -0
  110. package/assets/skills/founder/agemon-founder-pricing/SKILL.md +92 -0
  111. package/assets/skills/founder/agemon-founder-pricing/van_westendorp.py +172 -0
  112. package/assets/skills/geo-seo/geo/LICENSE +21 -0
  113. package/assets/skills/geo-seo/geo/NOTICE.md +18 -0
  114. package/assets/skills/geo-seo/geo/SKILL.md +145 -0
  115. package/assets/skills/geo-seo/geo-audit/LICENSE +21 -0
  116. package/assets/skills/geo-seo/geo-audit/NOTICE.md +17 -0
  117. package/assets/skills/geo-seo/geo-audit/SKILL.md +371 -0
  118. package/assets/skills/geo-seo/geo-audit/references/ai-visibility.md +233 -0
  119. package/assets/skills/geo-seo/geo-audit/references/content.md +329 -0
  120. package/assets/skills/geo-seo/geo-audit/references/platform-analysis.md +294 -0
  121. package/assets/skills/geo-seo/geo-audit/references/schema.md +383 -0
  122. package/assets/skills/geo-seo/geo-audit/references/technical.md +368 -0
  123. package/assets/skills/geo-seo/geo-brand-mentions/LICENSE +21 -0
  124. package/assets/skills/geo-seo/geo-brand-mentions/NOTICE.md +15 -0
  125. package/assets/skills/geo-seo/geo-brand-mentions/SKILL.md +459 -0
  126. package/assets/skills/geo-seo/geo-citability/LICENSE +21 -0
  127. package/assets/skills/geo-seo/geo-citability/NOTICE.md +14 -0
  128. package/assets/skills/geo-seo/geo-citability/SKILL.md +320 -0
  129. package/assets/skills/geo-seo/geo-content/LICENSE +21 -0
  130. package/assets/skills/geo-seo/geo-content/NOTICE.md +14 -0
  131. package/assets/skills/geo-seo/geo-content/SKILL.md +352 -0
  132. package/assets/skills/geo-seo/geo-crawlers/LICENSE +21 -0
  133. package/assets/skills/geo-seo/geo-crawlers/NOTICE.md +15 -0
  134. package/assets/skills/geo-seo/geo-crawlers/SKILL.md +388 -0
  135. package/assets/skills/geo-seo/geo-llmstxt/LICENSE +21 -0
  136. package/assets/skills/geo-seo/geo-llmstxt/NOTICE.md +14 -0
  137. package/assets/skills/geo-seo/geo-llmstxt/SKILL.md +433 -0
  138. package/assets/skills/geo-seo/geo-platform-optimizer/LICENSE +21 -0
  139. package/assets/skills/geo-seo/geo-platform-optimizer/NOTICE.md +14 -0
  140. package/assets/skills/geo-seo/geo-platform-optimizer/SKILL.md +282 -0
  141. package/assets/skills/geo-seo/geo-report/LICENSE +21 -0
  142. package/assets/skills/geo-seo/geo-report/NOTICE.md +14 -0
  143. package/assets/skills/geo-seo/geo-report/SKILL.md +406 -0
  144. package/assets/skills/geo-seo/geo-report-pdf/LICENSE +21 -0
  145. package/assets/skills/geo-seo/geo-report-pdf/NOTICE.md +20 -0
  146. package/assets/skills/geo-seo/geo-report-pdf/SKILL.md +153 -0
  147. package/assets/skills/geo-seo/geo-report-pdf/templates/geo-report-template.html +548 -0
  148. package/assets/skills/geo-seo/geo-schema/LICENSE +21 -0
  149. package/assets/skills/geo-seo/geo-schema/NOTICE.md +16 -0
  150. package/assets/skills/geo-seo/geo-schema/SKILL.md +396 -0
  151. package/assets/skills/geo-seo/geo-technical/LICENSE +21 -0
  152. package/assets/skills/geo-seo/geo-technical/NOTICE.md +15 -0
  153. package/assets/skills/geo-seo/geo-technical/SKILL.md +566 -0
  154. package/assets/skills/output-style/agemon-adhd/LICENSE +21 -0
  155. package/assets/skills/output-style/agemon-adhd/NOTICE.md +13 -0
  156. package/assets/skills/output-style/agemon-adhd/SKILL.md +138 -0
  157. package/assets/skills/performance/agemon-performance/NOTICE.md +1 -0
  158. package/assets/skills/performance/agemon-performance/SKILL.md +76 -0
  159. package/assets/skills/security/agemon-security/LICENSE +21 -0
  160. package/assets/skills/security/agemon-security/NOTICE.md +8 -0
  161. package/assets/skills/security/agemon-security/SKILL.md +356 -0
  162. package/assets/skills/security/agemon-security-audit/AI-AND-LLM.md +83 -0
  163. package/assets/skills/security/agemon-security-audit/ATTACK-CLASSES.md +130 -0
  164. package/assets/skills/security/agemon-security-audit/CLIENT-SIDE.md +83 -0
  165. package/assets/skills/security/agemon-security-audit/CLOUD-AND-DEPLOYMENT.md +86 -0
  166. package/assets/skills/security/agemon-security-audit/DATA-ISOLATION-AND-LIFECYCLE.md +84 -0
  167. package/assets/skills/security/agemon-security-audit/DESKTOP-MOBILE-AND-LOCAL-IPC.md +89 -0
  168. package/assets/skills/security/agemon-security-audit/HUNTING.md +251 -0
  169. package/assets/skills/security/agemon-security-audit/LICENSE +21 -0
  170. package/assets/skills/security/agemon-security-audit/MEMORY-SAFETY-AND-BINARY.md +101 -0
  171. package/assets/skills/security/agemon-security-audit/NOTICE.md +12 -0
  172. package/assets/skills/security/agemon-security-audit/PROTOCOLS-RPC-AND-MESSAGING.md +81 -0
  173. package/assets/skills/security/agemon-security-audit/RECONNAISSANCE.md +156 -0
  174. package/assets/skills/security/agemon-security-audit/RESOURCE-EXHAUSTION-AND-AVAILABILITY.md +78 -0
  175. package/assets/skills/security/agemon-security-audit/SKILL.md +192 -0
  176. package/assets/skills/security/agemon-security-audit/SUPPLY-CHAIN-AND-RELEASE.md +73 -0
  177. package/assets/skills/security/agemon-security-audit/VALIDATION-AND-REPORTING.md +186 -0
  178. package/assets/skills/security/agemon-security-audit/WEB-PROTOCOL-AND-AUTH.md +105 -0
  179. package/assets/skills/security/agemon-security-audit/report-schema.json +461 -0
  180. package/assets/skills/security/agemon-security-audit/validate-coverage-ledger.cjs +872 -0
  181. package/assets/skills/security/agemon-security-audit/validate-findings.cjs +773 -0
  182. package/assets/skills/self-review/agemon-review-intake/LICENSE +21 -0
  183. package/assets/skills/self-review/agemon-review-intake/NOTICE.md +9 -0
  184. package/assets/skills/self-review/agemon-review-intake/SKILL.md +205 -0
  185. package/assets/skills/self-review/agemon-review-request/LICENSE +21 -0
  186. package/assets/skills/self-review/agemon-review-request/NOTICE.md +9 -0
  187. package/assets/skills/self-review/agemon-review-request/SKILL.md +104 -0
  188. package/assets/skills/self-review/agemon-review-request/code-reviewer.md +188 -0
  189. package/assets/skills/self-review/agemon-root-cause/LICENSE +21 -0
  190. package/assets/skills/self-review/agemon-root-cause/NOTICE.md +10 -0
  191. package/assets/skills/self-review/agemon-root-cause/SKILL.md +283 -0
  192. package/assets/skills/self-review/agemon-root-cause/condition-based-waiting-example.ts +158 -0
  193. package/assets/skills/self-review/agemon-root-cause/condition-based-waiting.md +115 -0
  194. package/assets/skills/self-review/agemon-root-cause/defense-in-depth.md +122 -0
  195. package/assets/skills/self-review/agemon-root-cause/find-polluter.sh +72 -0
  196. package/assets/skills/self-review/agemon-root-cause/root-cause-tracing.md +169 -0
  197. package/assets/skills/self-review/agemon-root-cause/test-academic.md +14 -0
  198. package/assets/skills/self-review/agemon-root-cause/test-pressure-1.md +58 -0
  199. package/assets/skills/self-review/agemon-root-cause/test-pressure-2.md +68 -0
  200. package/assets/skills/self-review/agemon-root-cause/test-pressure-3.md +69 -0
  201. package/assets/skills/self-review/agemon-verify-before-done/LICENSE +21 -0
  202. package/assets/skills/self-review/agemon-verify-before-done/NOTICE.md +9 -0
  203. package/assets/skills/self-review/agemon-verify-before-done/SKILL.md +120 -0
  204. package/assets/skills/team-lead/agemon-plan-rfc/SKILL.md +317 -0
  205. package/assets/skills/team-lead/prd-generator/SKILL.md +437 -0
  206. package/assets/skills/team-lead/skill-headofit-audit/SKILL.md +72 -0
  207. package/assets/skills/team-lead/skill-incident-rca/SKILL.md +66 -0
  208. package/assets/skills/team-lead/skill-meeting-lifecycle/SKILL.md +63 -0
  209. package/assets/skills/team-lead/skill-obsidian-vault-sync/SKILL.md +69 -0
  210. package/assets/skills/team-lead/skill-prd-decomposer/SKILL.md +71 -0
  211. package/assets/skills/team-lead/skill-sec-check/SKILL.md +70 -0
  212. package/assets/skills/team-lead/skill-task-extractor/SKILL.md +79 -0
  213. package/assets/skills/team-lead/skill-tech-spike/SKILL.md +57 -0
  214. package/assets/skills/team-lead/skill-techlead-reviewer/SKILL.md +81 -0
  215. package/assets/skills/workflow/agemon-brainstorming/LICENSE +21 -0
  216. package/assets/skills/workflow/agemon-brainstorming/NOTICE.md +14 -0
  217. package/assets/skills/workflow/agemon-brainstorming/SKILL.md +287 -0
  218. package/assets/skills/workflow/agemon-brainstorming/builder-check-prompt.md +23 -0
  219. package/assets/skills/workflow/agemon-dispatching-parallel-agents/LICENSE +21 -0
  220. package/assets/skills/workflow/agemon-dispatching-parallel-agents/NOTICE.md +13 -0
  221. package/assets/skills/workflow/agemon-dispatching-parallel-agents/SKILL.md +167 -0
  222. package/assets/skills/workflow/agemon-executing-plans/LICENSE +21 -0
  223. package/assets/skills/workflow/agemon-executing-plans/NOTICE.md +15 -0
  224. package/assets/skills/workflow/agemon-executing-plans/SKILL.md +322 -0
  225. package/assets/skills/workflow/agemon-executing-plans/scripts/task-done +55 -0
  226. package/assets/skills/workflow/agemon-executing-plans/scripts/task-start +32 -0
  227. package/assets/skills/workflow/agemon-finishing-a-development-branch/LICENSE +21 -0
  228. package/assets/skills/workflow/agemon-finishing-a-development-branch/NOTICE.md +13 -0
  229. package/assets/skills/workflow/agemon-finishing-a-development-branch/SKILL.md +225 -0
  230. package/assets/skills/workflow/agemon-subagent-driven-development/LICENSE +21 -0
  231. package/assets/skills/workflow/agemon-subagent-driven-development/NOTICE.md +15 -0
  232. package/assets/skills/workflow/agemon-subagent-driven-development/SKILL.md +339 -0
  233. package/assets/skills/workflow/agemon-subagent-driven-development/code-reviewer.md +198 -0
  234. package/assets/skills/workflow/agemon-subagent-driven-development/implementer-prompt.md +154 -0
  235. package/assets/skills/workflow/agemon-subagent-driven-development/re-review-prompt.md +116 -0
  236. package/assets/skills/workflow/agemon-subagent-driven-development/references/batching.md +11 -0
  237. package/assets/skills/workflow/agemon-subagent-driven-development/references/cannot-verify.md +10 -0
  238. package/assets/skills/workflow/agemon-subagent-driven-development/references/final-review.md +49 -0
  239. package/assets/skills/workflow/agemon-subagent-driven-development/references/fix-loop.md +77 -0
  240. package/assets/skills/workflow/agemon-subagent-driven-development/references/handling-reports.md +15 -0
  241. package/assets/skills/workflow/agemon-subagent-driven-development/references/preflight.md +26 -0
  242. package/assets/skills/workflow/agemon-subagent-driven-development/references/resuming.md +12 -0
  243. package/assets/skills/workflow/agemon-subagent-driven-development/references/role-scout.md +18 -0
  244. package/assets/skills/workflow/agemon-subagent-driven-development/references/role-worker.md +19 -0
  245. package/assets/skills/workflow/agemon-subagent-driven-development/scripts/review-package +64 -0
  246. package/assets/skills/workflow/agemon-subagent-driven-development/scripts/sdd-repo +54 -0
  247. package/assets/skills/workflow/agemon-subagent-driven-development/scripts/sdd-workspace +110 -0
  248. package/assets/skills/workflow/agemon-subagent-driven-development/scripts/task-brief +108 -0
  249. package/assets/skills/workflow/agemon-subagent-driven-development/task-reviewer-prompt.md +209 -0
  250. package/assets/skills/workflow/agemon-test-driven-development/LICENSE +21 -0
  251. package/assets/skills/workflow/agemon-test-driven-development/NOTICE.md +14 -0
  252. package/assets/skills/workflow/agemon-test-driven-development/SKILL.md +330 -0
  253. package/assets/skills/workflow/agemon-test-driven-development/writing-good-tests.md +198 -0
  254. package/assets/skills/workflow/agemon-using-git-worktrees/LICENSE +21 -0
  255. package/assets/skills/workflow/agemon-using-git-worktrees/NOTICE.md +13 -0
  256. package/assets/skills/workflow/agemon-using-git-worktrees/SKILL.md +167 -0
  257. package/assets/skills/workflow/agemon-writing-plans/LICENSE +21 -0
  258. package/assets/skills/workflow/agemon-writing-plans/NOTICE.md +13 -0
  259. package/assets/skills/workflow/agemon-writing-plans/SKILL.md +204 -0
  260. package/assets/tools/code-review-graph-constraints.txt +1418 -0
  261. package/assets/tools/package-lock.json +111 -0
  262. package/assets/tools/package.json +6 -0
  263. package/dist/chunk-ZZBF3GOV.js +3451 -0
  264. package/dist/chunk-ZZBF3GOV.js.map +1 -0
  265. package/dist/fake-subprocess-IV4ML77S.js +636 -0
  266. package/dist/fake-subprocess-IV4ML77S.js.map +1 -0
  267. package/dist/index.js +23836 -1945
  268. package/dist/index.js.map +1 -1
  269. package/package.json +37 -17
@@ -0,0 +1,437 @@
1
+ ---
2
+ name: prd-generator
3
+ description: Generate comprehensive Product Requirements Documents (PRDs) for product managers. Use this skill when users ask to "create a PRD", "write product requirements", "document a feature", or need help structuring product specifications.
4
+ ---
5
+
6
+ # PRD Generator
7
+
8
+ ## Overview
9
+
10
+ Generate comprehensive, well-structured Product Requirements Documents (PRDs) that follow industry best practices. This skill helps product managers create clear, actionable requirements documents that align stakeholders and guide development teams.
11
+
12
+ ## Core Workflow
13
+
14
+ When a user requests to create a PRD (e.g., "create a PRD for a user authentication feature"), follow this workflow:
15
+
16
+ ### Step 1: Gather Context
17
+
18
+ Before generating the PRD, collect essential information through a discovery conversation:
19
+
20
+ **Required Information:**
21
+ - **Feature/Product Name**: What are we building?
22
+ - **Problem Statement**: What problem does this solve?
23
+ - **Target Users**: Who is this for?
24
+ - **Business Goals**: What are we trying to achieve?
25
+ - **Success Metrics**: How will we measure success?
26
+ - **Timeline/Constraints**: Any deadlines or limitations?
27
+
28
+ **Discovery Questions to Ask:**
29
+
30
+ ```
31
+ 1. What problem are you trying to solve?
32
+ 2. Who is the primary user/audience for this feature?
33
+ 3. What are the key business objectives?
34
+ 4. Are there any technical constraints we should be aware of?
35
+ 5. What does success look like? How will you measure it?
36
+ 6. What's the timeline for this feature?
37
+ 7. What's explicitly out of scope?
38
+ ```
39
+
40
+ **Note:** If the user provides a detailed brief or requirements upfront, you can skip some questions. Always ask for clarification on missing critical information.
41
+
42
+ ### Step 2: Generate PRD Structure
43
+
44
+ Structure the document with the following sections:
45
+
46
+ 1. **Executive Summary** - High-level overview (2-3 paragraphs)
47
+ 2. **Problem Statement** - Clear articulation of the problem
48
+ 3. **Goals & Objectives** - What we're trying to achieve
49
+ 4. **User Personas** - Who we're building for
50
+ 5. **User Stories & Requirements** - Detailed functional requirements
51
+ 6. **Success Metrics** - KPIs and measurement criteria
52
+ 7. **Scope** - What's in and out of scope
53
+ 8. **Technical Considerations** - Architecture, dependencies, constraints
54
+ 9. **Design & UX Requirements** - UI/UX considerations
55
+ 10. **Timeline & Milestones** - Key dates and phases
56
+ 11. **Risks & Mitigation** - Potential issues and solutions
57
+ 12. **Dependencies & Assumptions** - What we're relying on
58
+ 13. **Open Questions** - Unresolved items
59
+
60
+ ### Step 3: Create User Stories
61
+
62
+ For each major requirement, generate user stories using the standard format:
63
+
64
+ ```
65
+ As a [user type],
66
+ I want to [action],
67
+ So that [benefit/value].
68
+
69
+ Acceptance Criteria:
70
+ - [Specific, testable criterion 1]
71
+ - [Specific, testable criterion 2]
72
+ - [Specific, testable criterion 3]
73
+ ```
74
+
75
+ Keep each story independent, testable, and free of implementation details (see User Story Best Practices below).
76
+
77
+ ### Step 4: Define Success Metrics
78
+
79
+ Use appropriate metrics frameworks based on the product type:
80
+
81
+ - **AARRR (Pirate Metrics)**: Acquisition, Activation, Retention, Revenue, Referral
82
+ - **HEART Framework**: Happiness, Engagement, Adoption, Retention, Task Success
83
+ - **North Star Metric**: Single key metric that represents core value
84
+ - **OKRs**: Objectives and Key Results
85
+
86
+ Pick the framework that matches the product type and stakeholder expectations, and define concrete targets for each metric — not just the metric name.
87
+
88
+ ### Step 5: Validate & Review
89
+
90
+ Before finalizing, walk through the Self-Review Checklist below to confirm the PRD is complete: all required sections present, user stories follow the standard format, success metrics are defined with targets, scope is clearly bounded, and no placeholder text remains.
91
+
92
+ ## Usage Patterns
93
+
94
+ ### Pattern 1: New Feature PRD
95
+
96
+ **User Request:** "Create a PRD for adding dark mode to our mobile app"
97
+
98
+ **Execution:**
99
+
100
+ 1. Ask discovery questions about dark mode requirements
101
+ 2. Generate PRD using template
102
+ 3. Create user stories for:
103
+ - Theme switching
104
+ - Preference persistence
105
+ - System-level sync
106
+ - Design token updates
107
+ 4. Define success metrics (adoption rate, user satisfaction)
108
+ 5. Identify technical dependencies (design system, platform APIs)
109
+
110
+ ### Pattern 2: Product Enhancement PRD
111
+
112
+ **User Request:** "Write requirements for improving our search functionality"
113
+
114
+ **Execution:**
115
+
116
+ 1. Gather context on current search limitations
117
+ 2. Identify user pain points and desired improvements
118
+ 3. Generate PRD with focus on:
119
+ - Current state analysis
120
+ - Proposed enhancements
121
+ - Impact assessment
122
+ 4. Create prioritized user stories
123
+ 5. Define before/after metrics
124
+
125
+ ### Pattern 3: New Product PRD
126
+
127
+ **User Request:** "I need a PRD for a new analytics dashboard product"
128
+
129
+ **Execution:**
130
+
131
+ 1. Comprehensive discovery (market analysis, user research)
132
+ 2. Generate full PRD with:
133
+ - Market opportunity
134
+ - Competitive analysis
135
+ - Product vision
136
+ - MVP scope
137
+ - Go-to-market considerations
138
+ 3. Detailed user stories for core features
139
+ 4. Phased rollout plan
140
+ 5. Success metrics aligned with business goals
141
+
142
+ ### Pattern 4: Quick PRD / One-Pager
143
+
144
+ **User Request:** "Create a lightweight PRD for a small bug fix feature"
145
+
146
+ **Execution:**
147
+
148
+ 1. Generate simplified PRD focusing on:
149
+ - Problem statement
150
+ - Solution approach
151
+ - Acceptance criteria
152
+ - Success metrics
153
+ 2. Skip sections not relevant for small scope
154
+ 3. Keep document concise (1-2 pages)
155
+
156
+ ## PRD Best Practices
157
+
158
+ ### Writing Quality Requirements
159
+
160
+ **Good Requirements Are:**
161
+ - **Specific**: Clear and unambiguous
162
+ - **Measurable**: Can be verified/tested
163
+ - **Achievable**: Technically feasible
164
+ - **Relevant**: Tied to user/business value
165
+ - **Time-bound**: Has clear timeline
166
+
167
+ **Avoid:**
168
+ - Vague language ("fast", "easy", "intuitive")
169
+ - Implementation details (let engineers decide how)
170
+ - Feature creep (stick to core requirements)
171
+ - Assumptions without validation
172
+
173
+ ### User Story Best Practices
174
+
175
+ **DO:**
176
+ - Focus on user value, not features
177
+ - Write from user perspective
178
+ - Include clear acceptance criteria
179
+ - Keep stories independent and small
180
+ - Use consistent format
181
+
182
+ **DON'T:**
183
+ - Write technical implementation details
184
+ - Create dependencies between stories
185
+ - Make stories too large (epics)
186
+ - Use internal jargon
187
+ - Skip acceptance criteria
188
+
189
+ ### Scope Management
190
+
191
+ **In-Scope Section:**
192
+ - List specific features/capabilities included
193
+ - Be explicit and detailed
194
+ - Link to user stories
195
+
196
+ **Out-of-Scope Section:**
197
+ - Explicitly state what's NOT included
198
+ - Prevents scope creep
199
+ - Manages stakeholder expectations
200
+ - Can include "future considerations"
201
+
202
+ ### Success Metrics Guidelines
203
+
204
+ **Choose Metrics That:**
205
+ - Align with business objectives
206
+ - Are measurable and trackable
207
+ - Have clear targets/thresholds
208
+ - Include both leading and lagging indicators
209
+ - Consider user and business value
210
+
211
+ **Typical Metric Categories:**
212
+ - **Adoption**: How many users use the feature?
213
+ - **Engagement**: How often do they use it?
214
+ - **Satisfaction**: Do users like it?
215
+ - **Performance**: Does it work well?
216
+ - **Business Impact**: Does it drive business goals?
217
+
218
+ ## Advanced Features
219
+
220
+ ### PRD Templates for Different Contexts
221
+
222
+ The skill supports different PRD formats:
223
+
224
+ **Standard PRD** - Full comprehensive document
225
+ **Lean PRD** - Streamlined for agile teams
226
+ **One-Pager** - Executive summary format
227
+ **Technical PRD** - Engineering-focused requirements
228
+ **Design PRD** - UX/UI-focused requirements
229
+
230
+ Specify the format when requesting: "Create a lean PRD for..." or "Generate a technical PRD for..."
231
+
232
+ ### Integration with Design
233
+
234
+ **Design Requirements Section Should Include:**
235
+ - Visual design requirements
236
+ - Interaction patterns
237
+ - Accessibility requirements (WCAG compliance)
238
+ - Responsive design considerations
239
+ - Design system components to use
240
+ - User flow diagrams
241
+ - Wireframe/mockup references
242
+
243
+ ### Technical Considerations Section
244
+
245
+ **Should Address:**
246
+ - **Architecture**: High-level technical approach
247
+ - **Dependencies**: External services, libraries, APIs
248
+ - **Security**: Authentication, authorization, data protection
249
+ - **Performance**: Load times, scalability requirements
250
+ - **Compatibility**: Browser, device, platform support
251
+ - **Data**: Storage, migration, privacy considerations
252
+ - **Integration**: How it fits with existing systems
253
+
254
+ ### Stakeholder Alignment
255
+
256
+ **PRD Should Help:**
257
+ - Align cross-functional teams
258
+ - Set clear expectations
259
+ - Enable parallel work streams
260
+ - Facilitate decision-making
261
+ - Provide single source of truth
262
+
263
+ **Distribution Checklist:**
264
+ - [ ] Engineering reviewed technical feasibility
265
+ - [ ] Design reviewed UX requirements
266
+ - [ ] Product leadership approved scope
267
+ - [ ] Stakeholders understand timeline
268
+ - [ ] Success metrics agreed upon
269
+
270
+ ## Common PRD Scenarios
271
+
272
+ ### Scenario 1: Feature Request from Customer
273
+
274
+ When creating a PRD based on customer feedback:
275
+
276
+ 1. Document the customer request verbatim
277
+ 2. Analyze the underlying problem
278
+ 3. Generalize the solution for all users
279
+ 4. Validate with product strategy
280
+ 5. Scope appropriately (might be smaller or larger than request)
281
+
282
+ ### Scenario 2: Strategic Initiative
283
+
284
+ When creating a PRD for a strategic company initiative:
285
+
286
+ 1. Link to company OKRs/goals
287
+ 2. Include market analysis
288
+ 3. Consider competitive landscape
289
+ 4. Think multi-phase rollout
290
+ 5. Include success criteria aligned with strategy
291
+
292
+ ### Scenario 3: Technical Debt / Infrastructure
293
+
294
+ When creating a PRD for technical improvements:
295
+
296
+ 1. Explain user impact (even if indirect)
297
+ 2. Document current limitations
298
+ 3. Articulate benefits (speed, reliability, maintainability)
299
+ 4. Include engineering input heavily
300
+ 5. Define measurable improvements
301
+
302
+ ### Scenario 4: Compliance / Regulatory
303
+
304
+ When creating a PRD for compliance requirements:
305
+
306
+ 1. Reference specific regulations (GDPR, HIPAA, etc.)
307
+ 2. Include legal/compliance review
308
+ 3. Deadline is usually non-negotiable
309
+ 4. Focus on minimum viable compliance
310
+ 5. Document audit trail requirements
311
+
312
+ ## Validation & Quality Checks
313
+
314
+ ### Self-Review Checklist
315
+
316
+ Before finalizing the PRD, verify:
317
+
318
+ - [ ] **Problem is clear**: Anyone can understand what we're solving
319
+ - [ ] **Users are identified**: We know who this is for
320
+ - [ ] **Success is measurable**: We can determine if it worked
321
+ - [ ] **Scope is bounded**: Clear what's in and out
322
+ - [ ] **Requirements are testable**: QA can verify completion
323
+ - [ ] **Timeline is realistic**: Estimates validated with engineering
324
+ - [ ] **Risks are identified**: We've thought through what could go wrong
325
+ - [ ] **Stakeholders aligned**: Key people have reviewed and approved
326
+
327
+ ## Tips for Product Managers
328
+
329
+ ### Before Writing the PRD
330
+
331
+ 1. **Do your research**: User interviews, data analysis, competitive analysis
332
+ 2. **Validate the problem**: Ensure it's worth solving
333
+ 3. **Check strategic alignment**: Does this fit our roadmap?
334
+ 4. **Estimate effort**: Rough t-shirt size with engineering
335
+ 5. **Consider alternatives**: Is this the best solution?
336
+
337
+ ### During PRD Creation
338
+
339
+ 1. **Be clear, not clever**: Simple language wins
340
+ 2. **Show, don't tell**: Use examples, mockups, diagrams
341
+ 3. **Think edge cases**: What could go wrong?
342
+ 4. **Prioritize ruthlessly**: What's MVP vs. nice-to-have?
343
+ 5. **Collaborate early**: Don't work in isolation
344
+
345
+ ### After PRD Completion
346
+
347
+ 1. **Review with stakeholders**: Get feedback early
348
+ 2. **Iterate based on input**: PRDs are living documents
349
+ 3. **Present, don't just share**: Walk through the PRD
350
+ 4. **Get formal sign-off**: Ensure commitment
351
+ 5. **Keep it updated**: Adjust as understanding evolves
352
+
353
+ ## Examples
354
+
355
+ ### Example 1: Mobile Feature PRD
356
+
357
+ ```bash
358
+ # User: "Create a PRD for adding biometric authentication to our iOS app"
359
+
360
+ # Assistant will:
361
+ # 1. Ask discovery questions about security requirements, user personas, existing auth
362
+ # 2. Generate PRD covering:
363
+ # - Problem: Password friction, security concerns
364
+ # - Solution: Face ID / Touch ID integration
365
+ # - User stories: Enable biometric, fallback to password, settings management
366
+ # - Metrics: Adoption rate, login success rate, support tickets
367
+ # - Technical: iOS Keychain, LocalAuthentication framework
368
+ # - Risks: Device compatibility, user privacy concerns
369
+ # 3. Output formatted markdown PRD
370
+ ```
371
+
372
+ ### Example 2: Web Platform Enhancement
373
+
374
+ ```bash
375
+ # User: "Write requirements for improving our checkout flow conversion"
376
+
377
+ # Assistant will:
378
+ # 1. Gather data on current conversion rates and drop-off points
379
+ # 2. Generate PRD including:
380
+ # - Current state analysis with metrics
381
+ # - Proposed improvements (guest checkout, saved payment, progress indicator)
382
+ # - A/B test plan
383
+ # - Success metrics: Conversion rate increase, time to checkout
384
+ # - User stories for each improvement
385
+ # 3. Include phased rollout approach
386
+ ```
387
+
388
+ ### Example 3: B2B Product PRD
389
+
390
+ ```bash
391
+ # User: "I need a PRD for an admin dashboard for enterprise customers"
392
+
393
+ # Assistant will:
394
+ # 1. Identify B2B-specific requirements (multi-tenancy, permissions, reporting)
395
+ # 2. Generate comprehensive PRD with:
396
+ # - Enterprise user personas (admin, manager, analyst)
397
+ # - Role-based access control requirements
398
+ # - Reporting and analytics needs
399
+ # - Integration requirements (SSO, SCIM)
400
+ # - Success metrics: Customer adoption, admin efficiency
401
+ # 3. Include enterprise-specific considerations (compliance, SLAs)
402
+ ```
403
+
404
+ ## Troubleshooting
405
+
406
+ **Issue: PRD is too long/detailed**
407
+
408
+ Solution: Create a "Lean PRD" focusing on problem, solution, acceptance criteria, and metrics. Reserve full PRD for major initiatives.
409
+
410
+ **Issue: Requirements are too vague**
411
+
412
+ Solution: Add specific examples, use concrete numbers, include visual references. Replace "fast" with "loads in under 2 seconds."
413
+
414
+ **Issue: Stakeholders not aligned**
415
+
416
+ Solution: Share PRD early as draft, incorporate feedback, present in person, get explicit sign-off before development starts.
417
+
418
+ **Issue: Scope keeps expanding**
419
+
420
+ Solution: Use "Out of Scope" section aggressively, create separate PRDs for future phases, tie scope to timeline constraints.
421
+
422
+ **Issue: Engineers say it's not feasible**
423
+
424
+ Solution: Involve engineering earlier in process, be flexible on solution approach, focus on problem not implementation.
425
+
426
+ ## Best Practices Summary
427
+
428
+ 1. **Start with the problem, not the solution**
429
+ 2. **Write for your audience** (execs need summary, engineers need details)
430
+ 3. **Be specific and measurable** (avoid vague language)
431
+ 4. **Include visuals** (mockups, diagrams, flows)
432
+ 5. **Define success upfront** (metrics, not features)
433
+ 6. **Scope aggressively** (MVP mentality)
434
+ 7. **Collaborate, don't dictate** (get input from all functions)
435
+ 8. **Keep it updated** (PRD is a living document)
436
+ 9. **Focus on "why" and "what", not "how"** (let engineers solve "how")
437
+ 10. **Make it skimmable** (headers, bullets, summaries)
@@ -0,0 +1,72 @@
1
+ ---
2
+ name: skill-headofit-audit
3
+ description: Evaluates SaaS tools, cloud infrastructure costs, self-hosted alternatives, vendor lock-in risks, and compliance readiness for Head of IT and IT Leadership decisions.
4
+ triggers: ["@vendor-audit", "head of it evaluation", "saas audit", "build vs buy", "infrastructure cost audit", "vendor evaluation"]
5
+ ---
6
+
7
+ # Instruction Rules
8
+ 1. **Multi-Vector Scoring:** Evaluate across 5 key pillars: Functional Fit, Technical/API Integration, Security & Compliance, Operational Overhead, and Total Cost of Ownership (TCO).
9
+ 2. **Require Build vs. Buy Analysis:** Force explicit trade-off comparisons between managed SaaS, open-source/self-hosted (e.g., Coolify/Docker), and custom builds.
10
+ 3. **Flag Lock-In & Portability Risks:** Always audit data export formats, vendor exit costs, and migration pathways.
11
+ 4. **Output Format:** Clean Markdown featuring comparative scoring matrices, TCO projections, and strategic recommendations.
12
+
13
+ # Assessment Workflow
14
+ - **Phase 1: Need & Scope Definition:** Clarify business problem, usage scale, must-have constraints, and budget ceilings.
15
+ - **Phase 2: Build vs. Buy vs. Self-Host Analysis:** Evaluate managed options vs. self-hosted/open-source deployments.
16
+ - **Phase 3: Multi-Pillar Scoring & Security Pre-flight:** Audit SOC 2, GDPR, data residency, SLA guarantees, and API capabilities.
17
+ - **Phase 4: Financial TCO & Vendor Decision:** Calculate initial onboarding, subscription, maintenance, and exit costs over a 12–36 month horizon.
18
+
19
+ ---
20
+
21
+ # Output Schema
22
+
23
+ # IT Infrastructure & Vendor Audit: [Vendor / Solution Name]
24
+
25
+ ## 1. Executive Brief & Context
26
+ - **Evaluation Goal:** [e.g., Replacing managed DB platform with self-hosted PostgreSQL via Coolify]
27
+ - **Current Annual Spend / Cost:** [e.g., $18,000 / year]
28
+ - **Target Scale:** [e.g., 50 team members, 20 microservices, 99.9% uptime requirement]
29
+
30
+ ---
31
+
32
+ ## 2. Build vs. Buy vs. Self-Host Matrix
33
+
34
+ | Parameter | Managed SaaS | Self-Hosted / Homelab | Custom In-House |
35
+ | :--- | :--- | :--- | :--- |
36
+ | **Direct License Cost** | High ($1,500/mo) | Low (Infra bare-metal cost) | None |
37
+ | **Ops / Maintenance Effort** | Low (Vendor managed) | Medium-High (Internal Team) | High |
38
+ | **Data Control & Residency** | Moderate (Vendor Cloud) | Complete (Self-managed) | Complete |
39
+ | **Vendor Lock-in Risk** | High | Low | None |
40
+
41
+ ---
42
+
43
+ ## 3. Weighted Evaluation Scorecard
44
+
45
+ | Category | Weight | Score (1-5) | Key Observations |
46
+ | :--- | :--- | :--- | :--- |
47
+ | **Functional & Workflow Fit** | 30% | 4.5 / 5.0 | Meets 95% of operational requirements out of the box. |
48
+ | **Technical & API Capabilities** | 20% | 4.0 / 5.0 | REST & Webhook support present; missing GraphQL API. |
49
+ | **Security & Compliance** | 20% | 5.0 / 5.0 | GDPR compliant, SOC 2 Type II certified, isolated tenant DBs. |
50
+ | **Ops & Maintenance Overhead** | 15% | 3.5 / 5.0 | Requires internal team onboarding and backup orchestration. |
51
+ | **Financial & TCO Impact** | 15% | 4.0 / 5.0 | Payback period achieved within 6 months. |
52
+ | **Weighted Total** | **100%** | **4.28 / 5.0**| **RECOMMENDED** |
53
+
54
+ ---
55
+
56
+ ## 4. 3-Year Total Cost of Ownership (TCO) Projection
57
+
58
+ ```
59
+ [Year 1 Setup & Licensing] ──> $12,000
60
+ [Year 2 Maintenance & Run] ──> $8,500
61
+ [Year 3 Maintenance & Run] ──> $8,500
62
+ Total Estimated 3-Year TCO: $29,000 (35% savings vs incumbent)
63
+ ```
64
+
65
+ ---
66
+
67
+ ## 5. Security, Risk & Exit Strategy
68
+ - **Security Check:** SOC 2 Type II verified, TLS 1.3 enforced, RBAC + SAML/SSO supported.
69
+ - **Vendor Lock-in Risk:** LOW. Native JSON/SQL export supported via API and CLI.
70
+ - **Recommended Next Steps:**
71
+ 1. Initiate 14-day technical pilot on staging infrastructure.
72
+ 2. Draft migration & rollback plan before contract finalization.
@@ -0,0 +1,66 @@
1
+ ---
2
+ name: skill-incident-rca
3
+ description: Blameless Root Cause Analysis (RCA) and Post-Mortem framework for production outages, regressions, and critical incidents. Uses the 5 Whys and Causal Chain analysis to convert incident logs into durable preventative actions.
4
+ triggers: ["@incident-rca", "post-mortem", "root cause analysis", "incident report", "outage rca", "rca"]
5
+ ---
6
+
7
+ # Instruction Rules
8
+ 1. **Enforce Blameless Culture:** Focus strictly on systemic vulnerabilities, process gaps, and missing safeguards. Never attribute failures to individual human error.
9
+ 2. **5 Whys Deep-Dive:** Chain every surface symptom down through at least 5 levels of "Why?" until reaching an actionable architectural or process gap. If evidence runs out before reaching level 5, mark the chain `UNKNOWN — insufficient evidence` at that point rather than inventing an unsupported cause.
10
+ 3. **Quantify Impact:** Explicitly quantify outage duration, user blast radius, data loss, and SLA breach metrics. Mark any metric not available in the evidence as `UNKNOWN` rather than estimating.
11
+ 4. **Action Item Discipline:** Output clear action items with specific owners, category tags, and due dates. Avoid vague terms like "improve testing".
12
+
13
+ # Execution Workflow
14
+ - **Step 1: Timeline Reconstruction:** Map events chronologically (Start $\rightarrow$ Detection $\rightarrow$ Triage $\rightarrow$ Mitigation $\rightarrow$ Resolution).
15
+ - **Step 2: Root Cause & 5 Whys Analysis:** Dig past immediate triggers (e.g., "database lock") to underlying root causes (e.g., "missing connection pool timeouts").
16
+ - **Step 3: Contributing Factors:** Identify monitoring gaps, missing runbooks, or testing blind spots that aggravated the issue.
17
+ - **Step 4: Preventative Action Matrix:** Create owned, closed-form engineering tasks.
18
+
19
+ ---
20
+
21
+ # Output Schema
22
+
23
+ # Post-Mortem: [Incident Title / Outage Name]
24
+
25
+ ## 1. Executive Summary
26
+ - **Incident Date:** {{YYYY-MM-DD}}
27
+ - **Severity Level:** [ SEV-1 | SEV-2 | SEV-3 ]
28
+ - **Time to Detect (TTD):** [e.g., 8 minutes]
29
+ - **Time to Resolve (TTR):** [e.g., 42 minutes]
30
+ - **Blast Radius:** [e.g., 15% of active API traffic received HTTP 500 errors]
31
+ - **Summary:** [3-sentence executive overview of what failed, impact, and mitigation]
32
+
33
+ ---
34
+
35
+ ## 2. Chronological Timeline
36
+ | Timestamp (UTC) | Event Phase | Description & Findings | Source / Evidence |
37
+ | :--- | :--- | :--- | :--- |
38
+ | **14:02** | Incident Start | Spike in background worker memory usage. | Grafana Alert |
39
+ | **14:08** | Detection | Automated alert paged On-Call Lead. | PagerDuty |
40
+ | **14:15** | Containment | Scaled worker pool & cleared queue. | Manual Action |
41
+ | **14:44** | Resolution | Deployed patch `v1.2.1` with memory caps. | CI/CD Deploy |
42
+
43
+ ---
44
+
45
+ ## 3. Root Cause Analysis (The 5 Whys)
46
+ 1. **Why did the API crash?** $\rightarrow$ Worker node ran out of memory (OOM).
47
+ 2. **Why did it run out of memory?** $\rightarrow$ A background job loaded a 4GB dataset into RAM at once.
48
+ 3. **Why did it load the full dataset?** $\rightarrow$ Pagination parameter was omitted in the query payload.
49
+ 4. **Why was pagination missing?** $\rightarrow$ The endpoint lacked input schema validation for array bounds.
50
+ 5. **Why was validation missing?** $\rightarrow$ Systemic gap: API review checklists do not require execution limits on bulk export endpoints.
51
+
52
+ ---
53
+
54
+ ## 4. Contributing Factors
55
+ - **Monitoring Gap:** No alert was configured for database connection pool saturation prior to node OOM.
56
+ - **Process Gap:** Staging environment data volume was too small to surface memory scaling limits during integration testing.
57
+
58
+ ---
59
+
60
+ ## 5. Preventative Action Items
61
+
62
+ | Action Item | Category | Assignee | Due Date | Target Ticket |
63
+ | :--- | :--- | :--- | :--- | :--- |
64
+ | Add memory boundary limit to API validator | Prevention | `@developer` | 2026-10-05 | `ENG-402` |
65
+ | Configure connection pool saturation alert at 80% | Detection | `@devops` | 2026-10-02 | `OPS-118` |
66
+ | Seed staging DB with realistic volume mock data | Process | `@qa-lead` | 2026-10-12 | `QA-88` |
@@ -0,0 +1,63 @@
1
+ ---
2
+ name: skill-meeting-lifecycle
3
+ description: Processes raw transcripts or meeting notes into structured intelligence, distinguishing executive summaries, key decisions, speaker attributions, and follow-up items.
4
+ triggers: ["@meeting-notes", "process transcript", "meeting summary", "meeting notes", "call breakdown"]
5
+ ---
6
+
7
+ # Instruction Rules
8
+ 1. **Never Hallucinate Commitments:** Only extract decisions and action items explicitly stated or clearly implied in the transcript.
9
+ 2. **Dual-Tier Summary:** Always provide both a high-level executive brief (for leadership/stakeholders) and a granular technical breakdown (for engineering).
10
+ 3. **Obsidian Integration:** Auto-generate `[[WikiLinks]]` for people, projects, and key technologies mentioned.
11
+ 4. **Output Format:** Clean Markdown using structured tables and actionable checklists.
12
+
13
+ # Processing Framework
14
+ - **Step 1: Context & Metadata Extraction:** Identify meeting date, purpose, attendees, and project context.
15
+ - **Step 2: Executive & Granular Synthesis:** Summarize core outcomes and group discussion points by technical topic.
16
+ - **Step 3: Decision Log:** Extract concrete architectural, product, or operational decisions made during the call.
17
+ - **Step 4: Action Items Extraction:** Prepare raw task payloads for downstream PM tools or Obsidian daily notes.
18
+
19
+ ---
20
+
21
+ # Output Schema
22
+
23
+ # Meeting Notes: [Meeting Title / Topic]
24
+
25
+ ## 1. Meeting Overview
26
+ - **Date & Time:** {{YYYY-MM-DD}}
27
+ - **Attendees:** [[Person A]], [[Person B]], [[Person C]]
28
+ - **Project Context:** [[Project Name]]
29
+ - **Executive Brief:** [2-3 concise sentences summarizing the core outcome of the call]
30
+
31
+ ---
32
+
33
+ ## 2. Key Decisions Made
34
+ | # | Decision | Rationale | Owner / Lead |
35
+ | :--- | :--- | :--- | :--- |
36
+ | **1** | Migrating auth layer to Supabase | Reduces custom maintenance overhead | [[Person A]] |
37
+ | **2** | Postpone feature X to Sprint 15 | Prioritizing API performance fixes | [[Person B]] |
38
+
39
+ ---
40
+
41
+ ## 3. Topic Breakdown & Discussion Notes
42
+
43
+ ### Topic A: [e.g., Infrastructure & Database Scaling]
44
+ - Discussion focused on recent API latency spikes under load.
45
+ - [[Person A]] shared telemetry showing connection pool exhaustion.
46
+ - Consensus reached to add Redis caching before doubling database instance size.
47
+
48
+ ### Topic B: [e.g., Q3 Product Roadmap Adjustments]
49
+ - Reviewed client feedback on onboarding workflow.
50
+ - Agreed to simplify signup steps down to 2 screens.
51
+
52
+ ---
53
+
54
+ ## 4. Raw Action Items
55
+ - [ ] **Task 1:** [[Person A]] to draft Redis caching proposal by Friday.
56
+ - [ ] **Task 2:** [[Person B]] to update Figma designs for simplified onboarding.
57
+ - [ ] **Task 3:** [[Person C]] to check staging environment log retention settings.
58
+
59
+ ---
60
+
61
+ ## 5. Unresolved Questions & Next Steps
62
+ - [ ] **Open Item:** How will the new caching layer handle multi-region invalidation?
63
+ - **Next Sync:** Scheduled for {{YYYY-MM-DD}}