#AGENTS.md

##What this is

Obsidian vault + Hugo content source for memex.keinmal.top. Custom Hugo theme: lichtung. Origin: HiraethEcho/blogs. All content is Chinese.

##Branches

branch	purpose
`memex-dev`	active editing (this checkout)
`memex`	triggers CI sync → pushes to separate `hiraethecho/memex` repo `dev` branch
`docs`	docs site
`math`	math notes (planned)

Work on memex-dev, merge to memex when ready.

##Content structure

dir	purpose	`SearchContent`	`CountWords`	RSS
`forest/`	raw info (clips, excerpts, rudiments, morgue/ideas, weblog)	false	false	false
`glade/`	refined writing (essays, memos, notes)	default	default	true
`diary/`	daily logs	default	default	default

All entries are *.md with YAML frontmatter. Use Hugo-style taxonomies for classification.

##Frontmatter conventions

yaml

---
title:       # required
date:        YYYY-MM-DD
summary:     one-liner
tags:        [topic1, topic2] or inline list
categories:  one of: slash, critique, guide, intropection, kulturprodukte, braindump, log, plan
topics:      [academic, lebensform]
series:      [barlec, creator, feminism, feminism-film, mp, stand-up]
genres:      [argumentative, narrative, opinion]
draft:       true | false
status:      idea | alpha | wip | beta
HideInFileTree: true
---

Root pages (about, me, now, log, links, archive, indexes) use categories: slash + HideInFileTree: true.

##Taxonomy dimensions

categories — cross-cutting content frame (critique, introspection, kulturprodukte, etc.)
topics — primary subject (academic, lebensform)
tags — concepts/objects referenced
series — multi-part series
genres — rhetorical mode (argumentative, narrative, opinion)

##Key conventions

Markdown links: absolute format ([text](/path/to/file)), not [[wikilinks]]
Tabs: 2 spaces (no real tabs). Prettier formats markdown with proseWrap: preserve.
Obsidian vault: .obsidian/ is gitignored. Vim mode enabled. Strict line breaks.
Drafts: use draft: true + optional status: idea | alpha | wip in frontmatter.
No build/test/lint commands — pure content. No Hugo config in this repo (it lives in the separate blogs repo).
.gitignore: ignores .obsidian and all.base.
GHA workflows: sync.yml pushes content to separate hiraethecho/memex repo. token.yaml triggers on src/** changes (inactive here — no src/ dir).
Password-protected entries: some diary posts use a custom password field; if you see one, leave it alone.

##Writing style

ALL content is in Chinese. Read existing posts under glade/essay/ and glade/memo/ to match tone and voice.