For the complete documentation index, see /developers/llms.txt Markdown versions: append .md to any /developers/{slug} URL. Browse structure: /developers/sitemap.md This page: /developers/contributor-architecture.md

Repo map (L1)

Scan-first index of domains for eigen product contributors. Operators and integrators should start with Architecture overview and How memory works.

Pick a domain → read its L2 file → if it points to a conflict ID, read that row in conflicts.md.

  • Ingestion — Persist thoughts: normalize, classify, embed, lexical index, Postgres + Apache AGE graph sync, activity logging. L2: ingestion.md.
  • Client capture queue — Browser IndexedDB queue, serial drain, NDJSON progress UI, offline sync. L2: capture-queue.md.
  • Retrieval — Hybrid search (vector + lexical + AGE graph RRF), API + MCP + QA compose. L2: retrieval.md.
  • Auth and tenancy — Better Auth sessions, scoped Postgres via app.current_user_id, RLS policies. L2: auth-and-tenancy.md.
  • UI surfaces — SvelteKit routes and client fetch patterns for capture, graph, chat, settings, etc. L2: ui-surfaces.md.
  • Consolidation (sleep) — Nightly pg_cron → salience decay, ontology prune, graph communities, open-loop boost. L2: consolidation.md.

Supporting docs (not domain maps):

Agent Instructions

This documentation is published for humans and AI agents. Prefer .md URLs for structured content.

  • Index: /developers/llms.txt
  • Full export: /developers/llms-full.txt
  • Sitemap: /developers/sitemap.md
  • Raw page: append `.md` to any /developers/{slug} URL
  • Example: GET /developers/mcp-overview.md

Dynamic `?ask=` and `?goal=` query on markdown URLs is planned — see docs/planning/10-docs-query-api-design.md.