Molib Wiki

Local knowledge base for the Molib project. The files in wiki/ are the source of truth — edited directly in the repo, version-controlled with the rest of the codebase, and rendered locally by MkDocs Material.

Sections

• Architecture Decision Records — non-obvious decisions and their rationale, in ADR format.
• Plans — working documents for upcoming features (goal, approach, open questions). Promoted to Implemented on ship.
• Models — persisted domain entities: fields, constraints, invariants, relationships.
• Versions — per-release changelogs (SemVer).
• Design system — palette, typography, components. Live preview at /design.

Conventions

• One topic per file, kebab-case filename.
• Decisions go under adr/NNNN-title.md. See adr/README.md for the format.
• Agents writing here should keep entries focused — link to other pages rather than duplicating content.

Viewing locally

The wiki is served by the docs service in docker-compose.yml:

docker compose up -d docs   # http://localhost:8000

Live-reloads on file changes.