memory-literary-analysis

Analyze a complete literary work into a structured Basic Memory knowledge graph. Covers schema design, entity seeding, chapter-by-chapter processing, cross-referencing, validation, and visualization.

By basicmachines-co · 521 installs

npx skills add basicmachines-co/basic-memory-skills --skill memory-literary-analysis

Source repository · Upstream listing

Memory Literary Analysis Transform a complete literary work into a structured knowledge graph. Characters, themes, chapters, locations, symbols, and literary devices become interconnected notes — searchable, validatable, and visualizable. When to Use Analyzing a novel, play, poem, or non fiction book end to end Building a teaching or study resource for a literary text Creating a book club companion knowledge base Research projects requiring structured close reading Stress testing Basic Memory at scale (~200+ notes, 1000+ relations) Pipeline Overview Phase 0: Setup Create the Project Use a kebab case slug of the work's title (e.g., great gatsby , hamlet , beloved ). Define Schemas Write 6 schema notes to schema/ . Each schema defines the entity type's fields, observation categories, and relation types. Adapt fields to fit the work — the schemas below are starting points, not rigid templates. Character Schema Add work specific fields as needed — e.g., rank for military fiction, house for family sagas, species for fantasy. Theme Schema Chapter Schema Location Schema Symbol Schema LiteraryDevice Schema Directory Structure Phase 1: Seed Entities Before processing chapters, create stub notes for major entities so [[wiki links]] resolve from the start. Characters (major) For each major character, create a stub with known metadata: Seed Checklist Identify the work's major entities before you start reading. A good starting inventory: Type Typical Count What to Include Characters (major) 8 20 Protagonist, antagonist, key supporting cast Themes 5 12 Central concerns the work explores Locations 4 10 Primary settings, symbolically significant places Symbols 4 10 Recurring objects, images, or motifs with layered meaning Stubs don't need to be complete — they give [[wiki link]] targets and will be enriched during chapter processing. Phase 2: Chapter Processing Source Text Preparation Obtain the full text and identify chapter/section boundaries. For public domain works, Project Gutenberg is a good source. For copyrighted works, work from a physical or licensed digital copy. Batching Strategy Process ~10 chapters per batch to balance depth with progress. Group by narrative arc or thematic focus: Batch Typical Content 1 Opening: setting, character introductions, world building 2 3 Rising action: conflicts established, relationships develop 4 6 Middle: complications, turning points, thematic deepening 7 8 Climax approach: escalation, revelations, crises Final Climax, resolution, epilogue Adjust batch size based on chapter length and density. Short, action heavy chapters can be batched in larger groups; long, philosophically dense chapters may need smaller batches. Per Chapter Workflow For each chapter: 1. Read the chapter carefully. If working from a source text file, read the relevant section. 2. Create the chapter note: 3. Enrich related entities: 4. Track progress using the memory tasks skill to create a processing task that survives context compaction. What to Capture Per Chapter Category What to Look For [summary] 1 2 sentence chapter synopsis [event] Key plot events (actions, revelations, arrivals) [tone] Emotional and stylistic atmosphere [technique] Narrative innovations (POV shifts, structural experiments, genre blending) [quote] Memorable or thematically significant passages [significance] Why this chapter matters to the whole [foreshadowing] Hints at future events Entity Enrichment Per Chapter As each chapter is processed, append observations to relevant entities: Characters : [arc] moments, new [trait] revelations, [quote] attributions Themes : [manifestation] in this chapter, [evolution] shifts Symbols : [appearance] with context, new [interpretation] angles Locations : [atmosphere] as described, [significance] in scene Literary devices : [example] from this chapter Adding Prose and Interpretation After the structured observations are in place, consider adding interpretive prose to major entity notes. Prepend 2 4 paragraphs of critical essay before the Observations section using edit note(operation="prepend") . This prose should: Argue for a reading of the character, theme, or symbol — not just describe it Connect the entity to the work's larger concerns and to literary tradition Include subjective opinions clearly marked as such ("In my reading...", "I find...") Ground claims in textual evidence cited by chapter number The prose adds the interpretive texture that structured observations alone cannot capture. Phase 3: Cross Referencing After all chapters are processed: Character Arcs For each major character, write a full [arc] summary observation covering their trajectory across the work. Theme Evolution For each theme, add [evolution] observations tracing how it develops from introduction to resolution. Chapter Parallels Add parallels and contrasts with relations between structurally similar chapters (e.g., mirrored scenes, repeated settings, thematic echoes). Analysis Notes Create synthesis notes in analysis/ : Recommended analysis notes: Narrative Structure — overall architecture and pacing Work Overview — synthesis of the complete work (summary, thesis, legacy) Critical Reception — historical and contemporary interpretations Discover Emergent Entities During chapter processing, new minor characters, locations, and symbols will emerge. Create notes for any that appear in 3+ chapters or carry thematic weight. Phase 4: Validation Schema Validation Drift Detection Fix issues found — common fixes: Missing required observation categories → add them via edit note Enum values outside allowed set → correct metadata Fields in notes but not schema → add as optional to schema if legitimate Relation Consistency Spot check bidirectional relations: if Chapter X features [[Character]] , does Character have observations referencing Chapter X? Fix gaps. Phase 5: Visualization Generate canvas files for visual exploration: Adapting to Other Genres This pipeline works for any literary text. Adjust schemas for genre: Genre Schema Adjustments Novel Base schemas work as is; add genre specific Character fields as needed Play Add Act and Scene schemas; Character gets speaking lines field Poetry collection Replace Chapter with Poem ; add form , meter , rhyme scheme fields Non fiction Replace Chapter with Section ; add Argument , Evidence schemas Short story collection Add Story schema with narrator , setting , word count Epic/myth Add Deity , Prophecy schemas; Location gets mythological significance Memoir Character schema gets relationship to narrator ; add Memory schema Scaling Guidance Work Length Batch Size Estimated Notes Novella (~40K words) 5 10 chapters ~50 80 Novel (~80K words) 8 12 chapters ~100 150 Long novel (~200K+ words) 10 15 chapters ~200 300 Series (multiple volumes) 1 volume at a time ~200+ per volume Related Skills memory schema — Schema creation, validation, and drift detection memory tasks — Track chapter processing progress across context compaction memory notes — Note writing patterns, observation categories, wiki links memory ingest — Processing external input into structured entities memory metadata search — Querying notes by frontmatter fields memory lifecycle — Archiving completed analysis phases Guidelines Seed before processing. Create entity stubs first so wiki links resolve immediately during chapter processing. Batch for sanity. Processing ~10 chapters at a time balances depth with momentum. Track progress with a Task note. Read the source text. Don't rely on memory or summaries. Read (or re read) the actual text for each batch before creating notes. Textual evidence is everything. Observations are your index. The knowledge graph's value comes from categorized observations. Be generous with categories and specific with content. Relations are your web. Every chapter should link to characters, themes, locations, and devices. Every entity should link back to chapters where it appears. Enrich iteratively. Entity notes grow richer with each chapter. Don't try to write the perfect character note upfront — append as you go. Add prose for depth. After structured data is in place, add interpretive essays to major notes. The prose captures what observations cannot: argument, nuance, opinion, and voice. Validate periodically. Run schema validate after each batch, not just at the end. Catch drift early. Quote generously. Literary analysis lives on textual evidence. Include significant quotes as [quote] observations with chapter attribution. Review and revise. After completing all chapters, review the full graph from an external perspective. Look for thin notes, missing connections, and gaps in coverage. The first pass is never the last. Analysis comes last. Synthesis notes in analysis/ should be written after all chapters are processed, when you have the full picture.