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.mjscomponents/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.mjscomponents/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.
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
| full | full | absent | full | |
| full | full | absent | full | |
| full | full | partial | full | |
| absent | full | full | full |
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
| Concern | Stories | Journals | Viewgraphs | Groves |
|---|---|---|---|---|
| Container manifest | none (a metadata section) | musewoods.journal.manifest/v1 | musewoods.viewgraphs.manifest/v1 | per-Grove kind: grove + field musewoods.groves.manifest/v1 |
| Visibility | direct route only; no index | status + visibility: listed|unlisted | visibility: listed|unlisted | visibility: listed|unlisted (default listed) |
| Local navigation | contents + movement spine | front door + article breadcrumb | section controls | manifest navigation: list, optionally grouped |
| Charts | host story, inline|wide | host journal, numbered Figures | host viewgraph, default|hero|interpretation | host grove, inline|wide |
| Shared editorial motifs | yes | yes (as [!marker]) | no | yes |
| Analytical primitives | yes | yes (as [!marker]) | no, by intent | yes |
| Ground | soil | forest-floor on Story metadata | soil | forest-floor in frontmatter | Palette + per-viewgraph surface | soil | 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.
