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
• 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

Plans

• Content Addressing — hash-based fetch, in-memory index, mirror foundation
• Federation — agent-driven hash discovery, mark_index, mark_resolve