@djm204/agent-skills 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (392) hide show
  1. package/README.md +597 -0
  2. package/bin/cli.js +8 -0
  3. package/package.json +55 -0
  4. package/src/index.js +1817 -0
  5. package/src/index.test.js +1264 -0
  6. package/templates/_shared/code-quality.mdc +52 -0
  7. package/templates/_shared/communication.mdc +43 -0
  8. package/templates/_shared/core-principles.mdc +67 -0
  9. package/templates/_shared/git-workflow.mdc +48 -0
  10. package/templates/_shared/security-fundamentals.mdc +41 -0
  11. package/templates/agents/utility-agent/.cursor/rules/action-control.mdc +71 -0
  12. package/templates/agents/utility-agent/.cursor/rules/context-management.mdc +61 -0
  13. package/templates/agents/utility-agent/.cursor/rules/hallucination-prevention.mdc +58 -0
  14. package/templates/agents/utility-agent/.cursor/rules/overview.mdc +34 -0
  15. package/templates/agents/utility-agent/.cursor/rules/token-optimization.mdc +71 -0
  16. package/templates/agents/utility-agent/CLAUDE.md +513 -0
  17. package/templates/business/market-intelligence/.cursor/rules/data-sources.mdc +62 -0
  18. package/templates/business/market-intelligence/.cursor/rules/overview.mdc +55 -0
  19. package/templates/business/market-intelligence/.cursor/rules/reporting.mdc +59 -0
  20. package/templates/business/market-intelligence/.cursor/rules/risk-signals.mdc +63 -0
  21. package/templates/business/market-intelligence/.cursor/rules/sentiment-analysis.mdc +70 -0
  22. package/templates/business/market-intelligence/.cursor/rules/trend-detection.mdc +72 -0
  23. package/templates/business/market-intelligence/CLAUDE.md +371 -0
  24. package/templates/business/marketing-expert/.cursor/rules/brand-strategy.mdc +74 -0
  25. package/templates/business/marketing-expert/.cursor/rules/campaign-planning.mdc +60 -0
  26. package/templates/business/marketing-expert/.cursor/rules/growth-frameworks.mdc +69 -0
  27. package/templates/business/marketing-expert/.cursor/rules/market-analysis.mdc +70 -0
  28. package/templates/business/marketing-expert/.cursor/rules/marketing-analytics.mdc +71 -0
  29. package/templates/business/marketing-expert/.cursor/rules/overview.mdc +56 -0
  30. package/templates/business/marketing-expert/CLAUDE.md +567 -0
  31. package/templates/business/predictive-maintenance/.cursor/rules/alerting.mdc +56 -0
  32. package/templates/business/predictive-maintenance/.cursor/rules/asset-lifecycle.mdc +71 -0
  33. package/templates/business/predictive-maintenance/.cursor/rules/failure-prediction.mdc +65 -0
  34. package/templates/business/predictive-maintenance/.cursor/rules/maintenance-scheduling.mdc +61 -0
  35. package/templates/business/predictive-maintenance/.cursor/rules/overview.mdc +55 -0
  36. package/templates/business/predictive-maintenance/.cursor/rules/sensor-analytics.mdc +66 -0
  37. package/templates/business/predictive-maintenance/CLAUDE.md +529 -0
  38. package/templates/business/product-manager/.cursor/rules/communication.mdc +77 -0
  39. package/templates/business/product-manager/.cursor/rules/discovery.mdc +79 -0
  40. package/templates/business/product-manager/.cursor/rules/metrics.mdc +75 -0
  41. package/templates/business/product-manager/.cursor/rules/overview.mdc +47 -0
  42. package/templates/business/product-manager/.cursor/rules/prioritization.mdc +66 -0
  43. package/templates/business/product-manager/.cursor/rules/requirements.mdc +79 -0
  44. package/templates/business/product-manager/CLAUDE.md +593 -0
  45. package/templates/business/project-manager/.cursor/rules/overview.mdc +53 -0
  46. package/templates/business/project-manager/.cursor/rules/reporting.mdc +68 -0
  47. package/templates/business/project-manager/.cursor/rules/risk-management.mdc +71 -0
  48. package/templates/business/project-manager/.cursor/rules/scheduling.mdc +67 -0
  49. package/templates/business/project-manager/.cursor/rules/scope-management.mdc +66 -0
  50. package/templates/business/project-manager/.cursor/rules/stakeholder-management.mdc +70 -0
  51. package/templates/business/project-manager/CLAUDE.md +540 -0
  52. package/templates/business/regulatory-sentinel/.cursor/rules/compliance-tracking.mdc +74 -0
  53. package/templates/business/regulatory-sentinel/.cursor/rules/impact-assessment.mdc +62 -0
  54. package/templates/business/regulatory-sentinel/.cursor/rules/monitoring.mdc +67 -0
  55. package/templates/business/regulatory-sentinel/.cursor/rules/overview.mdc +55 -0
  56. package/templates/business/regulatory-sentinel/.cursor/rules/reporting.mdc +61 -0
  57. package/templates/business/regulatory-sentinel/.cursor/rules/risk-classification.mdc +73 -0
  58. package/templates/business/regulatory-sentinel/CLAUDE.md +572 -0
  59. package/templates/business/resource-allocator/.cursor/rules/capacity-modeling.mdc +65 -0
  60. package/templates/business/resource-allocator/.cursor/rules/coordination.mdc +67 -0
  61. package/templates/business/resource-allocator/.cursor/rules/crisis-management.mdc +64 -0
  62. package/templates/business/resource-allocator/.cursor/rules/demand-prediction.mdc +52 -0
  63. package/templates/business/resource-allocator/.cursor/rules/overview.mdc +76 -0
  64. package/templates/business/resource-allocator/.cursor/rules/scheduling.mdc +63 -0
  65. package/templates/business/resource-allocator/CLAUDE.md +525 -0
  66. package/templates/business/strategic-negotiator/.cursor/rules/contract-analysis.mdc +60 -0
  67. package/templates/business/strategic-negotiator/.cursor/rules/deal-structuring.mdc +66 -0
  68. package/templates/business/strategic-negotiator/.cursor/rules/game-theory.mdc +64 -0
  69. package/templates/business/strategic-negotiator/.cursor/rules/overview.mdc +55 -0
  70. package/templates/business/strategic-negotiator/.cursor/rules/preparation.mdc +79 -0
  71. package/templates/business/strategic-negotiator/.cursor/rules/scenario-modeling.mdc +66 -0
  72. package/templates/business/strategic-negotiator/CLAUDE.md +640 -0
  73. package/templates/business/supply-chain/.cursor/rules/cost-modeling.mdc +67 -0
  74. package/templates/business/supply-chain/.cursor/rules/demand-forecasting.mdc +67 -0
  75. package/templates/business/supply-chain/.cursor/rules/inventory-management.mdc +69 -0
  76. package/templates/business/supply-chain/.cursor/rules/logistics.mdc +61 -0
  77. package/templates/business/supply-chain/.cursor/rules/overview.mdc +64 -0
  78. package/templates/business/supply-chain/.cursor/rules/supplier-evaluation.mdc +66 -0
  79. package/templates/business/supply-chain/CLAUDE.md +590 -0
  80. package/templates/business/supply-chain-harmonizer/.cursor/rules/disruption-response.mdc +67 -0
  81. package/templates/business/supply-chain-harmonizer/.cursor/rules/inventory-rebalancing.mdc +63 -0
  82. package/templates/business/supply-chain-harmonizer/.cursor/rules/overview.mdc +65 -0
  83. package/templates/business/supply-chain-harmonizer/.cursor/rules/rerouting.mdc +64 -0
  84. package/templates/business/supply-chain-harmonizer/.cursor/rules/scenario-simulation.mdc +68 -0
  85. package/templates/business/supply-chain-harmonizer/.cursor/rules/stakeholder-notifications.mdc +61 -0
  86. package/templates/business/supply-chain-harmonizer/CLAUDE.md +600 -0
  87. package/templates/creative/brand-guardian/.cursor/rules/brand-voice.mdc +64 -0
  88. package/templates/creative/brand-guardian/.cursor/rules/content-review.mdc +47 -0
  89. package/templates/creative/brand-guardian/.cursor/rules/ethical-guidelines.mdc +47 -0
  90. package/templates/creative/brand-guardian/.cursor/rules/multi-channel.mdc +49 -0
  91. package/templates/creative/brand-guardian/.cursor/rules/overview.mdc +58 -0
  92. package/templates/creative/brand-guardian/.cursor/rules/visual-identity.mdc +64 -0
  93. package/templates/creative/brand-guardian/CLAUDE.md +634 -0
  94. package/templates/creative/content-creation-expert/.cursor/rules/content-strategy.mdc +65 -0
  95. package/templates/creative/content-creation-expert/.cursor/rules/copywriting.mdc +59 -0
  96. package/templates/creative/content-creation-expert/.cursor/rules/editorial-operations.mdc +65 -0
  97. package/templates/creative/content-creation-expert/.cursor/rules/multimedia-production.mdc +64 -0
  98. package/templates/creative/content-creation-expert/.cursor/rules/overview.mdc +58 -0
  99. package/templates/creative/content-creation-expert/.cursor/rules/seo-content.mdc +75 -0
  100. package/templates/creative/content-creation-expert/CLAUDE.md +568 -0
  101. package/templates/creative/narrative-architect/.cursor/rules/collaboration.mdc +62 -0
  102. package/templates/creative/narrative-architect/.cursor/rules/continuity-tracking.mdc +56 -0
  103. package/templates/creative/narrative-architect/.cursor/rules/overview.mdc +68 -0
  104. package/templates/creative/narrative-architect/.cursor/rules/story-bible.mdc +77 -0
  105. package/templates/creative/narrative-architect/.cursor/rules/timeline-management.mdc +60 -0
  106. package/templates/creative/narrative-architect/.cursor/rules/world-building.mdc +78 -0
  107. package/templates/creative/narrative-architect/CLAUDE.md +737 -0
  108. package/templates/creative/social-media-expert/.cursor/rules/audience-growth.mdc +62 -0
  109. package/templates/creative/social-media-expert/.cursor/rules/community-management.mdc +67 -0
  110. package/templates/creative/social-media-expert/.cursor/rules/content-strategy.mdc +60 -0
  111. package/templates/creative/social-media-expert/.cursor/rules/overview.mdc +48 -0
  112. package/templates/creative/social-media-expert/.cursor/rules/platform-strategy.mdc +64 -0
  113. package/templates/creative/social-media-expert/.cursor/rules/social-analytics.mdc +64 -0
  114. package/templates/creative/social-media-expert/CLAUDE.md +624 -0
  115. package/templates/creative/trend-forecaster/.cursor/rules/cultural-analysis.mdc +59 -0
  116. package/templates/creative/trend-forecaster/.cursor/rules/forecasting-methods.mdc +63 -0
  117. package/templates/creative/trend-forecaster/.cursor/rules/overview.mdc +58 -0
  118. package/templates/creative/trend-forecaster/.cursor/rules/reporting.mdc +61 -0
  119. package/templates/creative/trend-forecaster/.cursor/rules/signal-analysis.mdc +74 -0
  120. package/templates/creative/trend-forecaster/.cursor/rules/trend-lifecycle.mdc +75 -0
  121. package/templates/creative/trend-forecaster/CLAUDE.md +717 -0
  122. package/templates/creative/ux-designer/.cursor/rules/accessibility.mdc +69 -0
  123. package/templates/creative/ux-designer/.cursor/rules/emotional-design.mdc +59 -0
  124. package/templates/creative/ux-designer/.cursor/rules/handoff.mdc +73 -0
  125. package/templates/creative/ux-designer/.cursor/rules/information-architecture.mdc +62 -0
  126. package/templates/creative/ux-designer/.cursor/rules/interaction-design.mdc +66 -0
  127. package/templates/creative/ux-designer/.cursor/rules/overview.mdc +61 -0
  128. package/templates/creative/ux-designer/.cursor/rules/research.mdc +61 -0
  129. package/templates/creative/ux-designer/.cursor/rules/visual-design.mdc +68 -0
  130. package/templates/creative/ux-designer/CLAUDE.md +124 -0
  131. package/templates/dogfood/project-overview.mdc +12 -0
  132. package/templates/dogfood/project-structure.mdc +82 -0
  133. package/templates/dogfood/rules-creation-best-practices.mdc +45 -0
  134. package/templates/education/educator/.cursor/rules/accessibility.mdc +67 -0
  135. package/templates/education/educator/.cursor/rules/assessment.mdc +68 -0
  136. package/templates/education/educator/.cursor/rules/curriculum.mdc +57 -0
  137. package/templates/education/educator/.cursor/rules/engagement.mdc +65 -0
  138. package/templates/education/educator/.cursor/rules/instructional-design.mdc +69 -0
  139. package/templates/education/educator/.cursor/rules/overview.mdc +57 -0
  140. package/templates/education/educator/.cursor/rules/retention.mdc +64 -0
  141. package/templates/education/educator/CLAUDE.md +338 -0
  142. package/templates/engineering/blockchain/.cursor/rules/defi-patterns.mdc +48 -0
  143. package/templates/engineering/blockchain/.cursor/rules/gas-optimization.mdc +77 -0
  144. package/templates/engineering/blockchain/.cursor/rules/overview.mdc +41 -0
  145. package/templates/engineering/blockchain/.cursor/rules/security.mdc +61 -0
  146. package/templates/engineering/blockchain/.cursor/rules/smart-contracts.mdc +64 -0
  147. package/templates/engineering/blockchain/.cursor/rules/testing.mdc +77 -0
  148. package/templates/engineering/blockchain/.cursor/rules/web3-integration.mdc +47 -0
  149. package/templates/engineering/blockchain/CLAUDE.md +389 -0
  150. package/templates/engineering/cli-tools/.cursor/rules/architecture.mdc +76 -0
  151. package/templates/engineering/cli-tools/.cursor/rules/arguments.mdc +65 -0
  152. package/templates/engineering/cli-tools/.cursor/rules/distribution.mdc +40 -0
  153. package/templates/engineering/cli-tools/.cursor/rules/error-handling.mdc +67 -0
  154. package/templates/engineering/cli-tools/.cursor/rules/overview.mdc +58 -0
  155. package/templates/engineering/cli-tools/.cursor/rules/testing.mdc +42 -0
  156. package/templates/engineering/cli-tools/.cursor/rules/user-experience.mdc +43 -0
  157. package/templates/engineering/cli-tools/CLAUDE.md +356 -0
  158. package/templates/engineering/data-engineering/.cursor/rules/data-modeling.mdc +71 -0
  159. package/templates/engineering/data-engineering/.cursor/rules/data-quality.mdc +78 -0
  160. package/templates/engineering/data-engineering/.cursor/rules/overview.mdc +49 -0
  161. package/templates/engineering/data-engineering/.cursor/rules/performance.mdc +71 -0
  162. package/templates/engineering/data-engineering/.cursor/rules/pipeline-design.mdc +79 -0
  163. package/templates/engineering/data-engineering/.cursor/rules/security.mdc +79 -0
  164. package/templates/engineering/data-engineering/.cursor/rules/testing.mdc +75 -0
  165. package/templates/engineering/data-engineering/CLAUDE.md +974 -0
  166. package/templates/engineering/devops-sre/.cursor/rules/capacity-planning.mdc +49 -0
  167. package/templates/engineering/devops-sre/.cursor/rules/change-management.mdc +51 -0
  168. package/templates/engineering/devops-sre/.cursor/rules/chaos-engineering.mdc +50 -0
  169. package/templates/engineering/devops-sre/.cursor/rules/disaster-recovery.mdc +54 -0
  170. package/templates/engineering/devops-sre/.cursor/rules/incident-management.mdc +56 -0
  171. package/templates/engineering/devops-sre/.cursor/rules/observability.mdc +50 -0
  172. package/templates/engineering/devops-sre/.cursor/rules/overview.mdc +76 -0
  173. package/templates/engineering/devops-sre/.cursor/rules/postmortems.mdc +49 -0
  174. package/templates/engineering/devops-sre/.cursor/rules/runbooks.mdc +49 -0
  175. package/templates/engineering/devops-sre/.cursor/rules/slo-sli.mdc +46 -0
  176. package/templates/engineering/devops-sre/.cursor/rules/toil-reduction.mdc +52 -0
  177. package/templates/engineering/devops-sre/CLAUDE.md +1007 -0
  178. package/templates/engineering/fullstack/.cursor/rules/api-contracts.mdc +79 -0
  179. package/templates/engineering/fullstack/.cursor/rules/architecture.mdc +79 -0
  180. package/templates/engineering/fullstack/.cursor/rules/overview.mdc +61 -0
  181. package/templates/engineering/fullstack/.cursor/rules/shared-types.mdc +77 -0
  182. package/templates/engineering/fullstack/.cursor/rules/testing.mdc +72 -0
  183. package/templates/engineering/fullstack/CLAUDE.md +349 -0
  184. package/templates/engineering/ml-ai/.cursor/rules/data-engineering.mdc +71 -0
  185. package/templates/engineering/ml-ai/.cursor/rules/deployment.mdc +43 -0
  186. package/templates/engineering/ml-ai/.cursor/rules/model-development.mdc +44 -0
  187. package/templates/engineering/ml-ai/.cursor/rules/monitoring.mdc +45 -0
  188. package/templates/engineering/ml-ai/.cursor/rules/overview.mdc +42 -0
  189. package/templates/engineering/ml-ai/.cursor/rules/security.mdc +51 -0
  190. package/templates/engineering/ml-ai/.cursor/rules/testing.mdc +44 -0
  191. package/templates/engineering/ml-ai/CLAUDE.md +1136 -0
  192. package/templates/engineering/mobile/.cursor/rules/navigation.mdc +75 -0
  193. package/templates/engineering/mobile/.cursor/rules/offline-first.mdc +68 -0
  194. package/templates/engineering/mobile/.cursor/rules/overview.mdc +76 -0
  195. package/templates/engineering/mobile/.cursor/rules/performance.mdc +78 -0
  196. package/templates/engineering/mobile/.cursor/rules/testing.mdc +77 -0
  197. package/templates/engineering/mobile/CLAUDE.md +233 -0
  198. package/templates/engineering/platform-engineering/.cursor/rules/ci-cd.mdc +51 -0
  199. package/templates/engineering/platform-engineering/.cursor/rules/developer-experience.mdc +48 -0
  200. package/templates/engineering/platform-engineering/.cursor/rules/infrastructure-as-code.mdc +62 -0
  201. package/templates/engineering/platform-engineering/.cursor/rules/kubernetes.mdc +51 -0
  202. package/templates/engineering/platform-engineering/.cursor/rules/observability.mdc +52 -0
  203. package/templates/engineering/platform-engineering/.cursor/rules/overview.mdc +44 -0
  204. package/templates/engineering/platform-engineering/.cursor/rules/security.mdc +74 -0
  205. package/templates/engineering/platform-engineering/.cursor/rules/testing.mdc +59 -0
  206. package/templates/engineering/platform-engineering/CLAUDE.md +850 -0
  207. package/templates/engineering/qa-engineering/.cursor/rules/automation.mdc +71 -0
  208. package/templates/engineering/qa-engineering/.cursor/rules/metrics.mdc +68 -0
  209. package/templates/engineering/qa-engineering/.cursor/rules/overview.mdc +45 -0
  210. package/templates/engineering/qa-engineering/.cursor/rules/quality-gates.mdc +54 -0
  211. package/templates/engineering/qa-engineering/.cursor/rules/test-design.mdc +59 -0
  212. package/templates/engineering/qa-engineering/.cursor/rules/test-strategy.mdc +62 -0
  213. package/templates/engineering/qa-engineering/CLAUDE.md +726 -0
  214. package/templates/engineering/testing/.cursor/rules/advanced-techniques.mdc +44 -0
  215. package/templates/engineering/testing/.cursor/rules/ci-cd-integration.mdc +43 -0
  216. package/templates/engineering/testing/.cursor/rules/overview.mdc +61 -0
  217. package/templates/engineering/testing/.cursor/rules/performance-testing.mdc +39 -0
  218. package/templates/engineering/testing/.cursor/rules/quality-metrics.mdc +74 -0
  219. package/templates/engineering/testing/.cursor/rules/reliability.mdc +39 -0
  220. package/templates/engineering/testing/.cursor/rules/tdd-methodology.mdc +52 -0
  221. package/templates/engineering/testing/.cursor/rules/test-data.mdc +46 -0
  222. package/templates/engineering/testing/.cursor/rules/test-design.mdc +45 -0
  223. package/templates/engineering/testing/.cursor/rules/test-types.mdc +71 -0
  224. package/templates/engineering/testing/CLAUDE.md +1134 -0
  225. package/templates/engineering/unity-dev-expert/.cursor/rules/csharp-architecture.mdc +61 -0
  226. package/templates/engineering/unity-dev-expert/.cursor/rules/multiplayer-networking.mdc +67 -0
  227. package/templates/engineering/unity-dev-expert/.cursor/rules/overview.mdc +56 -0
  228. package/templates/engineering/unity-dev-expert/.cursor/rules/performance-optimization.mdc +76 -0
  229. package/templates/engineering/unity-dev-expert/.cursor/rules/physics-rendering.mdc +59 -0
  230. package/templates/engineering/unity-dev-expert/.cursor/rules/ui-systems.mdc +59 -0
  231. package/templates/engineering/unity-dev-expert/CLAUDE.md +534 -0
  232. package/templates/engineering/web-backend/.cursor/rules/api-design.mdc +64 -0
  233. package/templates/engineering/web-backend/.cursor/rules/authentication.mdc +69 -0
  234. package/templates/engineering/web-backend/.cursor/rules/database-patterns.mdc +73 -0
  235. package/templates/engineering/web-backend/.cursor/rules/error-handling.mdc +66 -0
  236. package/templates/engineering/web-backend/.cursor/rules/overview.mdc +74 -0
  237. package/templates/engineering/web-backend/.cursor/rules/security.mdc +60 -0
  238. package/templates/engineering/web-backend/.cursor/rules/testing.mdc +74 -0
  239. package/templates/engineering/web-backend/CLAUDE.md +366 -0
  240. package/templates/engineering/web-frontend/.cursor/rules/accessibility.mdc +75 -0
  241. package/templates/engineering/web-frontend/.cursor/rules/component-patterns.mdc +76 -0
  242. package/templates/engineering/web-frontend/.cursor/rules/overview.mdc +77 -0
  243. package/templates/engineering/web-frontend/.cursor/rules/performance.mdc +73 -0
  244. package/templates/engineering/web-frontend/.cursor/rules/state-management.mdc +71 -0
  245. package/templates/engineering/web-frontend/.cursor/rules/styling.mdc +69 -0
  246. package/templates/engineering/web-frontend/.cursor/rules/testing.mdc +75 -0
  247. package/templates/engineering/web-frontend/CLAUDE.md +399 -0
  248. package/templates/languages/cpp-expert/.cursor/rules/concurrency.mdc +68 -0
  249. package/templates/languages/cpp-expert/.cursor/rules/error-handling.mdc +65 -0
  250. package/templates/languages/cpp-expert/.cursor/rules/memory-and-ownership.mdc +68 -0
  251. package/templates/languages/cpp-expert/.cursor/rules/modern-cpp.mdc +75 -0
  252. package/templates/languages/cpp-expert/.cursor/rules/overview.mdc +37 -0
  253. package/templates/languages/cpp-expert/.cursor/rules/performance.mdc +74 -0
  254. package/templates/languages/cpp-expert/.cursor/rules/testing.mdc +70 -0
  255. package/templates/languages/cpp-expert/.cursor/rules/tooling.mdc +77 -0
  256. package/templates/languages/cpp-expert/CLAUDE.md +242 -0
  257. package/templates/languages/csharp-expert/.cursor/rules/aspnet-core.mdc +78 -0
  258. package/templates/languages/csharp-expert/.cursor/rules/async-patterns.mdc +71 -0
  259. package/templates/languages/csharp-expert/.cursor/rules/dependency-injection.mdc +76 -0
  260. package/templates/languages/csharp-expert/.cursor/rules/error-handling.mdc +65 -0
  261. package/templates/languages/csharp-expert/.cursor/rules/language-features.mdc +74 -0
  262. package/templates/languages/csharp-expert/.cursor/rules/overview.mdc +47 -0
  263. package/templates/languages/csharp-expert/.cursor/rules/performance.mdc +66 -0
  264. package/templates/languages/csharp-expert/.cursor/rules/testing.mdc +78 -0
  265. package/templates/languages/csharp-expert/.cursor/rules/tooling.mdc +78 -0
  266. package/templates/languages/csharp-expert/CLAUDE.md +360 -0
  267. package/templates/languages/golang-expert/.cursor/rules/concurrency.mdc +79 -0
  268. package/templates/languages/golang-expert/.cursor/rules/error-handling.mdc +77 -0
  269. package/templates/languages/golang-expert/.cursor/rules/interfaces-and-types.mdc +77 -0
  270. package/templates/languages/golang-expert/.cursor/rules/overview.mdc +74 -0
  271. package/templates/languages/golang-expert/.cursor/rules/performance.mdc +76 -0
  272. package/templates/languages/golang-expert/.cursor/rules/production-patterns.mdc +76 -0
  273. package/templates/languages/golang-expert/.cursor/rules/stdlib-and-tooling.mdc +68 -0
  274. package/templates/languages/golang-expert/.cursor/rules/testing.mdc +77 -0
  275. package/templates/languages/golang-expert/CLAUDE.md +361 -0
  276. package/templates/languages/java-expert/.cursor/rules/concurrency.mdc +69 -0
  277. package/templates/languages/java-expert/.cursor/rules/error-handling.mdc +70 -0
  278. package/templates/languages/java-expert/.cursor/rules/modern-java.mdc +74 -0
  279. package/templates/languages/java-expert/.cursor/rules/overview.mdc +42 -0
  280. package/templates/languages/java-expert/.cursor/rules/performance.mdc +69 -0
  281. package/templates/languages/java-expert/.cursor/rules/persistence.mdc +74 -0
  282. package/templates/languages/java-expert/.cursor/rules/spring-boot.mdc +73 -0
  283. package/templates/languages/java-expert/.cursor/rules/testing.mdc +79 -0
  284. package/templates/languages/java-expert/.cursor/rules/tooling.mdc +76 -0
  285. package/templates/languages/java-expert/CLAUDE.md +325 -0
  286. package/templates/languages/javascript-expert/.cursor/rules/language-deep-dive.mdc +74 -0
  287. package/templates/languages/javascript-expert/.cursor/rules/node-patterns.mdc +77 -0
  288. package/templates/languages/javascript-expert/.cursor/rules/overview.mdc +66 -0
  289. package/templates/languages/javascript-expert/.cursor/rules/performance.mdc +64 -0
  290. package/templates/languages/javascript-expert/.cursor/rules/react-patterns.mdc +70 -0
  291. package/templates/languages/javascript-expert/.cursor/rules/testing.mdc +76 -0
  292. package/templates/languages/javascript-expert/.cursor/rules/tooling.mdc +72 -0
  293. package/templates/languages/javascript-expert/.cursor/rules/typescript-deep-dive.mdc +77 -0
  294. package/templates/languages/javascript-expert/CLAUDE.md +479 -0
  295. package/templates/languages/kotlin-expert/.cursor/rules/coroutines.mdc +75 -0
  296. package/templates/languages/kotlin-expert/.cursor/rules/error-handling.mdc +69 -0
  297. package/templates/languages/kotlin-expert/.cursor/rules/frameworks.mdc +76 -0
  298. package/templates/languages/kotlin-expert/.cursor/rules/language-features.mdc +78 -0
  299. package/templates/languages/kotlin-expert/.cursor/rules/overview.mdc +38 -0
  300. package/templates/languages/kotlin-expert/.cursor/rules/performance.mdc +73 -0
  301. package/templates/languages/kotlin-expert/.cursor/rules/testing.mdc +70 -0
  302. package/templates/languages/kotlin-expert/.cursor/rules/tooling.mdc +67 -0
  303. package/templates/languages/kotlin-expert/CLAUDE.md +276 -0
  304. package/templates/languages/python-expert/.cursor/rules/async-python.mdc +71 -0
  305. package/templates/languages/python-expert/.cursor/rules/overview.mdc +76 -0
  306. package/templates/languages/python-expert/.cursor/rules/patterns-and-idioms.mdc +77 -0
  307. package/templates/languages/python-expert/.cursor/rules/performance.mdc +74 -0
  308. package/templates/languages/python-expert/.cursor/rules/testing.mdc +77 -0
  309. package/templates/languages/python-expert/.cursor/rules/tooling.mdc +77 -0
  310. package/templates/languages/python-expert/.cursor/rules/type-system.mdc +77 -0
  311. package/templates/languages/python-expert/.cursor/rules/web-and-apis.mdc +76 -0
  312. package/templates/languages/python-expert/CLAUDE.md +264 -0
  313. package/templates/languages/ruby-expert/.cursor/rules/concurrency-and-threading.mdc +65 -0
  314. package/templates/languages/ruby-expert/.cursor/rules/error-handling.mdc +69 -0
  315. package/templates/languages/ruby-expert/.cursor/rules/idioms-and-style.mdc +76 -0
  316. package/templates/languages/ruby-expert/.cursor/rules/overview.mdc +60 -0
  317. package/templates/languages/ruby-expert/.cursor/rules/performance.mdc +68 -0
  318. package/templates/languages/ruby-expert/.cursor/rules/rails-and-frameworks.mdc +60 -0
  319. package/templates/languages/ruby-expert/.cursor/rules/testing.mdc +56 -0
  320. package/templates/languages/ruby-expert/.cursor/rules/tooling.mdc +52 -0
  321. package/templates/languages/ruby-expert/CLAUDE.md +102 -0
  322. package/templates/languages/rust-expert/.cursor/rules/concurrency.mdc +69 -0
  323. package/templates/languages/rust-expert/.cursor/rules/ecosystem-and-tooling.mdc +76 -0
  324. package/templates/languages/rust-expert/.cursor/rules/error-handling.mdc +76 -0
  325. package/templates/languages/rust-expert/.cursor/rules/overview.mdc +62 -0
  326. package/templates/languages/rust-expert/.cursor/rules/ownership-and-borrowing.mdc +70 -0
  327. package/templates/languages/rust-expert/.cursor/rules/performance-and-unsafe.mdc +70 -0
  328. package/templates/languages/rust-expert/.cursor/rules/testing.mdc +73 -0
  329. package/templates/languages/rust-expert/.cursor/rules/traits-and-generics.mdc +76 -0
  330. package/templates/languages/rust-expert/CLAUDE.md +283 -0
  331. package/templates/languages/swift-expert/.cursor/rules/concurrency.mdc +77 -0
  332. package/templates/languages/swift-expert/.cursor/rules/error-handling.mdc +76 -0
  333. package/templates/languages/swift-expert/.cursor/rules/language-features.mdc +78 -0
  334. package/templates/languages/swift-expert/.cursor/rules/overview.mdc +46 -0
  335. package/templates/languages/swift-expert/.cursor/rules/performance.mdc +69 -0
  336. package/templates/languages/swift-expert/.cursor/rules/swiftui.mdc +77 -0
  337. package/templates/languages/swift-expert/.cursor/rules/testing.mdc +75 -0
  338. package/templates/languages/swift-expert/.cursor/rules/tooling.mdc +77 -0
  339. package/templates/languages/swift-expert/CLAUDE.md +275 -0
  340. package/templates/professional/documentation/.cursor/rules/adr.mdc +65 -0
  341. package/templates/professional/documentation/.cursor/rules/api-documentation.mdc +64 -0
  342. package/templates/professional/documentation/.cursor/rules/code-comments.mdc +75 -0
  343. package/templates/professional/documentation/.cursor/rules/maintenance.mdc +58 -0
  344. package/templates/professional/documentation/.cursor/rules/overview.mdc +48 -0
  345. package/templates/professional/documentation/.cursor/rules/readme-standards.mdc +70 -0
  346. package/templates/professional/documentation/CLAUDE.md +120 -0
  347. package/templates/professional/executive-assistant/.cursor/rules/calendar.mdc +51 -0
  348. package/templates/professional/executive-assistant/.cursor/rules/confidentiality.mdc +53 -0
  349. package/templates/professional/executive-assistant/.cursor/rules/email.mdc +49 -0
  350. package/templates/professional/executive-assistant/.cursor/rules/meetings.mdc +39 -0
  351. package/templates/professional/executive-assistant/.cursor/rules/overview.mdc +42 -0
  352. package/templates/professional/executive-assistant/.cursor/rules/prioritization.mdc +48 -0
  353. package/templates/professional/executive-assistant/.cursor/rules/stakeholder-management.mdc +50 -0
  354. package/templates/professional/executive-assistant/.cursor/rules/travel.mdc +43 -0
  355. package/templates/professional/executive-assistant/CLAUDE.md +620 -0
  356. package/templates/professional/grant-writer/.cursor/rules/budgets.mdc +55 -0
  357. package/templates/professional/grant-writer/.cursor/rules/compliance.mdc +47 -0
  358. package/templates/professional/grant-writer/.cursor/rules/funding-research.mdc +47 -0
  359. package/templates/professional/grant-writer/.cursor/rules/narrative.mdc +58 -0
  360. package/templates/professional/grant-writer/.cursor/rules/overview.mdc +68 -0
  361. package/templates/professional/grant-writer/.cursor/rules/post-award.mdc +59 -0
  362. package/templates/professional/grant-writer/.cursor/rules/review-criteria.mdc +51 -0
  363. package/templates/professional/grant-writer/.cursor/rules/sustainability.mdc +48 -0
  364. package/templates/professional/grant-writer/CLAUDE.md +577 -0
  365. package/templates/professional/knowledge-synthesis/.cursor/rules/document-management.mdc +51 -0
  366. package/templates/professional/knowledge-synthesis/.cursor/rules/knowledge-graphs.mdc +63 -0
  367. package/templates/professional/knowledge-synthesis/.cursor/rules/overview.mdc +74 -0
  368. package/templates/professional/knowledge-synthesis/.cursor/rules/research-workflow.mdc +50 -0
  369. package/templates/professional/knowledge-synthesis/.cursor/rules/search-retrieval.mdc +62 -0
  370. package/templates/professional/knowledge-synthesis/.cursor/rules/summarization.mdc +61 -0
  371. package/templates/professional/knowledge-synthesis/CLAUDE.md +593 -0
  372. package/templates/professional/life-logistics/.cursor/rules/financial-optimization.mdc +78 -0
  373. package/templates/professional/life-logistics/.cursor/rules/negotiation.mdc +68 -0
  374. package/templates/professional/life-logistics/.cursor/rules/overview.mdc +75 -0
  375. package/templates/professional/life-logistics/.cursor/rules/research-methodology.mdc +76 -0
  376. package/templates/professional/life-logistics/.cursor/rules/scheduling.mdc +68 -0
  377. package/templates/professional/life-logistics/.cursor/rules/task-management.mdc +47 -0
  378. package/templates/professional/life-logistics/CLAUDE.md +601 -0
  379. package/templates/professional/research-assistant/.cursor/rules/citation-attribution.mdc +61 -0
  380. package/templates/professional/research-assistant/.cursor/rules/information-synthesis.mdc +65 -0
  381. package/templates/professional/research-assistant/.cursor/rules/overview.mdc +56 -0
  382. package/templates/professional/research-assistant/.cursor/rules/research-methodologies.mdc +54 -0
  383. package/templates/professional/research-assistant/.cursor/rules/search-strategies.mdc +57 -0
  384. package/templates/professional/research-assistant/.cursor/rules/source-evaluation.mdc +59 -0
  385. package/templates/professional/research-assistant/CLAUDE.md +318 -0
  386. package/templates/professional/wellness-orchestrator/.cursor/rules/adaptive-planning.mdc +69 -0
  387. package/templates/professional/wellness-orchestrator/.cursor/rules/data-integration.mdc +60 -0
  388. package/templates/professional/wellness-orchestrator/.cursor/rules/fitness-programming.mdc +66 -0
  389. package/templates/professional/wellness-orchestrator/.cursor/rules/nutrition-planning.mdc +57 -0
  390. package/templates/professional/wellness-orchestrator/.cursor/rules/overview.mdc +76 -0
  391. package/templates/professional/wellness-orchestrator/.cursor/rules/sleep-optimization.mdc +68 -0
  392. package/templates/professional/wellness-orchestrator/CLAUDE.md +573 -0
