Best Practices
- 1Always specify atom_family (HOOK/CAPTION/CTA/CAROUSEL_SLIDE) and platform target
- 2Source-cite every atom row — include the brand, topic, and locale in the JSONL row
- 3Run dedup check before committing: copy-through rate must stay below 50%
- 4Atoms go to SOURCE_OF_TRUTH/social_media_atoms/*.jsonl — never ad-hoc files
- 5For CJK atoms, route to the locale agents — Pearl_Social_Writer is EN only
CLI Examples
# Author hook atoms act as pearl_social_writer — author 10 HOOK atoms for way_stream_sanctuary × burnout, en-US, TikTok # CTA batch pearl_social_writer: write 5 CTA atoms for devotion_path × grief, Instagram, en-US # Carousel slide copy pearl_social_writer: write 6 CAROUSEL_SLIDE atoms for Pearl Prime launch, LinkedIn, en-US # Dedup check before commit python3 scripts/social/check_atom_dedup.py --locale en_US --max-dup-rate 0.50
Do Not Use For
- Live publishing or scheduling — atom bank rows only
- Platform strategy — that's Pearl_Social
- CJK authoring — route to Pearl_Locale_ZH_CN, JA, KO etc.