Understanding Insights by node

Insights is an analysis tool that reads your writing and shows you patterns, structures, and connections you might not have noticed. It's not a grammar checker. It's closer to a structural X-ray of your story. ## What analysis does When you run analysis on a work, the AI reads the entire text and generates embeddings — mathematical representations of meaning. It then maps these embeddings to identify: - **Character presence:** Where characters appear and disappear across your text. You might discover your protagonist vanishes for three chapters without you realizing it. - **Pacing patterns:** Where the writing speeds up or slows down. Clusters of short sentences (tension) vs. long passages (reflection). Shifts you intended and shifts you didn't. - **Thematic threads:** Ideas, images, or motifs that recur. The AI spots these even when you haven't been tracking them consciously. "Water imagery appears in every scene with Elena" — useful to know whether you planned it or not. - **Dialogue distribution:** Who speaks, how much, and where. If one character dominates the dialogue in a section where they shouldn't, insights will show it. - **Scene structure:** How scenes connect, where transitions happen, where the narrative shifts register. ## What embeddings look at Embeddings are a way of representing text as numbers that capture meaning. When the AI creates embeddings of your paragraphs, similar paragraphs end up near each other mathematically. This lets the system see connections: a passage about grief in chapter one is "close to" a passage about loss in chapter seven, even if different words are used. This matters because it means the analysis is semantic, not just lexical. It's not searching for repeated words. It's finding repeated meanings. Two passages can be connected even if they share no vocabulary. ## Why it matters for a writer You know your story from the inside. You know what you intended. Insights shows you what's actually on the page, which is sometimes different. Examples of what you might discover: - Your protagonist disappears from the narrative for three chapters. You didn't notice because you were focused on the subplot. The reader would notice. - Your dialogue pacing shifts dramatically in act two. Scenes that were conversation-heavy become action-heavy. This might be intentional. It might not. Now you know. - A secondary character's emotional arc mirrors the main plot in a way you didn't plan. This is a gift. Build on it. - The first and last scenes share structural echoes you didn't intend. Another gift. Strengthen the echo. ## How to trigger analysis Open a work in the editor. Click the insights icon in the toolbar. The analysis runs — this takes 10-30 seconds depending on the length of your work. Results appear as colored overlays on your text. ## When to use insights Not every draft. Insights are most useful on completed sections — a finished chapter, a complete act, a polished short story. Running analysis on a rough first draft gives you rough results. The tool is designed for revision, not drafting.