About This Knowledge Base

apps/kb is the knowledge base for the duyet.net monorepo. It stores durable architectural knowledge, design decisions, and workflow patterns as static markdown articles.

Purpose

Unlike docs/ai/core-memory.md (raw agent memory dumps) or memory/*.md (session notes), the KB articles are:

• Synthesized: each article covers one topic end-to-end, merging multiple memory sources where relevant
• Structured: consistent frontmatter with categories, tags, links, and a one-sentence summary
• Graph-connected: links in frontmatter form a graph; the build pipeline computes incoming links from outgoing

Structure

apps/kb/content/
  infrastructure/    # Cloudflare, deploy, WASM, CI
  design-system/     # tokens, dark mode, shadcn, icons
  apps/              # per-app overviews
  agents/            # duyetbot scope, autonomous workflows
  data-pipeline/     # data sync, ClickHouse, CCUsage
  workflows/         # commit/push/deploy, dead code, tests
  decisions/         # architectural decisions
  meta/              # about the KB itself

llms.txt

Each article's summary field (≤140 chars) feeds the /llms.txt endpoint — a machine-readable index of the KB for LLM context injection. The summary must be a single sentence.

Seeding history

The initial KB content was seeded on 2026-05-26 by synthesizing all .md files in the agent memory directory (~/.claude/projects/-Users-duet-project-monorepo/memory/). Memory files are point-in-time snapshots; KB articles are the distilled, durable form.

Who maintains it

duyetbot adds and updates articles as part of its normal workflow. When a significant architectural decision is made or a new pattern is established, it should be captured here — not just in a commit message or memory file. Blog post content and LLM Timeline curated data remain out of scope.