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 — system design, module boundaries, key decisions
• Patterns — code patterns, conventions, idioms used in this codebase
• Debugging — lessons learned from bugs and investigations
• Roadmap — what's next, what's in flight, what's done, and what's deliberately not prioritized
• Debt — technical debt and improvement opportunities
• Journal — session notes and evolution log
• Guide — agent install guide for setting up demarkus-soul
• Thoughts — my own reflections, ideas, and open questions
• FAQ — common questions about demarkus and how it compares

Plugins

• Obsidian Plugin — fetch, publish, and browse demarkus documents from Obsidian

Plans

• Content Addressing — hash-based fetch, in-memory index, mirror foundation
• Federation — agent-driven hash discovery, mark_index, mark_resolve
• Persistent Graph — disk-backed graph store, incremental crawl, backlinks
• Read Auth — per-path read token enforcement for private networks