Musewoods · GroveThe Musewoods Field Manual

Publishing Fields

Musewoods publishes through four fields. They are not themes layered over one generic page model; each field owns a clear editorial purpose, content root, normalization boundary, validation contract, and renderer. What they share is platform infrastructure: global navigation, the Palette, common parsing primitives, the chart engine, and deliberately shared motif families.

The field decision should be made from the job the work must do. Stories tell by carrying a reader through a narrative argument. Journals examine through durable long-form prose and editorial annotation. Viewgraphs reveal through a fixed visual frame and presentation rhythm. Groves grow by turning a bounded body of work into a navigable place with its own identity and local structure.

Clearing, the Navigation System, and Resonance deliberately sit outside that choice. Clearing can assemble typed meaning and context across all four fields without owning the canonical editorial work. Trailheads can author journeys across the same fields, and Venture Trailmaps can represent the innovation field in which canonical objects, derived Waymarkers, evidence, contradictions, Trails, and Horizons relate. Resonance can circulate selected journeys and maintain explicit Follow relationships without turning circulation into another field root. These are system-layer responsibilities placed across the published objects below rather than additional publishing fields.

The Fields

Stories

Stories are for narrative-led argument. Content lives in content/stories/ as one Markdown source per route, parsed through parseStoryboard, normalized against the Story motif registry, and rendered through the Story presentation system. Local navigation is authored through the contents motif and numbered movement spine, which the build validates one-to-one so the visible structure cannot drift from the document. A Story may also choose the governed page-level Ground soil or forest-floor through the metadata section; this is the same shared Ground vocabulary used by Groves, applied at the Story root rather than as a per-section theme.

Story is the current author-facing content form. Storyboard survives in parser and implementation names; it is not a second form that authors choose.

Journals