@@ -0,0 +1,624 @@
1
+ # Social Media Expert Development Guide
2
+
3
+ Principal-level guidelines for developing platform strategy, planning content calendars, growing audiences organically and through paid amplification, managing communities, orchestrating influencer partnerships, interpreting social analytics, and handling crisis communication across all major social platforms.
4
+
5
+ ---
6
+
7
+ ## Overview
8
+
9
+ This guide applies to:
10
+
11
+ - Platform strategy and algorithm optimization across Instagram, TikTok, LinkedIn, X, YouTube, Threads, and emerging platforms
12
+ - Content calendar planning, editorial workflows, and content pillar development
13
+ - Audience growth through organic tactics, paid amplification, and collaboration
14
+ - Community management, engagement protocols, and sentiment monitoring
15
+ - Influencer identification, partnership structuring, and campaign execution
16
+ - Social analytics, attribution modeling, and competitive benchmarking
17
+ - Crisis communication, reputation management, and real-time response
18
+
19
+ ### Key Principles
20
+
21
+ 1. **Platform-Native Thinking** - Each platform has its own culture, algorithm, and audience expectations; never cross-post blindly
22
+ 2. **Consistency Over Virality** - Sustainable growth comes from predictable value delivery, not chasing one-off viral moments
23
+ 3. **Community First, Content Second** - A loyal community amplifies average content; great content without community disappears
24
+ 4. **Data-Informed, Not Data-Paralyzed** - Use analytics to guide decisions, but do not let metrics override creative instinct
25
+ 5. **Speed With Judgment** - Social media rewards speed, but one careless post can undo months of trust-building
26
+ 6. **Authenticity Is the Algorithm** - Audiences and algorithms increasingly reward genuine, human-first content over polished corporate messaging
27
+
28
+ ### Core Frameworks
29
+
30
+ | Framework | Purpose |
31
+ |-----------|---------|
32
+ | Platform Fit Matrix | Match content types and goals to the right platform |
33
+ | Content Pillar System | Organize all content around 3-5 recurring strategic themes |
34
+ | Engagement Flywheel | Map the cycle from impression to follower to advocate |
35
+ | Community Health Scorecard | Track sentiment, response time, and engagement quality |
36
+ | Influencer Alignment Grid | Evaluate creator partnerships across brand fit, reach, and authenticity |
37
+ | Social Listening Dashboard | Monitor brand mentions, sentiment trends, and competitive activity |
38
+ | Crisis Response Ladder | Tiered escalation for social media incidents by severity |
39
+ | Content Performance Matrix | Classify content by effort vs. impact to optimize production |
40
+
41
+ ---
42
+
43
+ ## Platform Strategy
44
+
45
+ ### Platform Landscape Overview
46
+
47
+ ```text
48
+ Platform Ecosystem Map
49
+ ├── Visual-First Platforms
50
+ │ ├── Instagram
51
+ │ │ ├── Feed posts (static, carousel)
52
+ │ │ ├── Stories (24h ephemeral)
53
+ │ │ ├── Reels (short video, algorithm-prioritized)
54
+ │ │ └── Broadcast Channels (one-to-many messaging)
55
+ │ ├── TikTok
56
+ │ │ ├── Short-form video (15s-10min)
57
+ │ │ ├── TikTok LIVE (real-time engagement)
58
+ │ │ ├── TikTok Shop (social commerce)
59
+ │ │ └── Series (premium long-form)
60
+ │ └── YouTube
61
+ │ ├── Long-form video (search + subscribe)
62
+ │ ├── Shorts (TikTok competitor, discovery)
63
+ │ ├── Community posts (engagement)
64
+ │ └── Live streams (real-time)
65
+ ├── Text-First Platforms
66
+ │ ├── X (Twitter)
67
+ │ │ ├── Posts (short-form text + media)
68
+ │ │ ├── Threads (multi-post narratives)
69
+ │ │ ├── Spaces (live audio)
70
+ │ │ └── Communities (topic groups)
71
+ │ ├── LinkedIn
72
+ │ │ ├── Text posts (professional insights)
73
+ │ │ ├── Articles (long-form thought leadership)
74
+ │ │ ├── Newsletters (subscriber-based)
75
+ │ │ ├── Video and carousels (growing priority)
76
+ │ │ └── Live events (webinar-style)
77
+ │ └── Threads (Meta)
78
+ │ ├── Text posts (conversation-first)
79
+ │ └── Integrated with Instagram identity
80
+ ├── Community Platforms
81
+ │ ├── Reddit (subreddit culture, authenticity required)
82
+ │ ├── Discord (owned community, real-time)
83
+ │ └── Facebook Groups (topic communities)
84
+ └── Emerging Platforms
85
+ ├── BlueSky (decentralized, early adopter audience)
86
+ ├── Mastodon (federated, niche communities)
87
+ └── Platform-specific evaluation criteria
88
+ ```
89
+
90
+ ### Platform Fit Matrix
91
+
92
+ | Platform | Best For | Content Lifespan | Audience Age Core | Algorithm Priority | Posting Cadence |
93
+ |----------|---------|-----------------|-------------------|-------------------|-----------------|
94
+ | Instagram | Brand storytelling, lifestyle, visual products | 24-48h (feed), 15min (stories) | 18-34 | Reels, engagement rate, saves | 3-5 feed/week, daily stories |
95
+ | TikTok | Discovery, trend participation, authenticity | 2-7 days (can resurface) | 16-30 | Watch time, completion rate, shares | 1-3/day for growth |
96
+ | YouTube | Evergreen education, deep storytelling | Months to years | 18-49 | Watch time, CTR, session time | 1-2 long/week, 3-5 Shorts/week |
97
+ | LinkedIn | B2B thought leadership, hiring, industry authority | 24-72h | 25-54 | Dwell time, comments, relevance | 3-5/week |
98
+ | X | Real-time commentary, news, community dialogue | 15-60 minutes | 25-49 | Recency, engagement velocity, replies | 3-7/day |
99
+ | Threads | Casual conversation, personality, community | 6-24h | 18-35 | Engagement, follows from post | 1-3/day |
100
+ | Reddit | Niche authority, community trust, research | Weeks (search-driven) | 18-40 | Upvotes, comment quality, relevance | As valuable, never spammy |
101
+
102
+ ### Algorithm Optimization Principles
103
+
104
+ ```text
105
+ Universal Algorithm Signals
106
+ ├── Engagement Velocity
107
+ │ ├── How quickly does the post receive interactions after publishing?
108
+ │ ├── First 30-60 minutes are critical on most platforms
109
+ │ └── Strategy: Notify community, post at peak engagement times
110
+ ├── Completion and Dwell Time
111
+ │ ├── Video: Watch-through rate and replay rate
112
+ │ ├── Text: Time spent reading (scroll stop rate)
113
+ │ └── Strategy: Hook in first 3 seconds, deliver value throughout
114
+ ├── Saves and Shares
115
+ │ ├── Saves signal "worth returning to" (high-value signal)
116
+ │ ├── Shares signal "worth showing others" (distribution signal)
117
+ │ └── Strategy: Create reference-worthy and conversation-starting content
118
+ ├── Conversation Depth
119
+ │ ├── Comments with replies weight more than standalone comments
120
+ │ ├── Strategy: Ask specific questions, respond to every comment early
121
+ │ └── Avoid engagement bait that generates shallow interactions
122
+ └── Profile Authority
123
+ ├── Consistent posting history and engagement patterns
124
+ ├── Follower-to-engagement ratio indicates audience quality
125
+ └── Strategy: Maintain regular cadence, build genuine community
126
+ ```
127
+
128
+ ### Cross-Posting Strategy
129
+
130
+ | Approach | When to Use | When to Avoid |
131
+ |----------|------------|---------------|
132
+ | Platform-native creation | Always preferred; content designed for the platform's culture and format | N/A - this is the gold standard |
133
+ | Adapted repurposing | When core idea translates but format needs adjustment (e.g., blog to LinkedIn carousel) | When platform cultures clash (e.g., TikTok humor on LinkedIn) |
134
+ | Direct cross-post | Only for time-sensitive announcements where speed matters more than optimization | For regular content strategy; audiences follow you on multiple platforms and notice |
135
+ | Watermark removal | Always remove platform watermarks when repurposing (e.g., TikTok logo on Reels) | Never post content with another platform's watermark |
136
+
137
+ ---
138
+
139
+ ## Content Strategy
140
+
141
+ ### Content Pillar Framework
142
+
143
+ ```text
144
+ Content Pillar Architecture
145
+ ├── Pillar 1: [Core Expertise / Product Value]
146
+ │ ├── Educational content that demonstrates authority
147
+ │ ├── How-to guides, tutorials, tips
148
+ │ └── Target: 30-40% of content mix
149
+ ├── Pillar 2: [Industry / Culture Commentary]
150
+ │ ├── Trend analysis, news reactions, opinion pieces
151
+ │ ├── Positions the brand within the broader conversation
152
+ │ └── Target: 20-25% of content mix
153
+ ├── Pillar 3: [Community and Behind-the-Scenes]
154
+ │ ├── Team spotlights, process reveals, day-in-the-life
155
+ │ ├── Builds human connection and trust
156
+ │ └── Target: 15-20% of content mix
157
+ ├── Pillar 4: [Social Proof and Results]
158
+ │ ├── Testimonials, case studies, user-generated content
159
+ │ ├── Validates claims with evidence
160
+ │ └── Target: 10-15% of content mix
161
+ └── Pillar 5: [Entertainment and Culture]
162
+ ├── Memes, trends, humor, relatable moments
163
+ ├── Drives shareability and reach
164
+ └── Target: 10-15% of content mix
165
+ ```
166
+
167
+ ### Content Calendar Template
168
+
169
+ ```markdown
170
+ ## Weekly Content Calendar: [Week of MM/DD]
171
+
172
+ ### Monday
173
+ | Platform | Time | Pillar | Format | Topic | Hook | CTA | Assets | Status |
174
+ |----------|------|--------|--------|-------|------|-----|--------|--------|
175
+ | Instagram | 10am | Education | Carousel | | | | | Draft |
176
+ | LinkedIn | 8am | Industry | Text post | | | | | Approved |
177
+ | TikTok | 12pm | Entertainment | Short video | | | | | Filming |
178
+
179
+ ### Tuesday
180
+ | Platform | Time | Pillar | Format | Topic | Hook | CTA | Assets | Status |
181
+ |----------|------|--------|--------|-------|------|-----|--------|--------|
182
+ | X | 9am | Industry | Thread | | | | | Draft |
183
+ | Instagram | 6pm | Community | Story series | | | | | Planned |
184
+
185
+ [Continue for each day...]
186
+
187
+ ### Weekly Metrics Targets
188
+ | Metric | Target | Actual | Delta |
189
+ |--------|--------|--------|-------|
190
+ | Total impressions | | | |
191
+ | Engagement rate | | | |
192
+ | New followers (net) | | | |
193
+ | Link clicks | | | |
194
+ | DMs received | | | |
195
+ ```
196
+
197
+ ### Hook Writing Framework
198
+
199
+ | Hook Type | Structure | Example | Best For |
200
+ |-----------|-----------|---------|----------|
201
+ | Contrarian | Challenge a popular belief | "Most social media advice is wrong. Here's why." | Thought leadership, X, LinkedIn |
202
+ | Curiosity Gap | Tease outcome without revealing | "This one change tripled our engagement rate." | Reels, TikTok, carousels |
203
+ | Direct Value | State the benefit immediately | "5 free tools every social media manager needs" | Educational, YouTube, carousels |
204
+ | Story Open | Start mid-action or with conflict | "We lost 10K followers in one day. Here's what happened." | All platforms, especially video |
205
+ | Question | Ask something the audience is thinking | "Why do some brands blow up on TikTok while others fail?" | X, LinkedIn, community posts |
206
+ | Social Proof | Lead with results or authority | "After managing $2M in ad spend, here's what actually works." | LinkedIn, YouTube |
207
+
208
+ ### Content Format Performance Guide
209
+
210
+ ```text
211
+ Content Effort vs. Impact Matrix
212
+
213
+ High Impact ┌─────────────────────────────────────────┐
214
+ │ │ │
215
+ │ Long-form video │ Viral │
216
+ │ Comprehensive guides │ trend │
217
+ │ Original research │ content │
218
+ │ │ │
219
+ │ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─│─ ─ ─ ─ ─ ─ │
220
+ │ │ │
221
+ │ Carousels │ Memes │
222
+ │ Threads │ Repurposed │
223
+ │ Short video series │ clips │
224
+ │ │ Quick takes │
225
+ Low Impact └─────────────────────────────────────────┘
226
+ High Effort Low Effort
227
+ ```
228
+
229
+ ### Storytelling Framework
230
+
231
+ ```text
232
+ Social Media Story Arc
233
+ ├── Hook (0-3 seconds / first line)
234
+ │ └── Stop the scroll with conflict, curiosity, or emotion
235
+ ├── Context (3-10 seconds / paragraph 1)
236
+ │ └── Set the scene: who, what, why should they care
237
+ ├── Tension (10-30 seconds / body)
238
+ │ └── Present the challenge, struggle, or counterintuitive insight
239
+ ├── Resolution (30-45 seconds / conclusion)
240
+ │ └── Deliver the payoff: lesson, result, transformation
241
+ └── Call to Action (final seconds / last line)
242
+ └── One clear next step: follow, save, comment, click
243
+ ```
244
+
245
+ ---
246
+
247
+ ## Audience Growth
248
+
249
+ ### Organic Growth Engine
250
+
251
+ ```text
252
+ Audience Growth Flywheel
253
+ ┌──────────────┐
254
+ │ Valuable │
255
+ │ Content │
256
+ └──────┬───────┘
257
+
258
+ v
259
+ ┌────────────────────────┐
260
+ │ Algorithm Distribution │
261
+ └────────────┬───────────┘
262
+
263
+ v
264
+ ┌──────────────┐
265
+ │ New Eyeballs │
266
+ └──────┬───────┘
267
+
268
+ v
269
+ ┌────────────────────────┐
270
+ │ Profile Visit + Follow │
271
+ └────────────┬───────────┘
272
+
273
+ v
274
+ ┌──────────────┐
275
+ │ Community │
276
+ │ Engagement │
277
+ └──────┬───────┘
278
+
279
+ v
280
+ ┌────────────────────────┐
281
+ │ Shares + Word of Mouth │
282
+ └────────────┬───────────┘
283
+
284
+ └──────> (back to top)
285
+ ```
286
+
287
+ ### Growth Tactics by Platform
288
+
289
+ | Platform | Top Organic Tactic | Secondary Tactic | Collaboration Approach |
290
+ |----------|-------------------|-----------------|----------------------|
291
+ | Instagram | Reels with trending audio + original spin | Carousel educational content with save-worthy value | Collab posts, joint Lives, Story takeovers |
292
+ | TikTok | Trend participation with brand angle within 24h | Series content that builds return viewership | Duets, Stitches, creator partnerships |
293
+ | YouTube | SEO-optimized titles/thumbnails + high retention | Shorts funnel viewers to long-form | Guest appearances, channel shoutouts |
294
+ | LinkedIn | Consistent text posts with personal stories + insight | Commenting strategy on industry leaders' posts | Co-authored articles, event collaborations |
295
+ | X | Thread expertise + active reply engagement | Spaces hosting on niche topics | Quote-tweet conversations, co-hosted Spaces |
296
+
297
+ ### Hashtag Strategy
298
+
299
+ | Element | Guideline |
300
+ |---------|-----------|
301
+ | Research method | Use platform search, competitor analysis, and tools like the platform's own suggestion features |
302
+ | Mix ratio | 30% broad reach + 40% niche relevant + 30% branded or campaign-specific |
303
+ | Instagram | 5-15 hashtags; test in caption vs. first comment; refresh every 2-4 weeks |
304
+ | TikTok | 3-5 hashtags; prioritize trending + niche; include one branded |
305
+ | LinkedIn | 3-5 hashtags; industry-specific performs best; avoid generic like #motivation |
306
+ | X | 1-2 hashtags maximum; only when joining a specific conversation or event |
307
+ | YouTube | Use as tags and in description; research search volume; include long-tail variations |
308
+ | Avoid | Banned or shadowbanned hashtags, irrelevant trending tags, hashtag walls of 30+ |
309
+
310
+ ### Profile Optimization Checklist
311
+
312
+ ```markdown
313
+ ## Profile Audit: [Platform] - [Account Name]
314
+
315
+ ### Bio / About
316
+ - [ ] Clear value proposition in first line (what you do for whom)
317
+ - [ ] Keywords relevant to your niche included naturally
318
+ - [ ] Call to action (follow for X, link to Y)
319
+ - [ ] Personality or brand voice evident
320
+ - [ ] Contact method or link available
321
+
322
+ ### Visual Identity
323
+ - [ ] Profile photo high quality and recognizable at small sizes
324
+ - [ ] Banner/header image current and on-brand
325
+ - [ ] Highlight covers (Instagram) or featured content consistent
326
+ - [ ] Color palette and visual style cohesive across posts
327
+
328
+ ### Content Grid / Feed
329
+ - [ ] First 9-12 posts represent best content and range
330
+ - [ ] Pinned posts showcase highest-performing or most important content
331
+ - [ ] Content clearly communicates what the account is about
332
+ - [ ] Consistent posting frequency visible
333
+
334
+ ### Technical
335
+ - [ ] Username consistent across platforms (or as close as possible)
336
+ - [ ] Account category/type set correctly (creator, business, etc.)
337
+ - [ ] Link in bio functional and tracked (UTM parameters)
338
+ - [ ] Location and contact info set if relevant
339
+ ```
340
+
341
+ ---
342
+
343
+ ## Community Management
344
+
345
+ ### Response Protocol
346
+
347
+ | Interaction Type | Response Time Target | Response Approach | Escalation Trigger |
348
+ |-----------------|---------------------|-------------------|-------------------|
349
+ | Positive comment | Within 1 hour during business hours | Genuine acknowledgment, ask follow-up question | None |
350
+ | Question | Within 2 hours | Helpful, accurate answer; link to resources if applicable | Complex product/legal questions |
351
+ | Negative feedback | Within 1 hour | Empathetic acknowledgment, take to DM if needed | Repeated complaints, public escalation |
352
+ | Brand mention (positive) | Within 4 hours | Like, comment, reshare if on-brand | None |
353
+ | Brand mention (negative) | Within 1 hour | Assess severity, respond or monitor | Viral potential, factual inaccuracies |
354
+ | Troll / bad faith | Do not engage publicly | Hide or delete per policy; block repeat offenders | Hate speech, threats, doxxing |
355
+ | Influencer mention | Within 30 minutes | Personal, enthusiastic response; explore relationship | None - always prioritize |
356
+ | Customer complaint | Within 30 minutes | Apologize, take to DM, connect to support | Legal issues, safety concerns |
357
+
358
+ ### Sentiment Monitoring Framework
359
+
360
+ ```text
361
+ Sentiment Monitoring System
362
+ ├── Real-Time Monitoring
363
+ │ ├── Brand name mentions (exact and common misspellings)
364
+ │ ├── Product/service name mentions
365
+ │ ├── Key personnel mentions
366
+ │ ├── Campaign hashtag tracking
367
+ │ └── Competitor comparison mentions
368
+ ├── Sentiment Classification
369
+ │ ├── Positive: Praise, recommendations, excitement
370
+ │ ├── Neutral: Questions, observations, sharing without opinion
371
+ │ ├── Negative: Complaints, criticism, frustration
372
+ │ └── Urgent: Threats, viral negativity, crisis indicators
373
+ ├── Trend Analysis
374
+ │ ├── Daily sentiment ratio (positive:neutral:negative)
375
+ │ ├── Week-over-week sentiment shift
376
+ │ ├── Sentiment by platform comparison
377
+ │ └── Sentiment by topic or product area
378
+ └── Escalation Thresholds
379
+ ├── Negative sentiment exceeds 25% of daily mentions
380
+ ├── Single negative post exceeds 100 engagements
381
+ ├── Media outlet or large account amplifies complaint
382
+ └── Multiple unrelated complaints about same issue
383
+ ```
384
+
385
+ ### Moderation Guidelines
386
+
387
+ | Content Type | Action | Visibility |
388
+ |-------------|--------|-----------|
389
+ | Spam / promotional links | Delete, block account | Remove entirely |
390
+ | Profanity (mild, not directed) | Monitor, no action unless violates community guidelines | Leave visible |
391
+ | Hate speech / slurs | Delete immediately, ban user, document | Remove and report to platform |
392
+ | Misinformation about brand | Respond with facts, pin correction if needed | Correct publicly |
393
+ | Off-topic but harmless | Redirect gently or ignore | Leave visible |
394
+ | Competitor promotion | Delete if on owned channels; ignore on public platforms | Platform-dependent |
395
+ | User-generated content | Request permission, credit creator, reshare | Amplify |
396
+
397
+ ### Crisis Communication Protocol
398
+
399
+ ```text
400
+ Crisis Severity Levels
401
+ ├── Level 1: Minor Issue
402
+ │ ├── Single negative post gaining traction
403
+ │ ├── Minor product complaint going public
404
+ │ ├── Response: Community manager handles with approved messaging
405
+ │ └── Timeline: Resolve within 2-4 hours
406
+ ├── Level 2: Moderate Incident
407
+ │ ├── Multiple complaints about same issue
408
+ │ ├── Negative press mention or influencer callout
409
+ │ ├── Response: Social lead + PR coordination
410
+ │ └── Timeline: Initial response within 1 hour, resolution plan within 24h
411
+ ├── Level 3: Serious Crisis
412
+ │ ├── Viral negative content (100K+ views)
413
+ │ ├── Trending hashtag against brand
414
+ │ ├── Response: War room activation, executive briefing, all hands
415
+ │ └── Timeline: Initial response within 30 minutes, hourly updates
416
+ └── Level 4: Brand Emergency
417
+ ├── Safety issue, legal exposure, or existential threat
418
+ ├── Mainstream media coverage of incident
419
+ ├── Response: CEO involvement, legal review all messaging, crisis agency
420
+ └── Timeline: Response within 15 minutes, continuous management
421
+ ```
422
+
423
+ ### Crisis Response Template
424
+
425
+ ```markdown
426
+ ## Crisis Response: [Incident Description]
427
+
428
+ **Severity Level**: [1/2/3/4]
429
+ **Detected**: [Date/Time]
430
+ **Platform(s)**: [Where the crisis is active]
431
+ **Lead Responder**: [Name]
432
+
433
+ ### Immediate Actions
434
+ - [ ] Pause all scheduled content across platforms
435
+ - [ ] Assess scope: how many people affected, how widely shared
436
+ - [ ] Draft initial acknowledgment statement
437
+ - [ ] Get legal review (Level 3+)
438
+ - [ ] Get executive approval (Level 3+)
439
+ - [ ] Post initial response
440
+
441
+ ### Initial Statement Framework
442
+ "We are aware of [situation]. [Empathy statement]. We are [specific action being taken]. We will provide an update by [specific time]."
443
+
444
+ ### Ongoing Management
445
+ - [ ] Monitor sentiment and reach every [30min/1hr/4hr]
446
+ - [ ] Respond to direct questions with approved messaging
447
+ - [ ] Update statement as new information is available
448
+ - [ ] Coordinate with customer support on inbound volume
449
+ - [ ] Document timeline of events and responses
450
+
451
+ ### Post-Crisis Review
452
+ - [ ] Full timeline documented
453
+ - [ ] Root cause identified
454
+ - [ ] Response effectiveness evaluated
455
+ - [ ] Process improvements identified
456
+ - [ ] Team debrief conducted
457
+ ```
458
+
459
+ ---
460
+
461
+ ## Influencer Strategy
462
+
463
+ ### Influencer Tier Classification
464
+
465
+ | Tier | Follower Range | Typical Engagement Rate | Best For | Cost Range |
466
+ |------|---------------|------------------------|----------|-----------|
467
+ | Nano | 1K-10K | 5-10% | Hyper-local, niche communities, authentic UGC | Product gifting, $50-$500 |
468
+ | Micro | 10K-100K | 3-7% | Targeted reach, strong community trust, content creation | $500-$5,000 |
469
+ | Mid-Tier | 100K-500K | 2-5% | Balanced reach and engagement, campaign anchors | $5,000-$25,000 |
470
+ | Macro | 500K-1M | 1-3% | Broad awareness, cultural credibility | $25,000-$100,000 |
471
+ | Mega | 1M+ | 0.5-2% | Mass awareness, cultural moments, brand prestige | $100,000+ |
472
+
473
+ ### Influencer Vetting Checklist
474
+
475
+ ```text
476
+ Influencer Evaluation Framework
477
+ ├── Brand Alignment
478
+ │ ├── Content themes match brand values and audience
479
+ │ ├── Visual aesthetic compatible with brand identity
480
+ │ ├── Past brand partnerships non-conflicting
481
+ │ ├── Personal behavior and public statements vetted
482
+ │ └── Audience demographics match target customer
483
+ ├── Authenticity Signals
484
+ │ ├── Engagement rate healthy for follower count
485
+ │ ├── Comments are genuine (not bot-like or generic)
486
+ │ ├── Follower growth pattern organic (no sudden spikes)
487
+ │ ├── Content quality consistent over 6+ months
488
+ │ └── Creator genuinely uses or would use the product
489
+ ├── Performance Indicators
490
+ │ ├── Average views/impressions per post
491
+ │ ├── Story view rate (Instagram) or completion rate (TikTok)
492
+ │ ├── Click-through rate on past branded content
493
+ │ ├── Conversion history if available
494
+ │ └── Content repurposing potential (can brand reuse assets?)
495
+ └── Red Flags
496
+ ├── Purchased followers (sudden growth spikes, low engagement)
497
+ ├── Controversial past behavior unaligned with brand
498
+ ├── Promotes competing products simultaneously
499
+ ├── History of FTC non-compliance (missing #ad disclosures)
500
+ └── Unreliable or difficult to work with (check references)
501
+ ```
502
+
503
+ ### Partnership Models
504
+
505
+ | Model | Structure | Ownership | Best For |
506
+ |-------|-----------|-----------|----------|
507
+ | Gifted | Product sent, no obligation to post | Creator | Nano/micro seeding, product launches |
508
+ | Sponsored post | Flat fee per deliverable (post, Story, video) | Shared (negotiate usage rights) | Targeted campaigns, awareness |
509
+ | Affiliate | Commission on sales via unique code/link | Creator content, brand tracks | Performance-driven, ongoing |
510
+ | Ambassador | Ongoing relationship, monthly retainer, exclusivity | Shared with extended brand usage | Long-term brand building |
511
+ | Co-creation | Joint product development or content series | Shared or negotiated | Deep integration, premium partnerships |
512
+ | Whitelisting | Brand runs ads through creator's account | Brand controls distribution | Paid amplification of authentic content |
513
+
514
+ ---
515
+
516
+ ## Social Analytics
517
+
518
+ ### Metrics Framework
519
+
520
+ ```text
521
+ Social Metrics Hierarchy
522
+ ├── Awareness Metrics (Top of Funnel)
523
+ │ ├── Impressions: Total times content was displayed
524
+ │ ├── Reach: Unique accounts that saw content
525
+ │ ├── Video views: Platform-specific view thresholds
526
+ │ ├── Share of voice: Brand mentions vs. competitors
527
+ │ └── Follower growth rate: Net new followers / total followers
528
+ ├── Engagement Metrics (Middle of Funnel)
529
+ │ ├── Engagement rate: (Likes + Comments + Shares + Saves) / Reach
530
+ │ ├── Comment rate: Comments / Reach (depth of engagement)
531
+ │ ├── Save rate: Saves / Reach (content value signal)
532
+ │ ├── Share rate: Shares / Reach (distribution potential)
533
+ │ └── Story completion rate: Views on last slide / views on first
534
+ ├── Conversion Metrics (Bottom of Funnel)
535
+ │ ├── Link click-through rate: Clicks / Impressions
536
+ │ ├── Landing page visits from social: UTM-tracked traffic
537
+ │ ├── Lead generation: Form fills, email signups from social
538
+ │ ├── Sales attribution: Revenue from social-referred traffic
539
+ │ └── Cost per acquisition: Ad spend / conversions
540
+ └── Community Health Metrics (Ongoing)
541
+ ├── Sentiment ratio: Positive:Neutral:Negative mentions
542
+ ├── Response time: Average time to first reply
543
+ ├── Conversation rate: DMs and comments per post
544
+ ├── Advocate count: Users who mention brand 3+ times/month
545
+ └── Churn rate: Unfollows / total followers
546
+ ```
547
+
548
+ ### Reporting Cadence
549
+
550
+ | Report | Frequency | Audience | Key Contents |
551
+ |--------|-----------|----------|-------------|
552
+ | Daily Dashboard | Daily | Social team | Engagement snapshot, trending posts, urgent flags |
553
+ | Weekly Performance | Weekly | Marketing team | Content performance, growth trends, top/bottom posts |
554
+ | Monthly Analytics | Monthly | Leadership | KPI progress, channel comparison, competitive benchmarking |
555
+ | Quarterly Strategy Review | Quarterly | Executive team | ROI analysis, strategy effectiveness, next quarter plan |
556
+ | Campaign Post-Mortem | Per campaign | Stakeholders | Campaign results vs. goals, learnings, recommendations |
557
+
558
+ ### Attribution Models
559
+
560
+ | Model | How It Works | Best For |
561
+ |-------|-------------|----------|
562
+ | Last-touch | Credits final social touchpoint before conversion | Direct response campaigns |
563
+ | First-touch | Credits the first social interaction | Top-of-funnel effectiveness |
564
+ | Multi-touch | Distributes credit across all social touchpoints | Full customer journey analysis |
565
+ | Incrementality | Measures lift from social vs. holdout group | Proving true ROI of social investment |
566
+
567
+ ---
568
+
569
+ ## Common Pitfalls
570
+
571
+ ### 1. Cross-Posting Without Adaptation
572
+
573
+ Wrong: Copy-paste the exact same caption, hashtags, and media from Instagram to LinkedIn to X to TikTok.
574
+
575
+ Right: Repurpose the core idea but adapt format, tone, caption length, hashtags, and CTA for each platform's culture and algorithm. A LinkedIn post about the same topic as a TikTok should feel like it belongs on LinkedIn.
576
+
577
+ ### 2. Vanity Metric Obsession
578
+
579
+ Wrong: Celebrate follower count growth while ignoring that engagement rate is declining and zero followers are converting to customers.
580
+
581
+ Right: Track metrics that ladder to business outcomes. A 10K account with 8% engagement and consistent conversions outperforms a 100K account with 0.5% engagement and no conversions.
582
+
583
+ ### 3. Inconsistent Posting With Burst Patterns
584
+
585
+ Wrong: Post five times in one day when inspired, then disappear for two weeks. Repeat.
586
+
587
+ Right: Maintain a sustainable cadence. Three posts per week, every week, for six months will outperform thirty posts in one week followed by silence. Algorithms and audiences reward consistency.
588
+
589
+ ### 4. Ignoring Community Engagement
590
+
591
+ Wrong: Post content and never respond to comments, DMs, or mentions. Treat social media as a broadcast channel.
592
+
593
+ Right: Social media is a conversation. Respond to comments within the first hour. Reply to DMs. Engage with your audience's content. The algorithm rewards accounts that spend time on the platform engaging, not just posting.
594
+
595
+ ### 5. Chasing Every Trend Without Brand Fit
596
+
597
+ Wrong: Jump on every trending audio, meme, and challenge regardless of whether it aligns with your brand voice or audience expectations.
598
+
599
+ Right: Evaluate trends through a brand fit filter. Participate when the trend aligns with your pillars and audience. Skip trends that would feel forced or off-brand. Being selective is more valuable than being everywhere.
600
+
601
+ ### 6. No Crisis Preparation
602
+
603
+ Wrong: Have no plan for when a post goes wrong, a customer complaint goes viral, or the brand is caught in a controversy. Scramble and make it up in real-time.
604
+
605
+ Right: Build crisis response templates, train community managers on escalation protocols, and run tabletop exercises quarterly. The time to prepare for a crisis is before it happens.
606
+
607
+ ### 7. Measuring Everything, Analyzing Nothing
608
+
609
+ Wrong: Export massive spreadsheets of every available metric every week but never derive actionable insights or change strategy based on the data.
610
+
611
+ Right: Focus on 5-7 key metrics aligned with your objectives. Review them weekly with the question: "What should we do differently next week based on this data?" Analytics only matter if they change behavior.
612
+
613
+ ---
614
+
615
+ ## Resources
616
+
617
+ - [Social Media Examiner - Industry Research and Trends](https://www.socialmediaexaminer.com/)
618
+ - [Hootsuite Social Trends Report](https://www.hootsuite.com/research/social-trends)
619
+ - [Sprout Social Index](https://sproutsocial.com/insights/index/)
620
+ - [FTC Endorsement Guides (Influencer Compliance)](https://www.ftc.gov/business-guidance/resources/ftcs-endorsement-guides)
621
+ - [Platform-Specific Creator Resources: Instagram](https://creators.instagram.com/)
622
+ - [Platform-Specific Creator Resources: TikTok](https://www.tiktok.com/creators/)
623
+ - [Buffer State of Social Media Report](https://buffer.com/state-of-social)
624
+ - [Content Marketing Institute - Social Strategy](https://contentmarketinginstitute.com/)
@@ -0,0 +1,59 @@
1
+ ---
2
+ description: Cultural Analysis
3
+ alwaysApply: false
4
+ ---
5
+
6
+ # Cultural Analysis
7
+
8
+ Reading the cultural landscape, mapping tensions, interpreting zeitgeist indicators, and connecting aesthetic shifts to societal origins.
9
+
10
+ ## Core Premise
11
+
12
+ Aesthetic trends are material expressions of cultural forces: economic anxieties, social aspirations, technological disruptions, environmental concerns, political moods. The forecaster reads culture as fluently as color palettes.
13
+
14
+ ## Cultural Tension Framework
15
+
16
+ Culture moves through opposing forces. Trends form where tensions resolve, amplify, or shift.
17
+
18
+ - **Economic**: Austerity ↔ abundance; local craft ↔ global scale; ownership ↔ access economy
19
+ - **Social**: Individualism ↔ collectivism; nostalgia ↔ futurism; maximalism ↔ minimalism; digital immersion ↔ analog revival; performance ↔ authenticity
20
+ - **Environmental**: Growth ↔ sustainability; synthetic ↔ natural; disposability ↔ permanence; speed ↔ slowness
21
+ - **Aesthetic**: Ornament ↔ simplicity; warm ↔ cool palettes; soft forms ↔ sharp geometry; handmade ↔ machine precision
22
+
23
+ ## Zeitgeist Indicators
24
+
25
+ | Domain | Lead Time | What to Watch |
26
+ |--------|-----------|---------------|
27
+ | Contemporary art/galleries | 18-36 months | Exhibition themes, dominant materials, tonal direction |
28
+ | Film and television | 12-18 months | Production design palettes, costume direction |
29
+ | Music and performance | 6-12 months | Stage design, album art, artist styling |
30
+ | Architecture | 3-5 years | Facade materials, spatial concepts, residential trends |
31
+ | Food and hospitality | 6-12 months | Restaurant interiors, plating, packaging |
32
+ | Publishing | 6-18 months | Book cover design, editorial direction, typeface trends |
33
+ | Technology interfaces | Real-time | UI palettes, device materials, spatial computing |
34
+
35
+ ## Subculture Monitoring
36
+
37
+ - Online aesthetic communities (Tumblr, Reddit niches, Discord)
38
+ - Street style in trend-leading cities (Tokyo, Copenhagen, Lagos, Seoul, London)
39
+ - Music scene visual identities (club culture, festival aesthetics)
40
+ - Youth culture visual language development (Gen Z, Gen Alpha)
41
+ - Maker/craft communities (Etsy trends, DIY culture)
42
+
43
+ Observe without disruption. Document subculture aesthetics without premature commercial extraction.
44
+
45
+ ## Geographic Cultural Mapping
46
+
47
+ - **Western Europe**: Luxury, heritage reinterpretation, sustainability
48
+ - **East Asia**: Tech integration, youth innovation, material experimentation
49
+ - **North America**: Consumer data, mass market translation, digital amplification
50
+ - **Africa**: Color boldness, textile innovation, cultural storytelling
51
+ - **South America**: Artisanal craft, organic materiality, chromatic expression
52
+ - **Middle East**: Opulence reinterpretation, architectural scale, heritage-modernity
53
+
54
+ No single geography monopolizes trend origination. Cross-geographic comparison is essential.
55
+
56
+ ## Common Pitfalls
57
+
58
+ - **Surface-level reading**: Map specific tensions to specific aesthetic manifestations — not just "sustainability is trending"
59
+ - **Western-centric framing**: Analyze each market on its own terms; trend origination is polycentric