blast-studio 0.0.0-stage → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (255) hide show
  1. package/LICENSE +202 -0
  2. package/README.md +138 -2
  3. package/bin/bstudio.mjs +13 -0
  4. package/dist/agent-env.js +152 -0
  5. package/dist/brief.js +53 -0
  6. package/dist/budget/ledger.js +153 -0
  7. package/dist/campaign-zip.js +93 -0
  8. package/dist/cli.js +118 -0
  9. package/dist/commands/accept.js +64 -0
  10. package/dist/commands/auth.js +77 -0
  11. package/dist/commands/brief.js +117 -0
  12. package/dist/commands/budget.js +22 -0
  13. package/dist/commands/dashboard.js +9 -0
  14. package/dist/commands/doctor.js +57 -0
  15. package/dist/commands/export.js +42 -0
  16. package/dist/commands/init.js +24 -0
  17. package/dist/commands/install-skills.js +52 -0
  18. package/dist/commands/library.js +12 -0
  19. package/dist/commands/make.js +71 -0
  20. package/dist/commands/mark.js +44 -0
  21. package/dist/commands/new.js +25 -0
  22. package/dist/commands/plan.js +57 -0
  23. package/dist/commands/render-preview.js +43 -0
  24. package/dist/commands/render.js +243 -0
  25. package/dist/commands/review.js +119 -0
  26. package/dist/commands/revise.js +73 -0
  27. package/dist/commands/sources.js +33 -0
  28. package/dist/commands/status.js +34 -0
  29. package/dist/config.js +141 -0
  30. package/dist/dashboard/server.js +171 -0
  31. package/dist/dashboard/static/app.css +1 -0
  32. package/dist/dashboard/static/app.js +52 -0
  33. package/dist/dashboard/static/index.html +8 -0
  34. package/dist/env.js +47 -0
  35. package/dist/export.js +110 -0
  36. package/dist/fetch-text.js +64 -0
  37. package/dist/io.js +1 -0
  38. package/dist/keychain.js +41 -0
  39. package/dist/library.js +49 -0
  40. package/dist/packs.js +91 -0
  41. package/dist/plan.js +75 -0
  42. package/dist/posts.js +40 -0
  43. package/dist/providers/images.js +116 -0
  44. package/dist/providers/voice.js +55 -0
  45. package/dist/render/ffmpeg.js +96 -0
  46. package/dist/render/metrics.js +109 -0
  47. package/dist/render/stills.js +172 -0
  48. package/dist/render/template.js +20 -0
  49. package/dist/render/video.js +173 -0
  50. package/dist/review/gates.js +201 -0
  51. package/dist/review/reviewer.js +79 -0
  52. package/dist/review/score.js +21 -0
  53. package/dist/review/slop.js +17 -0
  54. package/dist/review-hash.js +21 -0
  55. package/dist/types.js +29 -0
  56. package/dist/updater/check.js +140 -0
  57. package/dist/updater/propose.js +144 -0
  58. package/dist/workspace.js +142 -0
  59. package/package.json +45 -4
  60. package/platforms/bluesky/guide.md +94 -0
  61. package/platforms/bluesky/pack.yml +150 -0
  62. package/platforms/dailydev/guide.md +82 -0
  63. package/platforms/dailydev/pack.yml +152 -0
  64. package/platforms/devto/guide.md +93 -0
  65. package/platforms/devto/pack.yml +119 -0
  66. package/platforms/gist/guide.md +92 -0
  67. package/platforms/gist/pack.yml +119 -0
  68. package/platforms/github-discussion/guide.md +92 -0
  69. package/platforms/github-discussion/pack.yml +122 -0
  70. package/platforms/hashnode/guide.md +93 -0
  71. package/platforms/hashnode/pack.yml +124 -0
  72. package/platforms/hn/guide.md +48 -0
  73. package/platforms/hn/pack.yml +59 -0
  74. package/platforms/instagram/guide.md +95 -0
  75. package/platforms/instagram/pack.yml +136 -0
  76. package/platforms/lemmy/guide.md +88 -0
  77. package/platforms/lemmy/pack.yml +141 -0
  78. package/platforms/linkedin/guide.md +93 -0
  79. package/platforms/linkedin/pack.yml +145 -0
  80. package/platforms/mastodon/guide.md +92 -0
  81. package/platforms/mastodon/pack.yml +138 -0
  82. package/platforms/medium/guide.md +92 -0
  83. package/platforms/medium/pack.yml +119 -0
  84. package/platforms/newsletter/guide.md +94 -0
  85. package/platforms/newsletter/pack.yml +144 -0
  86. package/platforms/producthunt/guide.md +92 -0
  87. package/platforms/producthunt/pack.yml +166 -0
  88. package/platforms/reddit/guide.md +92 -0
  89. package/platforms/reddit/pack.yml +151 -0
  90. package/platforms/snapshots/.gitkeep +0 -0
  91. package/platforms/snapshots/bluesky-10.sha256 +1 -0
  92. package/platforms/snapshots/bluesky-10.txt +1 -0
  93. package/platforms/snapshots/bluesky-11.sha256 +1 -0
  94. package/platforms/snapshots/bluesky-11.txt +1 -0
  95. package/platforms/snapshots/bluesky-12.sha256 +1 -0
  96. package/platforms/snapshots/bluesky-12.txt +1 -0
  97. package/platforms/snapshots/bluesky-13.sha256 +1 -0
  98. package/platforms/snapshots/bluesky-13.txt +1 -0
  99. package/platforms/snapshots/bluesky-14.sha256 +1 -0
  100. package/platforms/snapshots/bluesky-14.txt +1 -0
  101. package/platforms/snapshots/cross-platform-63.sha256 +1 -0
  102. package/platforms/snapshots/cross-platform-63.txt +1 -0
  103. package/platforms/snapshots/cross-platform-64.sha256 +1 -0
  104. package/platforms/snapshots/cross-platform-64.txt +1 -0
  105. package/platforms/snapshots/dailydev-55.sha256 +1 -0
  106. package/platforms/snapshots/dailydev-55.txt +1 -0
  107. package/platforms/snapshots/dailydev-56.sha256 +1 -0
  108. package/platforms/snapshots/dailydev-56.txt +1 -0
  109. package/platforms/snapshots/dailydev-57.sha256 +1 -0
  110. package/platforms/snapshots/dailydev-57.txt +1 -0
  111. package/platforms/snapshots/devto-26.sha256 +1 -0
  112. package/platforms/snapshots/devto-26.txt +1 -0
  113. package/platforms/snapshots/devto-27.sha256 +1 -0
  114. package/platforms/snapshots/devto-27.txt +1 -0
  115. package/platforms/snapshots/devto-28.sha256 +1 -0
  116. package/platforms/snapshots/devto-28.txt +1 -0
  117. package/platforms/snapshots/devto-29.sha256 +1 -0
  118. package/platforms/snapshots/devto-29.txt +1 -0
  119. package/platforms/snapshots/gist-52.sha256 +1 -0
  120. package/platforms/snapshots/gist-52.txt +1 -0
  121. package/platforms/snapshots/gist-53.sha256 +1 -0
  122. package/platforms/snapshots/gist-53.txt +1 -0
  123. package/platforms/snapshots/gist-54.sha256 +1 -0
  124. package/platforms/snapshots/gist-54.txt +1 -0
  125. package/platforms/snapshots/github-discussion-policy.sha256 +1 -0
  126. package/platforms/snapshots/github-discussion-policy.txt +1 -0
  127. package/platforms/snapshots/hashnode-30.sha256 +1 -0
  128. package/platforms/snapshots/hashnode-30.txt +1 -0
  129. package/platforms/snapshots/hashnode-31.sha256 +1 -0
  130. package/platforms/snapshots/hashnode-31.txt +1 -0
  131. package/platforms/snapshots/hashnode-32.sha256 +1 -0
  132. package/platforms/snapshots/hashnode-32.txt +1 -0
  133. package/platforms/snapshots/hn-23.sha256 +1 -0
  134. package/platforms/snapshots/hn-23.txt +1 -0
  135. package/platforms/snapshots/hn-24.sha256 +1 -0
  136. package/platforms/snapshots/hn-24.txt +1 -0
  137. package/platforms/snapshots/hn-25.sha256 +1 -0
  138. package/platforms/snapshots/hn-25.txt +1 -0
  139. package/platforms/snapshots/hyperframes-releases.sha256 +1 -0
  140. package/platforms/snapshots/hyperframes-releases.txt +1 -0
  141. package/platforms/snapshots/instagram-43.sha256 +1 -0
  142. package/platforms/snapshots/instagram-43.txt +1 -0
  143. package/platforms/snapshots/instagram-47.sha256 +1 -0
  144. package/platforms/snapshots/instagram-47.txt +1 -0
  145. package/platforms/snapshots/lemmy-policy.sha256 +1 -0
  146. package/platforms/snapshots/lemmy-policy.txt +1 -0
  147. package/platforms/snapshots/linkedin-1.sha256 +1 -0
  148. package/platforms/snapshots/linkedin-1.txt +1 -0
  149. package/platforms/snapshots/linkedin-2.sha256 +1 -0
  150. package/platforms/snapshots/linkedin-2.txt +1 -0
  151. package/platforms/snapshots/linkedin-3.sha256 +1 -0
  152. package/platforms/snapshots/linkedin-3.txt +1 -0
  153. package/platforms/snapshots/linkedin-4.sha256 +1 -0
  154. package/platforms/snapshots/linkedin-4.txt +1 -0
  155. package/platforms/snapshots/mastodon-15.sha256 +1 -0
  156. package/platforms/snapshots/mastodon-15.txt +1 -0
  157. package/platforms/snapshots/mastodon-16.sha256 +1 -0
  158. package/platforms/snapshots/mastodon-16.txt +1 -0
  159. package/platforms/snapshots/mastodon-17.sha256 +1 -0
  160. package/platforms/snapshots/mastodon-17.txt +1 -0
  161. package/platforms/snapshots/medium-34.sha256 +1 -0
  162. package/platforms/snapshots/medium-34.txt +1 -0
  163. package/platforms/snapshots/medium-35.sha256 +1 -0
  164. package/platforms/snapshots/medium-35.txt +1 -0
  165. package/platforms/snapshots/medium-36.sha256 +1 -0
  166. package/platforms/snapshots/medium-36.txt +1 -0
  167. package/platforms/snapshots/newsletter-58.sha256 +1 -0
  168. package/platforms/snapshots/newsletter-58.txt +1 -0
  169. package/platforms/snapshots/newsletter-59.sha256 +1 -0
  170. package/platforms/snapshots/newsletter-59.txt +1 -0
  171. package/platforms/snapshots/newsletter-60.sha256 +1 -0
  172. package/platforms/snapshots/newsletter-60.txt +1 -0
  173. package/platforms/snapshots/newsletter-61.sha256 +1 -0
  174. package/platforms/snapshots/newsletter-61.txt +1 -0
  175. package/platforms/snapshots/newsletter-62.sha256 +1 -0
  176. package/platforms/snapshots/newsletter-62.txt +1 -0
  177. package/platforms/snapshots/openai-image-pricing.sha256 +1 -0
  178. package/platforms/snapshots/openai-image-pricing.txt +1 -0
  179. package/platforms/snapshots/playwright-releases.sha256 +1 -0
  180. package/platforms/snapshots/playwright-releases.txt +1 -0
  181. package/platforms/snapshots/producthunt-37.sha256 +1 -0
  182. package/platforms/snapshots/producthunt-37.txt +1 -0
  183. package/platforms/snapshots/producthunt-38.sha256 +1 -0
  184. package/platforms/snapshots/producthunt-38.txt +1 -0
  185. package/platforms/snapshots/producthunt-39.sha256 +1 -0
  186. package/platforms/snapshots/producthunt-39.txt +1 -0
  187. package/platforms/snapshots/reddit-20.sha256 +1 -0
  188. package/platforms/snapshots/reddit-20.txt +1 -0
  189. package/platforms/snapshots/reddit-21.sha256 +1 -0
  190. package/platforms/snapshots/reddit-21.txt +1 -0
  191. package/platforms/snapshots/reddit-22.sha256 +1 -0
  192. package/platforms/snapshots/reddit-22.txt +1 -0
  193. package/platforms/snapshots/substack-policy.sha256 +1 -0
  194. package/platforms/snapshots/substack-policy.txt +1 -0
  195. package/platforms/snapshots/threads-18.sha256 +1 -0
  196. package/platforms/snapshots/threads-18.txt +1 -0
  197. package/platforms/snapshots/threads-19.sha256 +1 -0
  198. package/platforms/snapshots/threads-19.txt +1 -0
  199. package/platforms/snapshots/tiktok-50.sha256 +1 -0
  200. package/platforms/snapshots/tiktok-50.txt +1 -0
  201. package/platforms/snapshots/tiktok-51.sha256 +1 -0
  202. package/platforms/snapshots/tiktok-51.txt +1 -0
  203. package/platforms/snapshots/x-5.sha256 +1 -0
  204. package/platforms/snapshots/x-5.txt +1 -0
  205. package/platforms/snapshots/x-6.sha256 +1 -0
  206. package/platforms/snapshots/x-6.txt +1 -0
  207. package/platforms/snapshots/x-7.sha256 +1 -0
  208. package/platforms/snapshots/x-7.txt +1 -0
  209. package/platforms/snapshots/x-8.sha256 +1 -0
  210. package/platforms/snapshots/x-8.txt +1 -0
  211. package/platforms/snapshots/x-9.sha256 +1 -0
  212. package/platforms/snapshots/x-9.txt +1 -0
  213. package/platforms/snapshots/youtube-shorts-40.sha256 +1 -0
  214. package/platforms/snapshots/youtube-shorts-40.txt +1 -0
  215. package/platforms/snapshots/youtube-shorts-41.sha256 +1 -0
  216. package/platforms/snapshots/youtube-shorts-41.txt +1 -0
  217. package/platforms/snapshots/youtube-shorts-42.sha256 +1 -0
  218. package/platforms/snapshots/youtube-shorts-42.txt +1 -0
  219. package/platforms/sources.yml +947 -0
  220. package/platforms/substack/guide.md +94 -0
  221. package/platforms/substack/pack.yml +116 -0
  222. package/platforms/threads/guide.md +93 -0
  223. package/platforms/threads/pack.yml +148 -0
  224. package/platforms/tiktok/guide.md +92 -0
  225. package/platforms/tiktok/pack.yml +129 -0
  226. package/platforms/x/guide.md +94 -0
  227. package/platforms/x/pack.yml +130 -0
  228. package/platforms/youtube-shorts/guide.md +92 -0
  229. package/platforms/youtube-shorts/pack.yml +138 -0
  230. package/providers/prices.yml +31 -0
  231. package/schemas/campaign.v2.json +26 -0
  232. package/schemas/manifest.v1.json +37 -0
  233. package/schemas/pack.schema.json +601 -0
  234. package/schemas/review.schema.json +31 -0
  235. package/skills/studio-reviewer/SKILL.md +13 -0
  236. package/skills/studio-updater/SKILL.md +8 -0
  237. package/skills/studio-video/SKILL.md +20 -0
  238. package/skills/studio-visual/SKILL.md +12 -0
  239. package/skills/studio-writer/SKILL.md +14 -0
  240. package/templates/README.md +7 -0
  241. package/templates/card.html +1 -0
  242. package/templates/carousel-closing.html +1 -0
  243. package/templates/carousel-content.html +1 -0
  244. package/templates/carousel-title.html +1 -0
  245. package/templates/code.html +1 -0
  246. package/templates/fonts/IBM-Plex-OFL.txt +93 -0
  247. package/templates/fonts/IBMPlexMono.woff2 +0 -0
  248. package/templates/fonts/IBMPlexSans.woff2 +0 -0
  249. package/templates/fonts/Space-Grotesk-OFL.txt +93 -0
  250. package/templates/fonts/SpaceGrotesk.woff2 +0 -0
  251. package/templates/poster.html +1 -0
  252. package/templates/quote.html +1 -0
  253. package/templates/thumbnail.html +1 -0
  254. package/test/fixtures/reviews/calibration.json +22 -0
  255. package/test/fixtures/reviews/grounding/cases.json +17 -0
