/nai-newsletter — the monthly issue

%%{init: {'theme':'neutral', 'flowchart':{'htmlLabels':false,'nodeSpacing':45,'rankSpacing':55}}}%%
flowchart TD
    H["You type /nai-newsletter"] --> C
    C["/nai-newsletter<br/>two-wave research,<br/>then hands off to the writer"]

    C -->|"first run only"| V["voice-profiler<br/>learns how you write"]
    V --> P["07 Newsletter/voice-profile.md<br/>you then edit it by hand,<br/>never regenerated"]

    C -->|"Wave 1: what happened?"| S["tech-radar (scan)<br/>one line per item"]
    S -.->|"quiet month?<br/>STOP - never pad"| Q["report quiet,<br/>write no issue"]
    C -->|"Wave 2: the best 2-3,<br/>in parallel"| D["tech-radar (on-demand)<br/>a full cited brief each"]

    D --> R["07 Newsletter/&lt;period&gt;/research.md<br/>every claim has a source URL"]
    C -->|"passes the period only,<br/>not the research"| W["newsletter-writer<br/>NO web tools"]
    R -.->|"reads from disk"| W
    P -.->|"reads from disk"| W
    W ==> OUT["issue.md + issue.html<br/>you paste it - nothing is sent"]

    classDef orch fill:#dcefe9,stroke:#0f6f63,stroke-width:2px
    classDef human fill:#fdf3e0,stroke:#8a5a00,stroke-width:2px
    classDef file fill:#f4f1ea,stroke:#8a7a5a
    class C orch
    class H,OUT,Q human
    class P,R file