How laladim/newsletter-icm-workbook works
Newsletter ICM Workbook is a file-based guided workflow for designing and operating a newsletter with human approval gates and a local-first edition process. A person or small team uses the discovery material, optionally with a coding agent, to approve a brief and publication profile, then creates and works through a nine-stage edition. The README documents research, editorial, visual, delivery, and learning capabilities; the stage templates define their handoffs. Sampled scripts show stamping and verification, but most stage execution is documented as a human/agent workflow rather than application code.
Main entry points: stamp.py Workspace stamper · publication-brief.md Publication brief · publications Approved publication · editions Edition records
Components 22
Discovery and profile
- Discovery workbook
NEW-NEWSLETTER-DISCOVERY.md - Workspace setup
SETUP.md - Publication brief
_templates/publication/publication-brief.md - Publication contracts
_templates/publication - Approved publication
publications
Edition workflow
- Intake
_templates/edition/01_intake - Source selection
_templates/edition/02_source-selection - Research and verification
_templates/edition/03_research - Editorial routing
_templates/edition/04_routing - Newsletter draft
_templates/edition/05_draft - Quality and risk review
_templates/edition/06_quality-review - Visuals and packaging
_templates/edition/07_package - Delivery and preview
_templates/edition/08_delivery - Post-publish learning
_templates/edition/09_post-publish - Edition records
editions
Generation and checks
- Workspace stamper
scripts/stamp.py - Profile verifier
scripts/verify-publication.py - Edition verifier
scripts/verify-edition.py
Sanitized example
- Beyond Banks example
examples/beyond-banks
Other components
- Publisher / team
- Coding agent
- Publishing platform
Connections 25
- Publisher / team → Discovery workbook: answers prompts
- Publisher / team → Workspace setup: starts workspace
- Coding agent → Discovery workbook: guides interview
- Coding agent → Publication brief: drafts brief
- Publisher / team → Publication brief: approves brief
- Publication brief → Workspace stamper: provides brief
- Workspace stamper → Publication contracts: renders contracts
- Workspace stamper → Profile verifier: runs verification
- Profile verifier → Approved publication: checks profile
- Publisher / team → Approved publication: approves profile
- Approved publication → Workspace stamper: authorizes edition
- Workspace stamper → Intake: stamps stages
- Intake → Source selection: hands off
- Source selection → Research and verification: hands off
- Research and verification → Editorial routing: hands off
- Editorial routing → Newsletter draft: hands off
- Newsletter draft → Quality and risk review: hands off
- Quality and risk review → Visuals and packaging: hands off
- Visuals and packaging → Delivery and preview: hands off
- Delivery and preview → Post-publish learning: hands off
- Post-publish learning → Edition records: records learning
- Edition verifier → Edition records: checks receipts
- Edition records → Publisher / team: presents local output
- Publisher / team → Publishing platform: may authorize pilot
- Beyond Banks example → Publisher / team: illustrates transformation