@@ -0,0 +1,94 @@
1
+ # Newsletters
2
+
3
+ ## Who reads it
4
+
5
+ [JUDGEMENT] Write for subscribers to a specific author or publication. Identify the actual reader and their situation, not a generic “everyone”.
6
+
7
+ ## How distribution works
8
+
9
+ There is no single platform or feed algorithm for newsletters; distribution may be direct email or an independent editor's selection. [Gmail sender requirements](https://support.google.com/mail/answer/81126?hl=en) address authentication, spam rate and bulk unsubscribe, not guaranteed inbox placement. [Buttondown](https://buttondown.com/legal/acceptable-use-policy) requires double opt-in and rejects primarily machine-generated prose/images. [Substack](https://support.substack.com/hc/en-us/articles/50891130623508-How-can-I-detect-AI-on-Substack) offers estimated AI detection on eligible web posts, not proof or a rule covering all email. Publication-specific submissions and AI rules **[UNVERIFIED]**; choose the actual editor. See [Cooperpress](https://cooperpress.com/submit/) and [Changelog News](https://changelog.com/news/submit) for distinct editorial routes.
10
+
11
+ [JUDGEMENT] Treat distribution as context, not a formula. No hook or format guarantees reach.
12
+
13
+ ## Formats that work here
14
+
15
+ [JUDGEMENT] Choose the smallest format that can carry the evidence:
16
+
17
+ - Article: address a specific reader question with an example, source and practical implication.
18
+
19
+ - Email: choose a subject that accurately reflects the article; follow the selected publication’s requirements.
20
+
21
+ - Image and text limits are publication-specific or unknown; describe visuals and check provider rules.
22
+
23
+ Check `pack.yml` for sourced limits and explicit unknowns; verify the live route and account.
24
+
25
+ ## Hooks
26
+
27
+ [JUDGEMENT] The examples are hypothetical hook patterns, not claims; use them only when supported by actual evidence.
28
+
29
+ - **Problem first:** identify the recurring problem and who it affects.
30
+ Hypothetical example: “A stale CI cache kept our release pipeline failing after the lockfile changed.”
31
+
32
+ - **Unexpected constraint:** lead with the specific constraint uncovered during a production incident lesson.
33
+ Hypothetical example: “Our migration had to run while both old and new application versions were live.”
34
+
35
+ - **Before and after:** lead with the observed state before and after a production incident lesson, if supported.
36
+ Hypothetical example: “The test failed with the old schema; after the migration it passed against the new one.”
37
+
38
+ - **Decision tradeoff:** lead with the alternative considered during a production incident lesson and its cost.
39
+ Hypothetical example: “We chose a reversible database migration over a shorter but irreversible script.”
40
+
41
+ - **Reproduction:** lead with the smallest reproducible input behind a production incident lesson.
42
+ Hypothetical example: “This five-line test reproduces the timeout when the connection pool has one slot.”
43
+
44
+ - **Practical lesson:** lead with the action another developer can take after a production incident lesson.
45
+ Hypothetical example: “Before changing a cache key, include the dependency lockfile in the key inputs.”
46
+
47
+ Banned patterns: clickbait that withholds the subject, fake urgency, and engagement bait asking for votes or empty replies.
48
+
49
+ ## Structure template
50
+
51
+ [JUDGEMENT] Fill in only details supported by the source material:
52
+
53
+ - Audience and situation: [who encounters the problem, where]
54
+ - Specific problem or observation: [what happened]
55
+ - Evidence: [primary link, reproduction or verified example]
56
+ - Action and result: [what changed and what was observed]
57
+ - Takeaway or open question: [useful implication, without hype]
58
+ - Required affiliation, rights and disclosure: [checks]
59
+
60
+ ## Visual and video recipes
61
+
62
+ [JUDGEMENT] Use visuals to make the actual lesson easier to understand, not as decorative proof.
63
+
64
+ - Image or diagram: label the subject and flow; keep mobile text legible and provide meaningful alt text.
65
+ - Carousel where supported: topic → context → one step per slide → observed result → concise takeaway.
66
+ - Video where supported: 0–3 s subject, 3–15 s demonstration, then the result and context; adapt timings to the material, not an alleged platform optimum.
67
+ - Captions: accurately transcribe speech, synchronize with audio and keep text clear of interface overlays.
68
+ - Inspect output, rights and the pack’s route-specific limits; do not infer unknown values.
69
+
70
+ ## Anti-patterns
71
+
72
+ - Do not treat an AI detector estimate as proof of authorship or an email-wide rule.
73
+ - Do not invent metrics, testimonials, first-person experience or a guaranteed reach outcome.
74
+ - Avoid generic superlatives, duplicated points and context-free screenshots.
75
+
76
+ ## AI and disclosure
77
+
78
+ Check the specific publication and provider policy; Substack’s detector is an estimate for eligible web posts, not an email-wide ban.
79
+
80
+ ## Checklist
81
+
82
+ - [ ] The intended reader and supported takeaway are identifiable.
83
+ - [ ] Claims link to evidence; uncertainties and limitations remain visible.
84
+ - [ ] Actual route, account, community rules and pack limits were checked.
85
+ - [ ] Images have relevant alternatives and spoken media has accurate captions.
86
+ - [ ] Authorship, affiliation, rights and applicable disclosure were checked.
87
+
88
+ ## Sources
89
+
90
+ - [AI policy / opt-in](https://buttondown.com/legal/acceptable-use-policy)
91
+ - [AI policy / detector scope](https://support.substack.com/hc/en-us/articles/50891130623508-How-can-I-detect-AI-on-Substack)
92
+ - [delivery / authentication and unsubscribe](https://support.google.com/mail/answer/81126?hl=en)
93
+ - [community rules / editorial submission](https://cooperpress.com/submit/)
94
+ - [community rules / editorial submission](https://changelog.com/news/submit)
@@ -0,0 +1,116 @@
1
+ {
2
+ "id": "substack",
3
+ "name": "Newsletters",
4
+ "marketBlaster": "substack",
5
+ "ai": "draft",
6
+ "aiSource": "substack-policy",
7
+ "formats": [
8
+ "article",
9
+ "image"
10
+ ],
11
+ "textLimit": "unknown",
12
+ "titleLimit": "unknown",
13
+ "media": [],
14
+ "disclosure": {
15
+ "text": "unknown",
16
+ "media": "unknown",
17
+ "voice": "unknown"
18
+ },
19
+ "rubric": [
20
+ {
21
+ "id": "hook",
22
+ "question": "Does the subject or opening name the specific lesson?",
23
+ "anchors": {
24
+ "0": "The opening has no identifiable subject or result.",
25
+ "1": "A subject appears, but the problem or outcome is vague or delayed.",
26
+ "2": "The opening identifies the subject and a concrete problem or outcome."
27
+ }
28
+ },
29
+ {
30
+ "id": "audience-fit",
31
+ "question": "Does the piece speak to the publication’s actual subscribers?",
32
+ "anchors": {
33
+ "0": "No intended reader or relevant situation is identifiable.",
34
+ "1": "A reader group or situation is hinted at but not connected to the content.",
35
+ "2": "The intended reader and relevant situation are explicit."
36
+ }
37
+ },
38
+ {
39
+ "id": "simplicity",
40
+ "question": "Does the article separate the event, evidence and takeaway?",
41
+ "anchors": {
42
+ "0": "The reader cannot reconstruct the main point or sequence.",
43
+ "1": "The main point is present but key context or ordering is missing.",
44
+ "2": "The main point and necessary steps are clear and ordered."
45
+ }
46
+ },
47
+ {
48
+ "id": "anti-slop",
49
+ "question": "Are inflated launch language and generic filler absent?",
50
+ "anchors": {
51
+ "0": "The candidate relies on hype, fabricated urgency or unsupported claims.",
52
+ "1": "Some concrete substance is present but generic or inflated language remains.",
53
+ "2": "Concrete language replaces hype and claims are supported."
54
+ }
55
+ },
56
+ {
57
+ "id": "platform-fit",
58
+ "question": "Does the piece follow the selected publication and provider policies?",
59
+ "anchors": {
60
+ "0": "The candidate ignores the destination’s format or community rules.",
61
+ "1": "The format or community is identified but a relevant rule or constraint remains unchecked.",
62
+ "2": "The format and relevant destination rules are checked and followed."
63
+ }
64
+ },
65
+ {
66
+ "id": "visual-quality",
67
+ "question": "Are images readable and described, with captions for video?",
68
+ "anchors": {
69
+ "0": "The visual is unreadable or lacks its relevant alternative or captions.",
70
+ "1": "The visual is partly readable or an alternative or caption is incomplete.",
71
+ "2": "Key content is readable and relevant alternatives or accurate captions are present."
72
+ },
73
+ "appliesTo": [
74
+ "image",
75
+ "carousel",
76
+ "poster",
77
+ "video",
78
+ "diagram",
79
+ "logo",
80
+ "terminal-demo"
81
+ ]
82
+ },
83
+ {
84
+ "id": "value",
85
+ "question": "Is the argument supported by a primary link or first-hand evidence?",
86
+ "anchors": {
87
+ "0": "No supported takeaway or useful example is identifiable.",
88
+ "1": "A takeaway is present but its evidence or practical detail is incomplete.",
89
+ "2": "A specific takeaway is supported by a concrete example or source."
90
+ }
91
+ },
92
+ {
93
+ "id": "publication-policy",
94
+ "question": "Were the actual publication’s submission and AI policies checked?",
95
+ "anchors": {
96
+ "0": "The applicable publication policy is violated or not identified.",
97
+ "1": "The publication is named but its submission or AI policy remains unchecked.",
98
+ "2": "The named publication’s current submission and AI policy is checked."
99
+ }
100
+ }
101
+ ],
102
+ "sources": [
103
+ "substack-policy",
104
+ "newsletter-58",
105
+ "newsletter-59",
106
+ "newsletter-60",
107
+ "newsletter-61",
108
+ "newsletter-62",
109
+ "cross-platform-63",
110
+ "cross-platform-64"
111
+ ],
112
+ "notes": [
113
+ "[JUDGEMENT] Rubric scores are editorial aids, not predictions of reach.",
114
+ "Check actual account, route, community and current requirements before publication."
115
+ ]
116
+ }
@@ -0,0 +1,93 @@
1
+ # Threads
2
+
3
+ ## Who reads it
4
+
5
+ [JUDGEMENT] Write for people joining a specific technical conversation. Identify the actual reader and their situation, not a generic “everyone”.
6
+
7
+ ## How distribution works
8
+
9
+ Meta reports conversation-driving posts are more likely to be recommended; its aggregate observations about replies and text with media are not randomized causal estimates. [Meta creator guidance](https://about.fb.com/news/2024/10/find-your-community-with-new-threads-educational-insights/). Text, images, video and carousels are supported; placement of external links and universal hashtag uplift **[UNVERIFIED]**. See API-only media limits and Meta disclosure below.
10
+
11
+ [JUDGEMENT] Treat distribution as context, not a formula. No hook or format guarantees reach.
12
+
13
+ ## Formats that work here
14
+
15
+ [JUDGEMENT] Choose the smallest format that can carry the evidence:
16
+
17
+ - Text: share one observation and an on-topic question, not a demand for replies.
18
+
19
+ - Carousel: sequence observation, example and implication; API media limits in the pack are not guaranteed app limits.
20
+
21
+ - Video: show a concrete step and result; captions should carry the spoken content.
22
+
23
+ Check `pack.yml` for sourced limits and explicit unknowns; verify the live route and account.
24
+
25
+ ## Hooks
26
+
27
+ [JUDGEMENT] The examples are hypothetical hook patterns, not claims; use them only when supported by actual evidence.
28
+
29
+ - **Problem first:** identify the recurring problem and who it affects.
30
+ Hypothetical example: “A stale CI cache kept our release pipeline failing after the lockfile changed.”
31
+
32
+ - **Unexpected constraint:** lead with the specific constraint uncovered during a release decision.
33
+ Hypothetical example: “Our migration had to run while both old and new application versions were live.”
34
+
35
+ - **Before and after:** lead with the observed state before and after a release decision, if supported.
36
+ Hypothetical example: “The test failed with the old schema; after the migration it passed against the new one.”
37
+
38
+ - **Decision tradeoff:** lead with the alternative considered during a release decision and its cost.
39
+ Hypothetical example: “We chose a reversible database migration over a shorter but irreversible script.”
40
+
41
+ - **Reproduction:** lead with the smallest reproducible input behind a release decision.
42
+ Hypothetical example: “This five-line test reproduces the timeout when the connection pool has one slot.”
43
+
44
+ - **Practical lesson:** lead with the action another developer can take after a release decision.
45
+ Hypothetical example: “Before changing a cache key, include the dependency lockfile in the key inputs.”
46
+
47
+ Banned patterns: clickbait that withholds the subject, fake urgency, and engagement bait asking for votes or empty replies.
48
+
49
+ ## Structure template
50
+
51
+ [JUDGEMENT] Fill in only details supported by the source material:
52
+
53
+ - Audience and situation: [who encounters the problem, where]
54
+ - Specific problem or observation: [what happened]
55
+ - Evidence: [primary link, reproduction or verified example]
56
+ - Action and result: [what changed and what was observed]
57
+ - Takeaway or open question: [useful implication, without hype]
58
+ - Required affiliation, rights and disclosure: [checks]
59
+
60
+ ## Visual and video recipes
61
+
62
+ [JUDGEMENT] Use visuals to make the actual lesson easier to understand, not as decorative proof.
63
+
64
+ - Image or diagram: label the subject and flow; keep mobile text legible and provide meaningful alt text.
65
+ - Carousel where supported: topic → context → one step per slide → observed result → concise takeaway.
66
+ - Video where supported: 0–3 s subject, 3–15 s demonstration, then the result and context; adapt timings to the material, not an alleged platform optimum.
67
+ - Captions: accurately transcribe speech, synchronize with audio and keep text clear of interface overlays.
68
+ - Inspect output, rights and the pack’s route-specific limits; do not infer unknown values.
69
+
70
+ ## Anti-patterns
71
+
72
+ - Do not use engagement bait or present API-only limits as app rules.
73
+ - Do not invent metrics, testimonials, first-person experience or a guaranteed reach outcome.
74
+ - Avoid generic superlatives, duplicated points and context-free screenshots.
75
+
76
+ ## AI and disclosure
77
+
78
+ Check Meta AI info labels and applicable paid-partnership disclosure; exact universal self-disclosure scope is unverified.
79
+
80
+ ## Checklist
81
+
82
+ - [ ] The intended reader and supported takeaway are identifiable.
83
+ - [ ] Claims link to evidence; uncertainties and limitations remain visible.
84
+ - [ ] Actual route, account, community rules and pack limits were checked.
85
+ - [ ] Images have relevant alternatives and spoken media has accurate captions.
86
+ - [ ] Authorship, affiliation, rights and applicable disclosure were checked.
87
+
88
+ ## Sources
89
+
90
+ - [algorithm / creator guidance](https://about.fb.com/news/2024/10/find-your-community-with-new-threads-educational-insights/)
91
+ - [specs / API and AI labeling](https://developers.facebook.com/documentation/threads/posts)
92
+ - [AI policy / labeling](https://about.fb.com/news/2024/04/metas-approach-to-labeling-ai-generated-content-and-manipulated-media/)
93
+ - [community rules / branded content](https://help.instagram.com/2467529163409127)
@@ -0,0 +1,148 @@
1
+ {
2
+ "id": "threads",
3
+ "name": "Threads",
4
+ "marketBlaster": "threads",
5
+ "ai": "draft",
6
+ "aiSource": "instagram-47",
7
+ "safeZones": { "video": "unknown", "image": "unknown" },
8
+ "formats": [
9
+ "text",
10
+ "image",
11
+ "carousel",
12
+ "video"
13
+ ],
14
+ "textLimit": {
15
+ "value": 500,
16
+ "source": "threads-19"
17
+ },
18
+ "titleLimit": "unknown",
19
+ "media": [
20
+ {
21
+ "kind": "image",
22
+ "maxBytes": {
23
+ "value": 8000000,
24
+ "source": "threads-19"
25
+ },
26
+ "maxCount": {
27
+ "value": 20,
28
+ "source": "threads-19"
29
+ }
30
+ },
31
+ {
32
+ "kind": "video",
33
+ "maxBytes": {
34
+ "value": 1000000000,
35
+ "source": "threads-19"
36
+ },
37
+ "maxSeconds": {
38
+ "value": 300,
39
+ "source": "threads-19"
40
+ }
41
+ }
42
+ ],
43
+ "disclosure": {
44
+ "text": "unknown",
45
+ "media": {
46
+ "rule": "Check Meta AI info labels where required.",
47
+ "source": "instagram-47"
48
+ },
49
+ "voice": "unknown"
50
+ },
51
+ "sponsorship": { "rule": "Disclose branded content with the paid partnership label where required.", "source": "instagram-48" },
52
+ "rubric": [
53
+ {
54
+ "id": "hook",
55
+ "question": "Does the first line contain a concrete observation rather than a vague teaser?",
56
+ "anchors": {
57
+ "0": "The opening has no identifiable subject or result.",
58
+ "1": "A subject appears, but the problem or outcome is vague or delayed.",
59
+ "2": "The opening identifies the subject and a concrete problem or outcome."
60
+ }
61
+ },
62
+ {
63
+ "id": "audience-fit",
64
+ "question": "Does the observation invite the people affected by the problem into the discussion?",
65
+ "anchors": {
66
+ "0": "No intended reader or relevant situation is identifiable.",
67
+ "1": "A reader group or situation is hinted at but not connected to the content.",
68
+ "2": "The intended reader and relevant situation are explicit."
69
+ }
70
+ },
71
+ {
72
+ "id": "simplicity",
73
+ "question": "Can the observation and its context be understood in one pass?",
74
+ "anchors": {
75
+ "0": "The reader cannot reconstruct the main point or sequence.",
76
+ "1": "The main point is present but key context or ordering is missing.",
77
+ "2": "The main point and necessary steps are clear and ordered."
78
+ }
79
+ },
80
+ {
81
+ "id": "anti-slop",
82
+ "question": "Does the prompt avoid manufactured controversy or engagement bait?",
83
+ "anchors": {
84
+ "0": "The candidate relies on hype, fabricated urgency or unsupported claims.",
85
+ "1": "Some concrete substance is present but generic or inflated language remains.",
86
+ "2": "Concrete language replaces hype and claims are supported."
87
+ }
88
+ },
89
+ {
90
+ "id": "platform-fit",
91
+ "question": "Is any invitation to respond relevant to the observation and within channel limits?",
92
+ "anchors": {
93
+ "0": "The candidate ignores the destination’s format or community rules.",
94
+ "1": "The format or community is identified but a relevant rule or constraint remains unchecked.",
95
+ "2": "The format and relevant destination rules are checked and followed."
96
+ }
97
+ },
98
+ {
99
+ "id": "visual-quality",
100
+ "question": "Does visual media preserve readable context and include alternatives or captions?",
101
+ "anchors": {
102
+ "0": "The visual is unreadable or lacks its relevant alternative or captions.",
103
+ "1": "The visual is partly readable or an alternative or caption is incomplete.",
104
+ "2": "Key content is readable and relevant alternatives or accurate captions are present."
105
+ },
106
+ "appliesTo": [
107
+ "image",
108
+ "carousel",
109
+ "poster",
110
+ "video",
111
+ "diagram",
112
+ "logo",
113
+ "terminal-demo"
114
+ ]
115
+ },
116
+ {
117
+ "id": "value",
118
+ "question": "Is the observation supported by a specific example?",
119
+ "anchors": {
120
+ "0": "No supported takeaway or useful example is identifiable.",
121
+ "1": "A takeaway is present but its evidence or practical detail is incomplete.",
122
+ "2": "A specific takeaway is supported by a concrete example or source."
123
+ }
124
+ },
125
+ {
126
+ "id": "relationship-label",
127
+ "question": "Were applicable partnership and AI labels checked?",
128
+ "anchors": {
129
+ "0": "A required label is omitted.",
130
+ "1": "The relevant relationship or AI labeling condition is identified but unresolved.",
131
+ "2": "Applicable relationship and AI label conditions were checked and met."
132
+ }
133
+ }
134
+ ],
135
+ "sources": [
136
+ "threads-18",
137
+ "threads-19",
138
+ "instagram-47",
139
+ "instagram-48",
140
+ "cross-platform-63",
141
+ "cross-platform-64"
142
+ ],
143
+ "notes": [
144
+ "[JUDGEMENT] Rubric scores are editorial aids, not predictions of reach.",
145
+ "Check actual account, route, community and current requirements before publication.",
146
+ "Media limits are API-specific, not necessarily app limits."
147
+ ]
148
+ }
@@ -0,0 +1,92 @@
1
+ # TikTok
2
+
3
+ ## Who reads it
4
+
5
+ [JUDGEMENT] Write for mobile viewers watching an original demonstration. Identify the actual reader and their situation, not a generic “everyone”.
6
+
7
+ ## How distribution works
8
+
9
+ Recommendations use interactions such as full watches, skips, likes, shares and comments, alongside content information and search relevance. [TikTok](https://support.tiktok.com/en/using-tiktok/exploring-videos/how-tiktok-recommends-content). Unoriginal reused media without creative changes can be ineligible for For You; realistic synthetic or significantly edited people/scenes require labeling. [Integrity policy](https://www.tiktok.com/community-guidelines/en/integrity-authenticity). A magic duration or hashtag set is **[UNVERIFIED]**.
10
+
11
+ [JUDGEMENT] Treat distribution as context, not a formula. No hook or format guarantees reach.
12
+
13
+ ## Formats that work here
14
+
15
+ [JUDGEMENT] Choose the smallest format that can carry the evidence:
16
+
17
+ - Video: show the technical subject immediately, demonstrate a single action and show the result.
18
+
19
+ - Trim dead time without concealing the steps; caption speech accurately and label applicable realistic synthetic media.
20
+
21
+ - The pack’s video limits describe the Content Posting API route, not necessarily the app.
22
+
23
+ Check `pack.yml` for sourced limits and explicit unknowns; verify the live route and account.
24
+
25
+ ## Hooks
26
+
27
+ [JUDGEMENT] The examples are hypothetical hook patterns, not claims; use them only when supported by actual evidence.
28
+
29
+ - **Problem first:** identify the recurring problem and who it affects.
30
+ Hypothetical example: “A stale CI cache kept our release pipeline failing after the lockfile changed.”
31
+
32
+ - **Unexpected constraint:** lead with the specific constraint uncovered during a terminal debugging step.
33
+ Hypothetical example: “Our migration had to run while both old and new application versions were live.”
34
+
35
+ - **Before and after:** lead with the observed state before and after a terminal debugging step, if supported.
36
+ Hypothetical example: “The test failed with the old schema; after the migration it passed against the new one.”
37
+
38
+ - **Decision tradeoff:** lead with the alternative considered during a terminal debugging step and its cost.
39
+ Hypothetical example: “We chose a reversible database migration over a shorter but irreversible script.”
40
+
41
+ - **Reproduction:** lead with the smallest reproducible input behind a terminal debugging step.
42
+ Hypothetical example: “This five-line test reproduces the timeout when the connection pool has one slot.”
43
+
44
+ - **Practical lesson:** lead with the action another developer can take after a terminal debugging step.
45
+ Hypothetical example: “Before changing a cache key, include the dependency lockfile in the key inputs.”
46
+
47
+ Banned patterns: clickbait that withholds the subject, fake urgency, and engagement bait asking for votes or empty replies.
48
+
49
+ ## Structure template
50
+
51
+ [JUDGEMENT] Fill in only details supported by the source material:
52
+
53
+ - Audience and situation: [who encounters the problem, where]
54
+ - Specific problem or observation: [what happened]
55
+ - Evidence: [primary link, reproduction or verified example]
56
+ - Action and result: [what changed and what was observed]
57
+ - Takeaway or open question: [useful implication, without hype]
58
+ - Required affiliation, rights and disclosure: [checks]
59
+
60
+ ## Visual and video recipes
61
+
62
+ [JUDGEMENT] Use visuals to make the actual lesson easier to understand, not as decorative proof.
63
+
64
+ - Image or diagram: label the subject and flow; keep mobile text legible and provide meaningful alt text.
65
+ - Carousel where supported: topic → context → one step per slide → observed result → concise takeaway.
66
+ - Video where supported: 0–3 s subject, 3–15 s demonstration, then the result and context; adapt timings to the material, not an alleged platform optimum.
67
+ - Captions: accurately transcribe speech, synchronize with audio and keep text clear of interface overlays.
68
+ - Inspect output, rights and the pack’s route-specific limits; do not infer unknown values.
69
+
70
+ ## Anti-patterns
71
+
72
+ - Do not reuse unoriginal media without creative changes or omit required synthetic-media labels.
73
+ - Do not invent metrics, testimonials, first-person experience or a guaranteed reach outcome.
74
+ - Avoid generic superlatives, duplicated points and context-free screenshots.
75
+
76
+ ## AI and disclosure
77
+
78
+ Label realistic-looking AI-generated or significantly edited people or scenes and check commercial disclosure.
79
+
80
+ ## Checklist
81
+
82
+ - [ ] The intended reader and supported takeaway are identifiable.
83
+ - [ ] Claims link to evidence; uncertainties and limitations remain visible.
84
+ - [ ] Actual route, account, community rules and pack limits were checked.
85
+ - [ ] Images have relevant alternatives and spoken media has accurate captions.
86
+ - [ ] Authorship, affiliation, rights and applicable disclosure were checked.
87
+
88
+ ## Sources
89
+
90
+ - [algorithm / recommendations](https://support.tiktok.com/en/using-tiktok/exploring-videos/how-tiktok-recommends-content)
91
+ - [specs / API video](https://developers.tiktok.com/docs/en/content-posting-api-media-transfer-guide)
92
+ - [AI policy / unoriginal media](https://www.tiktok.com/community-guidelines/en/integrity-authenticity)
@@ -0,0 +1,129 @@
1
+ {
2
+ "id": "tiktok",
3
+ "name": "TikTok",
4
+ "marketBlaster": null,
5
+ "ai": "draft",
6
+ "aiSource": "tiktok-51",
7
+ "safeZones": { "video": "unknown", "image": "unknown" },
8
+ "formats": [
9
+ "video"
10
+ ],
11
+ "textLimit": "unknown",
12
+ "titleLimit": "unknown",
13
+ "media": [
14
+ {
15
+ "kind": "video",
16
+ "maxBytes": {
17
+ "value": 4000000000,
18
+ "source": "tiktok-50"
19
+ },
20
+ "maxSeconds": {
21
+ "value": 600,
22
+ "source": "tiktok-50"
23
+ }
24
+ }
25
+ ],
26
+ "disclosure": {
27
+ "text": "unknown",
28
+ "media": {
29
+ "rule": "Label realistic-looking AI-generated or significantly edited people or scenes.",
30
+ "source": "tiktok-51"
31
+ },
32
+ "voice": "unknown"
33
+ },
34
+ "rubric": [
35
+ {
36
+ "id": "hook",
37
+ "question": "Does the subject appear in the opening seconds?",
38
+ "anchors": {
39
+ "0": "The opening has no identifiable subject or result.",
40
+ "1": "A subject appears, but the problem or outcome is vague or delayed.",
41
+ "2": "The opening identifies the subject and a concrete problem or outcome."
42
+ }
43
+ },
44
+ {
45
+ "id": "audience-fit",
46
+ "question": "Is the demonstrated problem relevant to the intended technical viewer?",
47
+ "anchors": {
48
+ "0": "No intended reader or relevant situation is identifiable.",
49
+ "1": "A reader group or situation is hinted at but not connected to the content.",
50
+ "2": "The intended reader and relevant situation are explicit."
51
+ }
52
+ },
53
+ {
54
+ "id": "simplicity",
55
+ "question": "Does the edit remove dead time without hiding essential steps?",
56
+ "anchors": {
57
+ "0": "The reader cannot reconstruct the main point or sequence.",
58
+ "1": "The main point is present but key context or ordering is missing.",
59
+ "2": "The main point and necessary steps are clear and ordered."
60
+ }
61
+ },
62
+ {
63
+ "id": "anti-slop",
64
+ "question": "Are exaggerated claims, misleading scenes and engagement bait absent?",
65
+ "anchors": {
66
+ "0": "The candidate relies on hype, fabricated urgency or unsupported claims.",
67
+ "1": "Some concrete substance is present but generic or inflated language remains.",
68
+ "2": "Concrete language replaces hype and claims are supported."
69
+ }
70
+ },
71
+ {
72
+ "id": "platform-fit",
73
+ "question": "Is the demonstration original and within the actual posting route limits?",
74
+ "anchors": {
75
+ "0": "The candidate ignores the destination’s format or community rules.",
76
+ "1": "The format or community is identified but a relevant rule or constraint remains unchecked.",
77
+ "2": "The format and relevant destination rules are checked and followed."
78
+ }
79
+ },
80
+ {
81
+ "id": "visual-quality",
82
+ "question": "Are spoken details captioned accurately and key UI elements readable?",
83
+ "anchors": {
84
+ "0": "The visual is unreadable or lacks its relevant alternative or captions.",
85
+ "1": "The visual is partly readable or an alternative or caption is incomplete.",
86
+ "2": "Key content is readable and relevant alternatives or accurate captions are present."
87
+ },
88
+ "appliesTo": [
89
+ "image",
90
+ "carousel",
91
+ "poster",
92
+ "video",
93
+ "diagram",
94
+ "logo",
95
+ "terminal-demo"
96
+ ]
97
+ },
98
+ {
99
+ "id": "value",
100
+ "question": "Does the video demonstrate a supported outcome?",
101
+ "anchors": {
102
+ "0": "No supported takeaway or useful example is identifiable.",
103
+ "1": "A takeaway is present but its evidence or practical detail is incomplete.",
104
+ "2": "A specific takeaway is supported by a concrete example or source."
105
+ }
106
+ },
107
+ {
108
+ "id": "synthetic-media",
109
+ "question": "Were realistic synthetic scenes and commercial disclosures checked?",
110
+ "anchors": {
111
+ "0": "Realistic synthetic media needing a label is unlabeled.",
112
+ "1": "Synthetic or commercial content is identified but its disclosure status is unresolved.",
113
+ "2": "Applicable synthetic-media and commercial labels are checked and present."
114
+ }
115
+ }
116
+ ],
117
+ "sources": [
118
+ "tiktok-49",
119
+ "tiktok-50",
120
+ "tiktok-51",
121
+ "cross-platform-63",
122
+ "cross-platform-64"
123
+ ],
124
+ "notes": [
125
+ "[JUDGEMENT] Rubric scores are editorial aids, not predictions of reach.",
126
+ "Check actual account, route, community and current requirements before publication.",
127
+ "Media limits are API-specific, not necessarily app limits."
128
+ ]
129
+ }