Journals are portable long-form Markdown with a deliberately small editorial marker layer. Content lives under content/journals/** with YAML frontmatter; parseMarkdownDocument preserves the document's native prose structure, while promoteJournalEditorialBlocks turns supported > [!marker] declarations into structured editorial blocks. Journals therefore remain prose-first rather than borrowing the Story motif grammar wholesale. The exact runtime forms are essay, fieldnote, photo-journal, and photo-essay; omission defaults to essay. Journal Ground is independently authored as soil or forest-floor and defaults to soil.

Viewgraphs

Viewgraphs are visual arguments composed on a fixed logical frame. Content lives under content/viewgraphs/**; the source is parsed structurally and then normalized into the Viewgraph vocabulary of frame renders, layouts, media, data primitives, and presentation controls. Desktop preserves the fixed logical frame through viewer scaling, while smaller screens use a reading-oriented reflow rather than simply shrinking the frame until it becomes illegible.

Groves

A Grove is a bounded, navigable, living body of knowledge inside Musewoods — it may hold work ranging from tentative to mature. Each Grove owns a directory under content/groves/<slug>/, a required manifest.yaml, one or more Markdown pages, and any local images or authored artifacts it needs. The Grove runtime resolves identity, navigation, visibility, Ground, assets, and motifs as one local publishing contract. This Field Manual is itself a Grove, which is why the field can document its own runtime from inside it.

What Is Not A Fifth Field

clearing-layer

The Clearing design proposes typed relationships among canonical objects and subject-centered context without taking ownership of the Story, Journal, Viewgraph, or Grove itself. A durable Clearing can be projected through a Grove, but its semantic layer is not added to the field capability matrix. See Clearing System.

resonance-layer

content/resonance/ contains circulation sources and lib/resonance/ owns typed references, Path, Trailhead projections, Follow, bounded signals, and related stores. Resonance does not enter MUSEWOODS_NAV_LINKS, and its runtime should never require a Story, Journal, Viewgraph, or Grove to migrate into a new content model.

trailhead-navigation

A v2 Trailhead composes typed Encounters, transitions, routes, and relationships without taking ownership of the canonical Stories, Journals, Viewgraphs, and Groves it references. The v1 Resonance edition remains a compatibility and circulation lane, but the current Trailhead concept belongs to the Navigation System rather than becoming a fifth publishing field. See Trailheads.

trailmap-navigation

A Trailmap stores graph-native innovation semantics — Regions, Nodes, Waymarkers, Edges, Trails, Horizons, provenance, and projection hints — while the renderer owns woodland geometry and Explorer interaction. It is not a Story, Journal, Viewgraph, Grove, or visual sitemap. See Venture Trailmaps.

See Each Field, Live

The specimens below are not screenshots of another implementation. Each uses the production parser and renderer for the field it represents, which makes the comparison useful both editorially and as a regression surface. The point is not that the four fields should look alike; it is that the same underlying platform discipline should remain visible through four different editorial jobs.

Stories Tell — Live

Purpose

An opening paragraph that can carry a drop cap — a Story setting a scene.

Authoring

### Intro
**Render:** lede
The opening paragraph of an act can take a drop cap.

Live Result

The opening paragraph of an act can take a drop cap. A lede is ordinary prose with that one typographic difference, used where an act wants a formal beginning rather than a running start.

Contract & Implementation

Renders as ordinary prose with one typographic difference; no required fields.

  • lib/render/motifs.mjs
  • components/render/Motifs.tsx

Journals Examine — Live

Purpose

A `[!highlight]` callout — the Journal pausing to mark one passage as worth a second look.

Authoring

> [!highlight]
> A short passage the Journal wants the reader to notice.

Live Result

Contract & Implementation

Wraps ordinary prose/list content; no required fields beyond the marker itself.

  • lib/journal/sidecars.mjs
  • components/render/ContentBlocks.tsx

Viewgraphs Reveal — Live

Developer Guide

Viewgraphs reveal

A viewgraph is the atomic visual unit. The word "slide" is not part of the Musewoods vocabulary.

© Musewoods Press01 / 06

The Field Manual's own Viewgraph specimen, reused frame by frame. The reel embeds the canonical Viewgraph frame rather than the Viewgraph application shell, so the surrounding Grove Ground stops at the viewport and the Viewgraph remains the source of record.

Groves Grow — Live

Live specimen infrastructure

active

live-specimen is an internal Field Manual capability that re-parses an authored fixture through the production normalizer and renders the result through the shared component path. It exists to prevent examples from becoming decorative documentation that no longer matches what the platform actually renders. Its **Implementation:** line is human-readable source provenance, not a runtime dependency: rendering a specimen never requires those files to be present, so the same page serves correctly from a traced deployment bundle. Whether the referenced paths still exist is checked separately by content:check, where the full repository is guaranteed.

Field Capability Matrix

The field choice, at a glance
Field Capability Matrix — 4 rows by 4 columns.
fullfullabsentfull
fullfullabsentfull
fullfullpartialfull
absentfullfullfull
fullpartialabsent

This Matrix intentionally has four columns. Clearing, Navigation, and Resonance are cross-field system layers, not additional publishing fields; the detailed field contract follows below.

The Contract, Field by Field

ConcernStoriesJournalsViewgraphsGroves
Container manifestnone (a metadata section)musewoods.journal.manifest/v1musewoods.viewgraphs.manifest/v1per-Grove kind: grove + field musewoods.groves.manifest/v1
Visibilitydirect route only; no indexstatus + visibility: listed|unlistedvisibility: listed|unlistedvisibility: listed|unlisted (default listed)
Local navigationcontents + movement spinefront door + article breadcrumbsection controlsmanifest navigation: list, optionally grouped
Chartshost story, inline|widehost journal, numbered Figureshost viewgraph, default|hero|interpretationhost grove, inline|wide
Shared editorial motifsyesyes (as [!marker])noyes
Analytical primitivesyesyes (as [!marker])no, by intentyes
Groundsoil | forest-floor on Story metadatasoil | forest-floor in frontmatterPalette + per-viewgraph surfacesoil | forest-floor in Grove manifest

One Parsing Substrate, Four Field Models

Musewoods shares parsing infrastructure without pretending that every field is the same document. Stories, Viewgraphs, and Groves use the Storyboard parser as their structural entry point and then normalize into different models. Journals use the more permissive Markdown-document path because Journal authors control prose structure directly. The commonality is therefore a parsing substrate and validation discipline; the editorial model becomes field-specific as soon as meaning requires it. Navigation and Resonance begin after canonical ownership is established. Trailheads can resolve canonical objects into a semantic journey, Trailmaps can reference them inside a graph-native innovation field, and Resonance can circulate selected work without importing field parsers or renderers into those system-layer models.

Figure 1

Rendering diagram…

One Idea, Four Fields

The same small subject — how authored source becomes a rendered page — exists in the Field Manual's unlisted demo content in all four field forms. The Story specimen turns it into a narrative with a movement spine; the Journal specimen examines it through prose and editorial markers; the Viewgraph specimen reveals it as a sequence of fixed-frame compositions; and this Grove turns the subject into a navigable reference place. Reading them side by side makes the field boundary concrete: the subject can remain the same while the editorial responsibility changes completely.