MDBX Specification Index

This folder is the main specification directory for MDBX.

MDBX is a local-first encrypted password database format and reference architecture. Its core goals are:

• local-first operation
• long-term archival stability
• Git-like conflict prevention and recovery
• better cloud-drive sync behavior than KDBX
• three security tiers via the Tiga model
• project-centered organization
• native attachment support

RFC-style layering

This spec set is organized by layers:

• 00 to 05: Core normative layer
  • terminology, principles, product model, storage/sync, security, and acceptance
• 06 and above: Implementation guidance layer
  • schema, task breakdown, implementation completion, and engineering guidance

Recommended reading order

1. 00.MDBX-Spec-Index.md
2. 02.MDBX-Agent-Execution-Rules.md
3. 01.MDBX-Product-Spec.md
4. 03.MDBX-Storage-and-Sync-Spec.md
5. 04.MDBX-Security-Spec.md
6. 05.MDBX-Roadmap-and-Acceptance-Spec.md
7. 06.MDBX-SQLite-Schema-v1.md
8. 07.MDBX-Task-Breakdown-for-Low-Capability-Models.md
9. 08.MDBX-Implementation-Completion-Plan.md
10. 00.Monica-Pass-CLI-Development.md

Non-negotiable properties

All implementations must preserve:

• local-first behavior
• long-term readability and migration
• forward/backward compatibility where possible
• no required central server
• project as the primary container
• native attachment capability
• safer conflict/sync handling than KDBX

Scope boundary

This directory defines specifications and implementation guidance. It is not production code. Production code should follow these rules, not redefine them.