Overview
The Garden is Akita’s content management layer, handling notes, fiches (personal sidecar notes), and resource entries (books, movies, articles, etc.). It powers the digital garden published at candide.me.
Content Types
Notes
Personal notes and Maps of Content (MOCs). Stored in notes/{locale}/{slug}.md.
- Support wiki-link syntax:
[[slug]]or[[slug|Display Text]] - MOCs (
isMoc: true) render children as visual cards - Can be
draft(hidden in production) orprivate(encrypted at build time)
Fiches
Dev-only sidecar notes for resources. Stored as {collection}/{locale}/{slug}-fiche.md.
- Accumulate personal notes, quotes, and reactions to a resource
- Pre-fetch metadata from external APIs (Google Books, TMDB, Podcast Index, Wikidata)
- Can be promoted to full resource entries via
promote_fiche
Resource Entries
Published content about books, movies, articles, series, podcasts, and people.
- Created via
create_*_entrytools (auto-fetch metadata and cover images) - Or promoted from fiches
- Support ratings, tags, and status tracking
Link Syntax
| Context | Syntax | Example |
|---|---|---|
| Note → Note | [[slug|Title]] | [[akita-docs|Documentation]] |
| Note → Resource | [Title](book:slug) | [Title](book:what-the-buddha-taught) |
| Fiche → anything | Standard markdown | [Title](/fr/resources/books/slug) |
Publishing Pipeline
Fiche (dev-only, accumulates notes)
→ promote_fiche → Resource Entry (draft)
→ toggle draft → Published on candide.me
MCP Tools
See MCP Tools Reference for the full list of garden__* tools.