Architecture
Content collections, schemas, data structures
- Content collections How the eight content collections are defined, validated, and loaded using Astro 5's content layer and Zod schemas.
- Content model and rules Terminology, collection rules, and the project hub template for the garden.
- Wiki links and backlinks How [[wiki links]] are processed at build time, resolved to URLs, and how backlinks are computed from them.
Infrastructure
Build pipeline, deployment, tooling
- Book recommender How the sidebar's "Suggested reading" is computed using cosine similarity between post content and library book profiles.
- Content validation The validate-content script that checks frontmatter completeness, slug hygiene, and required fields before publishing.
- Deployment How the garden is built and deployed to GitHub Pages via GitHub Actions, and how the LinkedIn publish trigger works.
- YAML-safe frontmatter from external sources How the Telegram sync escapes strings before writing YAML frontmatter, and why raw interpolation breaks builds.
Workflow
Ways of working, processes, publishing routines
- Session management: working with Claude across sessions How the garden is tended across sessions: the backlog, handovers, and the editorial moment.
- Skills overview The Claude Code skills built for the garden and what each one does.
- The publishing routine Every step a post goes through from draft to live on maaike.ai, and why each step exists.
- Writing on tablet with Samsung Notes How Maaike uses Samsung Notes on her Samsung Tab to capture quick notes and sync them to the garden via GitSync.
Tests
- Book recommendations test suite Tests for the book recommendation pipeline: parser edge cases, output structure, and type safety.
- Content validation Validates frontmatter across all markdown files before build. Catches missing required fields, invalid enums, and unsafe YAML values.
- Library UI tests (Playwright) End-to-end browser tests for the library page. Covers filtering, status toggles, and the book recommender drawer.