The Arcology Project is a mobile-first knowledge management system built on org-mode and org-roam. These documents describe the why: the user stories, feature requirements, and technical decisions that drive the implementation.

Documents

• The International Trip — The narrative user story that guides the entire project. A microfictional account of traveling through Japan with only a phone and tablet, your entire knowledge base in your pocket, offline-capable, syncing through federated infrastructure when connected. Every feature decision traces back to a scene in this story.

• Feature Requirements — The complete feature matrix drawn from a decade of Emacs and Python tooling, organized by subsystem: org-mode parsing, org-roam knowledge management, Arcology web publishing, and Arroyo literate programming. Each section ends with an implementation decision statement that shaped the codebase.

• Technical Requirements — Framework and library choices: Kotlin Multiplatform for cross-platform compatibility, SQLite/org-roam schema, Syncthing API for sync. This is the most dated document — many choices have been validated or superseded by implementation experience.

Related Modules

• README.org — Project overview

• contributing.org — Design axioms and development philosophy