# digital garden — CLAUDE.md This is Gerry's personal Obsidian vault, published via Obsidian Publish to https://gerry.garden (previously https://gerry.work). It is not a codebase — it's a mix of original writing, book/reading notes, and web clippings. Gerry is the sole author and creator. ## What this vault is A digital garden: browsed by topic, not chronology. Content is unpolished and evolving by design — don't try to "finish" or over-tidy notes unless asked. - **Home.md** — the vault's own front-page framing, in Gerry's voice (redesigned 2026-11-08; see Home layout under Site styling). Read this before writing anything meant to represent the garden to visitors. It opens with a combined search card that carries the intro ("I'm Gerry, and this is my digital garden…"), then five interest cards (Reading, Writing, Digital, Analogue, Misc), the "Human + AI" notice (`[!human-ai]`: the site mixes AI and human-generated content, and Gerry's writing elsewhere is human-generated — keep that accurate) and a "My other places" card linking Gerry's other sites. The "Recently updated" list inside the search card is **hand-written** (four links with one-line descriptions, no Dataview), so update it by hand when asked. Home.md doesn't say how often `Inventory` is regenerated, so don't promise a cadence for it or for the list. - **Inventory.md** — a structural summary of the vault, regenerated by Claude on request. Current opening line: "A summary of this digital garden's structure, generated 2026-11-08." (earlier versions read "An automated summary…, generated on …"); keep whichever form the file has. Treat it as a snapshot, not ground truth — regenerate rather than trust it if it looks stale. The 2026-11-08 version predates `INBOX/Post ideas - 2026-11-09.md` and the `backups-2026-11-08` / `-11-09` folders, lists backups only to 11-06, and says `Utilities/CLAUDE.md.bak` is gone when it is still there. - **Recent.md, Tags.md** (vault root, `garden-page`, tag `moc`, added Oct 2026) — the lists behind the Home search card's Recent / Tags scopes (a `Topics` list and scope existed briefly and were removed 2026-11-05; the old note is in `Utilities/backups-2026-11-05/`). `Recent` and `Tags` are Dataview queries wrapped in `%% DATAVIEW_PUBLISHER: start/end %%` (the `dataview-publisher` plugin bakes the results in as a table for Publish; they exclude `Utilities`, `Word-Smith`, `Templates`, `Reading/Readwise`, `Reading/Instapaper` and `INBOX`). `publish.js` parses these notes' tables to build the search results, so **don't change their layout** without checking the script. The baked tables are snapshots — Recent and Tags were last baked 2026-10-12. ## Top-level structure - **Analogue/** — pens, pencils, paper, notebooks (small): `Analogue.md` landing note, `Pens and Pencils.md`, `Blackwing.md`, `Paper/` and `Pencils/` subfolders, and an Attachments subfolder for photos - **No `Clippings/` folder** — an earlier version of this file described one; it no longer exists, so don't recreate it without asking. Clipper-style notes (frontmatter pattern below, tag `clippings`) now sit beside their topic, e.g. in `Reading/Authors`, `Reading/Bookshops`, `Reading/Poetry`, `Reading/Misc. Recommendations`, `Misc/Tai Chi` and `Digital/AI/J-space`. New unsorted clips go to `INBOX/`. - **Digital/** — research tools & workflows: `AI` (Claude/ChatGPT/Ollama/Perplexity notes; has a `Claude/` subfolder incl. `Claude cowork`, plus `J-space`, `Models`, `Obsidian-AI`, `Perplexity` and `Wispr Flow` — a Claude-written note on the dictation app, 2026-10-23), `Apple`, `Digital Gardens` (notes on other people's gardens, MOC-style), `LaTeX`, `Obsidian` (plugin notes, YAML, backlinks, dataview sandbox), `Software`, `Web`, `Online` (a single note listing Gerry's homes on the web — note this lives nested here, not as its own top-level folder) - **Instapaper Notes/** — top-level folder of article highlight notes (history: `Reading/Instapaper Highlights` → `Instapaper/` → `Instapaper Notes/`). Now **4 files**: three clips (`Erika Krouse`, `How to Find the Perfect Writing Soundtrack`, `Will Maclean on Fcking Up a Notebook to Write a Novel`) and a landing note, `Instapaper Notes.md`, that is **empty (0 bytes)**. `Reading.md`'s Instapaper link points at `[[Reading/Instapaper/Instapaper]]`, so nothing links into this folder. Format here: frontmatter with `url` and `date` (some also `author`), then the highlights as blockquotes (`> text ^hNNN`) — no `## Metadata`/`## Highlights` sections, no `cssclasses`. The `instapaper` styling class is added by `publish.js` from the folder name, so **don't rename this folder** without updating the script. All three clips also exist in `Reading/Instapaper/`; Inventory suggests moving them and retiring the folder, which is still Gerry's call. - **Reading/Instapaper/** — where the in-vault `instapaper` plugin writes (`notesFolder` in `.obsidian/plugins/instapaper/data.json`; syncs on start and hourly). Now holds **46 notes** (45 synced clips plus the landing note), a superset of `Instapaper Notes/`; the older ones use the `## Metadata` / `## Highlights` format with `cssclasses: [instapaper]`. `Recent`/`Tags` exclude this folder. It has a hand-made landing note, `Instapaper.md` (`garden-page`, a `## Topic` list of the notes; `Reading.md` links to it) — keep it out of any resync clean-up and add new synced notes to its list on request. **Unresolved:** the two Instapaper folders overlap and drift (Inventory flags it too); whether to retire `Instapaper Notes/` is still open. Inventory also asks whether the full-article-looking clips are safe to publish; raise it before adding more. Don't hand-tidy synced notes. - **Utilities/** — working files, not site content (~630 files, mostly backups). `Site icons/`: `gerry-garden.icns`, `favicon.ico` and round/square PNGs of the coral "g." logo (Oct 2026). Obsidian Publish auto-detects favicons by filename (`favicon.ico`, `favicon-NN.png`) among published files anywhere in the vault — so `favicon.ico` here is the live favicon; the other icon PNGs are source files only. `g-logo-140.png` at the vault root is an old 140px logo (renamed from `favicon-512.png` so Obsidian Publish stops auto-detecting it as a favicon). The site's only favicon is `Utilities/Site icons/favicon.ico` (multi-res, up to 256px). A copy of `g-logo-140.png` also sits in `Site icons/`. - `backups-YYYY-MM-DD/` — dated folders of `.bak` snapshots (named `<note>.before-<change>.bak`, some with a `landing/` or per-section subfolder) taken before each step of the Oct–Nov 2026 redesign and later tweaks: 10-10, 10-12, 10-13, 10-16, 10-18 (the biggest, ~340 files), 10-23, 10-26, 10-27 (two Home.md fixes), 11-05 (the Topics removal and "show more" folding: Home, CSS, JS, snippet, Inventory, CLAUDE.md and the old `Topics.md`), 11-06 (the 22 Readwise Articles `.bak` files from the link removal, plus pre-edit copies of CLAUDE.md, `Readwise.md`, `Inventory.md` and `publish.js`), 11-08 (33 files: Home.md, publish.css/js and snippet snapshots for each step of the Nov 8 Home redesign) and 11-09 (CLAUDE.md before this update). They cover Home.md, publish.css, publish.js, thistle.css and the landing notes. Leave them alone; Gerry decides when to delete them (Inventory suggests pruning once the styling settles). Don't tick them in the Publish dialog. - `CLAUDE.md.bak` — an old (Aug 2026) copy of this file; the `CLAUDE.before-update.md.bak` copies in `backups-2026-10-10` and `backups-2026-10-26`, `CLAUDE.before-topics-removal.md.bak` in `backups-2026-11-05` and `CLAUDE.before-update.md.bak` in `backups-2026-11-09` are the copies from just before the Oct 11, Oct 26, Nov 5 and Nov 9 updates. - **Attachments/** (vault root) — `Coatbridge.png`, `TheMessage.png` (cover art used by `Currently reading`) and `thistle.png`. Reading, INBOX, Analogue and Misc folders each keep their own Attachments subfolder as well. - **scripts/** (vault root, Nov 2026) — `update_reading.py`, a standard-library Python script that pulls Gerry's Goodreads `currently-reading` shelf (RSS) and writes a note of covers, titles and authors. Not site content; make sure it isn't ticked in Publish. It writes to `./Reading.md` by default, which would overwrite the Reading landing note if run from the wrong folder, and its output format differs from `Currently reading.md`: always pass an explicit output path, and ask Gerry before wiring it up. Nothing in the vault says it is scheduled. - **Claude outputs/** (vault root, Nov 2026) — a scratch folder for files Claude made for Gerry; currently `gerry-garden-load-check.xlsx` (2026-11-06, which by its name is a Publish load check; contents not re-read). Not site content; don't publish. - **Word-Smith/** — notes written and managed by the `word-smith` plugin: `ws-history.md` (daily words added/deleted per note — counts only, no text), `ws-settings.md` (a mirror of the plugin's settings) and `ws-structure.md` (manuscript structure, currently empty). Everything between the `<!-- wordsmith:… -->` markers is rewritten by the plugin, so don't edit inside them. Not site content; don't publish. - **INBOX/** — unsorted holding area for new clippings/drafts awaiting filing. Has its own Attachments subfolder. **New notes should default here unless the user says where to file them.** Currently 11 notes: `INBOX.md` (one-line landing note), six Claude-made weekly lists of post ideas from an AI-and-writing news scan (`Post ideas - 2026-10-07`, `-10-12`, `-10-19`, `-10-26`, `-11-02` and `-11-09`; tagged `post-ideas`), `Louise Glück.md` (2026-11-07, an author-style note tagged `reading`/`authors`, so probably bound for `Reading/Authors`), `Testing Wispr Flow.md`, an `Untitled.md` and an SF Chronicle clip. It's accumulating — a triage pass is overdue. - **Misc/** — **now published (Oct 2026)**, with a landing note `Misc/Misc.md` (`garden-page`, a short Evernote backstory in Gerry's voice, a back-to-Home callout and an `## Interests` list of one-line descriptions, one per subfolder plus `Aging`) and a fifth, full-width card on Home.md (`[!garden|wide]`; the `wide` callout metadata is what the CSS keys on), and the header drop-down in `publish.js` orders Reading, Writing, Digital, Analogue, Misc. Evernote-archive migrations, one subfolder per topic (`Cats`, `Funny`, `Garden Designs`, `Health`, `Music`, `Pepper`, `Photography`, `Society`, `Tai Chi`), each with its own Attachments subfolder where applicable. Notes here came from Evernote exports (`.resources` folders flattened into `Attachments`) — filenames were rewritten from raw export/article titles to short descriptive titles in some subfolders (notably `Health`) but not others, so don't assume the filename traces back to an original clipped title. `Garden Designs` is a scratch folder (one `Untitled` note of image embeds and thistle artwork plus Attachments, not listed on Misc.md) — it's design working material, not Evernote content. Each topic subfolder now has a same-named landing note (`garden-page`, a back-to-Misc callout and a list of links), so check before assuming one is missing. `Music` (27 notes) and `Photography`/`Society` (3 notes each) are newer and still growing — flag to Gerry if any of these outgrow "misc" status and warrant promotion to a top-level folder. `Photography` has an Attachments subfolder alongside its 3 notes (incl. Leica M series, Nikon Z6) — worth watching, may be the next candidate for promotion. `Tai Chi` has grown past stub status: 9 notes now, cross-linked with each other (e.g. individual technique notes alongside history/style overviews) — with its own landing note and a link from the Home Misc card, this is a stronger promotion candidate than Photography at this point; worth raising with Gerry. `Aging and retirement.md` (a `moc`/`clippings` round-up of links into `Reading/Readwise/Articles`) now sits at the top level of `Misc/`. - **Reading/** — by far the largest section: `Readwise/Articles` (215 notes), `Readwise/Books` (48) and `Readwise/Podcasts` (1), synced from Readwise — don't hand-edit these, plus `Authors` (one folder per author, with an author page named after the author and one note per book — see Author and book notes below), `Bookshops`, `Poetry`, `Misc. Recommendations` (the folder was renamed from the old "reccomendations" typo by 2026-11-08; its landing note is `Misc. Recommendations.md`, with two spaces — check the spelling on disk before linking). Also has two top-level notes directly in `Reading/`: `Reading.md` (landing note), `Currently reading.md` (cover-image grid, grouped Paper copies / Audiobooks, styled by the `book-grid` cssclass: each list item is cover image, title, author; two columns, 2:3 covers, the square Coatbridge art is the exception). The topic round-ups that used to sit here have moved (`Aging and retirement.md` to `Misc/`, `Writing craft and publishing.md` to `Writing/Craft/`), and `Question 7.md` (a pre-read review round-up, not Gerry's own commentary) is now at `Reading/Authors/Richard Flanagan/`. Each subfolder has a same-named landing note (`Authors/Authors.md`, `Bookshops/Bookshops.md`, `Poetry/Poetry.md`, `Misc. Recommendations/Misc. Recommendations.md`, `Readwise/Readwise.md`), and `Reading.md` has a `## Topic` list linking them (the Instapaper link goes to `Reading/Instapaper/Instapaper`), followed by a hand-written "Current Reading List" (Fiction, Audiobook, Non-fiction and Writing craft) that is separate from `Currently reading.md`. `Reading/Instapaper/` is the plugin's output folder (see Instapaper entries above); `Reading/Attachments/` holds two cover images. **Nov 2026:** the `## Full Document` link section was removed from all 22 `Readwise/Articles` notes that had it (originals in `Utilities/backups-2026-11-06/Readwise Articles/`), so nothing links into `Full Document Contents`, and that folder (909 files) has since been **removed from the vault** (Inventory 2026-11-08: ~1,702 → ~793 notes), so the Publish file index is far lighter. `readwise-official` is still not enabled (weekly frequency, sync-on-load off); if the sync is switched back on it may re-add that folder or the link section, so ask first. - **Writing/** — craft notes: memoir structure, craft-book summaries, writers' tips, a `Literary Journals` subfolder profiling markets, plus `Craft`, `MasterClass`, `Memoir` subfolders and a `Writing.md` landing note. Also `Quotations.md`, `Litmags Ranked.md` (Nov 2026; a clip of Erika Krouse's tiered ranking of fiction litmags, linked from Home's "Recently updated" list; it has no frontmatter) and `Craft/Writing craft and publishing.md` (a `moc`/`clippings` round-up of links into `Reading/Readwise/Articles`). - **Templates/** — Templater templates (currently just `note.md`) ## Frontmatter conventions Two distinct patterns are in use — match whichever fits the note's origin: **Original/craft notes** (the Templater default, see `Templates/note.md`): ```yaml --- created: '2026-07-04' last_edited: '2026-07-04' tags: [] --- ``` **Web clippings** (Readwise/clipper-style): ```yaml --- title: "..." source: "https://..." author: - "[[Author Name]]" published: 2023-08-11 created: 2026-06-06 description: "..." tags: - "clippings" --- ``` Don't invent a third pattern. A few recent clips (`Reading/Authors/Anne Carson/Anne Carson's Books.md`, `Writing/Litmags Ranked.md`) have no frontmatter at all; flag that rather than silently adding it. Dates are `YYYY-MM-DD`. Tags are lowercase, single words where possible (`writing`, `clippings`). **Exception:** notes in `Misc/` (Evernote migrations) use `created`/`last_edited`/`tags` like the Templater default, but keep a bare `source:` line (no `title`/`author`/`description`) when the original Evernote clip had one — a hybrid of the two patterns above, specific to that migration. **Presentation classes** (`cssclasses`) are added on top of whichever pattern fits, not a third pattern: `garden-home` (Home.md only), `garden-page` (the Reading, Writing, Digital, Analogue and Misc landing notes plus Recent and Tags; the landing notes carry a `> [!back] [[Home|Back to Home]]` callout and a `## Topic` list — `## Interests` on Misc — of wikilinks), `book-grid` (Currently reading), `instapaper` (older synced Instapaper notes; see above). ## Linking & style - Wikilinks (`[[Note Name]]`) are the norm, including links to folder index notes (e.g. `[[Analogue/Analogue|Analogue]]`) for folders that have a same-named landing note. - Footnote-style citations (`[^1_1]`) and `[cite:N]` markers show up in AI-assisted/clipped notes — these come from source generation, don't strip them without asking. - Headings, bold, and tables are used freely inside notes (this is content, not chat — normal Markdown formatting rules apply here, unlike conversational replies). ## Publishing - Published via the **Obsidian Publish** plugin (`.obsidian/publish.json`), not a static site generator — there's no build step to run. - `publish.css` is a hand-maintained custom theme (Solarized-inspired, light/dark; ~2,560 lines, with dated, commented override blocks stacked at the end — later blocks win, so read the end of the file before editing an earlier rule). If asked to touch site styling, edit this file directly and preserve the existing CSS variable structure/comments. - `publish.js` (vault root) is hand-maintained too and runs only on the published site. It builds a desktop-only header bar (the "g.gerry.garden" brand linking to Home, plus a hamburger that drops down Publish's own nav, ordered Reading, Writing, Digital, Analogue, Misc); builds the Home search card (scopes All / Recent / Tags — All uses Publish's own search, the others filter the published Recent/Tags notes; links are absolute on the custom domain); suppresses hover previews on the Home cards (publish.css now hides Publish's page-preview popover site-wide); and adds the `instapaper` class to any page whose URL path contains `Instapaper Notes/`. The old footer nav and the injected "g." mark (`buildMark`) were dead code and were removed on 2026-11-06 (`buildFooter` now only clears any stale footer copy); the pre-tidy file is in `Utilities/backups-2026-11-06/publish.before-tidy.js.bak`. It deliberately has no MutationObserver (one caused an iOS Safari scroll-bounce bug; see the comments in the file) — don't add one. Like publish.css, it needs republishing to take effect. - Enabled community plugins (per `.obsidian/community-plugins.json`): `dataview` + `dataview-publisher` (bakes Recent and Tags for Publish), `templater-obsidian`, `obsidian-linter`, `multi-properties`, `instapaper` (article highlights), `word-smith` (writing stats), `highlightr-plugin`, `global-book-search`, `obsidian-importer`, `obsidian-icon-folder`, `obsidian-style-settings`, `obsidian-minimal-settings`. **`readwise-official` is installed but not in the enabled list** (its settings show a weekly frequency, sync-on-load off) — check with Gerry whether syncing was switched off on purpose before expecting new Readwise notes. Also installed but disabled: `ollama`, `local-gpt`, `ai-providers`, `perplexed`, `perplexed-plugin-development`. ## Working in this vault - **Don't invent facts, citations, or sources.** Especially in Reading/ and in anything tagged `clippings` — if unsure whether something is Gerry's original claim vs. clipped source material, ask. - **Follow existing folder placement and frontmatter patterns** rather than introducing new schemes. - **New/unsorted content → INBOX/** by default. - **Flag weak organization or duplicate notes** rather than silently restructuring — this is a personal, evolving system; changes to structure should be explained. - Keep the informal, first-person voice already present in Home.md when writing anything user-facing (bios, landing notes, etc.) — don't default to generic "professional" copy. - Before changing `Home.md`, `publish.css`, `publish.js`, `thistle.css` or a landing note, copy the current file to `Utilities/backups-YYYY-MM-DD/<name>.before-<change>.bak` (the pattern used in the Oct 2026 redesign), and tell Gerry what changed. ## Author and book notes Pattern used for books Gerry is reading (e.g. `Reading/Authors/Augusten Burroughs/Dry.md`, `Ta-Nehisi Coates/The Message.md`): - Path: `Reading/Authors/<Author>/<Book>.md`, plus an author page `<Author>/<Author>.md` where one exists (frontmatter tags `<surname>`, `reading`, `authors`, `author`). - Frontmatter: `tags: [reading, <surname>]`, `created`, `date`. Sections: Metadata, "How this note was made", Summary (spoilers in their own labelled paragraph), Reception (named reviews, paraphrased, with links), Critique (labelled as Claude's synthesis, with questions to check while reading/listening), Sources, "My notes" (left empty for Gerry). - Written from published reviews and summaries, not from the book — say so in the note. Paraphrase; at most short quotes. Mark unread sources "not read". Don't state facts the sources don't give. For contested books, include critics from more than one side and say when a source is an advocacy group. - Link related notes with wikilinks (e.g. Dry ↔ Running with Scissors ↔ Magical Thinking). ## Site styling (published and desktop) - `publish.css` drives the published site; `.obsidian/snippets/thistle.css` (enabled in `appearance.json`) mirrors the relevant parts for the desktop app; heading colours/sizes on desktop are set in `.obsidian/themes/Solarized/theme.css`. When changing a style, update both publish.css and the snippet. - Brand: background `#FAF6EE`, ink `#2C2C2A`, coral `#D85A30`, link blue `#1B5FBF`. Fonts: `publish.css` currently sets `--font-text` and `--font-interface` to the system sans stack (a font swap on 2026-10-18 replaced the earlier Source Serif 4 / Inter), body 18px; the sidebar title and page titles use Georgia. Check the `:root` variables before assuming a font (the Source Serif 4 `@import` is still at the top of publish.css, and only the unused hero block uses it). - Site title lockup (sidebar and small-screen top bar) is CSS only, built on `.site-body-left-column-site-name` / `.site-header-text`: the anchor background draws the coral "g." pill, `::before` is "gerry" in ink, `::after` is ".garden" (coral dot, grey text). The real site-name text is hidden (`font-size:0`). Nudge it with `--title-nudge`. - **Home layout (Nov 2026 redesign, 2026-11-08):** Home.md has `cssclasses: [garden-home]`, no title of its own and no hero. The earlier `pill`, `lead`, `buttons` and `shelf` (Currently reading) callouts, the thistle and the terminal block are gone from the note. Order: (1) one violet-tinted `[!gardensearch]` card holding the `## Home` heading, the intro paragraph, the search box (`publish.js` adds a half-width input and the All / Recent / Tags pills) and a `## Recently updated` list; (2) five `[!garden|<name>]` interest cards — Reading (magenta `#D33682`), Writing (blue `#268BD2`), Digital (yellow `#B58900`), Analogue (green `#859900`) and the full-width `[!garden|wide]` Misc (orange `#CB4B16`) — each a light tint of its Solarized accent, with a linked `##` title, a one-line description, two example links and a `[[…|More …]]` line under a thin rule, numbered 01–05 by a CSS counter; (3) the teal `[!human-ai]` notice (06); (4) `[!garden|places wide]` "My other places" (07, Solarized red, thin rule below), linking Gerry's hub (gerrymcdermott.com), gerry.life, gerry.photos, gerry.cloud and vermillion.red. The card colour keys on the callout metadata word (`reading`, `writing`, `digital`, `analogue`, `wide`, `places`), so keep those words when editing; adding or reordering cards renumbers them. Box headings are system sans, 23px, weight 500, and hover/focus borders go dark green. Styles are the dated override blocks at the end of publish.css (from "HOME REDESIGN — Nov 2026" on; later blocks win) on top of the older "GARDEN LAYOUT" block, mirrored in the snippet. The hero, shelf, terminal, Elsewhere and thistle CSS is still in the file but unused — leave it unless asked. The "Links to this page" backlinks list is hidden on Home and the landing notes, there's no graph/right column at any width, and Publish's hover page-preview is hidden site-wide. The step-by-step `.bak` copies are in `Utilities/backups-2026-11-08/` (including `Home.before-redesign.bak` and `home-redesign.block.css`). - **Sync check:** `publish.css` and `.obsidian/snippets/thistle.css` were both last edited 2026-11-09/10 (the Nov 8 Home redesign session), but the snippet is only a partial mirror (~55 KB against ~79 KB, no header comment), so the two are not identical. Diff the relevant blocks rather than assuming parity. - **Highlights lists** (every note with a `## Highlights` heading): no bullets; a 2px rule in the h2 colour beside each highlight, as tall as its text, with a thin grey line in the gap between highlights. Pure CSS keyed on `h2[data-heading="Highlights"] ~ ul`; any bulleted list further down such a note is styled the same. - **Instapaper notes** (`.instapaper`): each highlight is a blockquote with a 2px grey rule beside it, a 1px grey line between highlights and a much lighter tint behind. The class comes from `cssclasses` on older synced notes, or from `publish.js` for anything under `Instapaper Notes/`. - Images must be ticked separately in the Obsidian Publish dialog (covers, thistle, any new image) and `publish.css` and `publish.js` must be republished for style changes to appear online.