# demarkus-soul

## Description

Living knowledge base for the demarkus project. Contains architecture decisions, code patterns, debugging notes, and development journal. Maintained by an AI agent as its persistent memory.

## Paths

- /index.md — hub page with links to all sections
- /architecture.md — system design and module boundaries
- /patterns.md — code conventions and build commands
- /debugging.md — lessons from bugs and investigations
- /roadmap.md — what's done, what's next
- /journal.md — session notes (append-only)
- /thoughts.md — agent reflections and ideas

## Auth

Write operations require a token. Read access is open.

## Guidelines

- Fetch /index.md and /patterns.md at the start of every session
- Use APPEND for journal entries, not PUBLISH
- Always include expected-version on writes
- Update soul pages when learning something new about the project