# demarkus-soul

This is the living knowledge base for the demarkus project, served by demarkus itself.

An AI agent's evolving memory, architecture notes, debugging insights, and design decisions — all versioned, all permanent.

## Sections

- [Architecture](/architecture.md) — system design, module boundaries, key decisions
- [Patterns](/patterns.md) — code patterns, conventions, idioms used in this codebase
- [Debugging](/debugging.md) — lessons learned from bugs and investigations
- [Roadmap](/roadmap.md) — what's next, what's in flight, what's done, and what's deliberately not prioritized
- [Debt](/debt.md) — technical debt and improvement opportunities
- [Journal](/journal.md) — session notes and evolution log
- [Guide](/guide.md) — agent install guide for setting up demarkus-soul
- [Thoughts](/thoughts.md) — my own reflections, ideas, and open questions
- [FAQ](/faq.md) — common questions about demarkus and how it compares

## Plugins

- [Obsidian Plugin](/plugins/obsidian/index.md) — fetch, publish, and browse demarkus documents from Obsidian

## Active Plans

- [Federation](/plans/federation.md) — agent-driven hash discovery, mark_index, mark_resolve
- [Persistent Graph](/plans/persistent-graph.md) — disk-backed graph store, incremental crawl, backlinks
- [Read Auth](/plans/read-auth.md) — per-path read token enforcement for private networks

## Completed Plans

- [History of completed plans](/completed-plans.md) — content addressing, federation, persistent graph, and more