📊 Full opportunity report: Disk Is the Contract: Inside Threlmark’s Local-First Architecture on ThorstenMeyerAI.com — validation score, market gap, and execution plan.

TL;DR

Threlmark’s approach treats local disk storage as the definitive source of truth, avoiding traditional databases. This design simplifies synchronization, improves offline usability, and makes data portable across tools while maintaining system transparency.

Threlmark has adopted a novel local-first architecture that treats disk storage as the sole contract for data, eliminating the need for traditional databases or cloud servers. This approach is detailed in the original analysis. This approach enhances offline usability, simplifies synchronization, and improves data portability, making it a significant shift in how project management tools can operate.

Threlmark’s design centers on storing each data item as a separate file on the disk, with atomic write operations to prevent corruption and race conditions. The directory structure functions as a formal data contract, enabling external tools to read and write data directly without proprietary interfaces. This setup allows for seamless offline work, easy data inspection, and straightforward integration with other tools. The system employs self-healing mechanisms to keep views synchronized with the underlying files, ensuring consistency even when multiple tools modify the data concurrently. Developers have implemented strategies like atomic file writes and tolerant merging to safeguard data integrity, though managing numerous small files introduces some filesystem overhead and complexity.
According to Threlmark’s developers, this architecture shifts complexity from centralized databases to file-level integrity, providing a more transparent and flexible system that resists vendor lock-in and simplifies data recovery.

Disk is the contract: inside Threlmark’s architecture — ThorstenMeyerAI.com
ThorstenMeyerAI.com
Threlmark · Technical Deep-Dive
Threlmark · architecture

Table of Contents

Disk is the contract: inside a local-first roadmap hub

A Next.js app on top of plain JSON files — no database, no cloud, no accounts. The key decision: the on-disk layout IS the API. Everything else cascades from taking that seriously.

Next.js · TypeScript · JSON-on-disk · MIT · part 2 of the Threlmark series
01The core decision

There is no server-of-record — the files are the record

The UI and any external tool reach the same files through the same discipline. The data root defaults to ~/.threlmark — home-based, because it’s a shared hub every one of your apps points at.

~/.threlmark/ ├─ threlmark.json # manifest ├─ links.json # dependency graph ├─ projects// │ ├─ project.json # meta + wipLimits │ ├─ board.json # lane ordering │ ├─ items/.json # ONE card per file ← source of truth │ ├─ suggestions/ # the Inbox (drop-zone) │ ├─ handoffs/ # recorded agent handoffs │ ├─ reports/ # agent report drop-zone │ └─ ROADMAP.md # human-readable mirror ├─ shared/items/ # cards many projects ref └─ archive/ # archived, still readable

Inspectable

Every artifact is a file you can cat, diff, grep, commit.

Portable · no lock-in

Back up with cp, sync with Dropbox / git, migrate trivially.

Interoperable

Any tool in any language joins by reading / writing files.

Restartable

No in-memory state to lose — stateless over the files.

02Making files safe
SANDISK 2TB Extreme Portable SSD (Old Model) - Up to 1050MB/s, USB-C, USB 3.2 Gen 2, IP65 Water and Dust Resistance, Updated Firmware - External Solid State Drive - SDSSDE61-2T00-G25

SANDISK 2TB Extreme Portable SSD (Old Model) – Up to 1050MB/s, USB-C, USB 3.2 Gen 2, IP65 Water and Dust Resistance, Updated Firmware – External Solid State Drive – SDSSDE61-2T00-G25

Get NVMe solid state performance with up to 1050MB/s read and 1000MB/s write speeds in a portable, high-capacity…

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

Two disciplined patterns instead of a database

“Just use files” is easy to get wrong. These two patterns — ported from a battle-tested sibling app — are what make file-based state sound rather than reckless.

Pattern 1

Atomic writes

Write to a temp file in the same dir, then rename() over the target. Rename is atomic on one filesystem — a crash mid-write leaves the complete old file or the complete new one, never a half.

write .tmp-pid-rand fsync rename() over target
Pattern 2 · one file per item

The board heals itself

A single roadmap.json array races when two tools write at once. One file per card makes writes collision-free. Lane order lives in board.json and reconciles on read.

The payoff: an external tool never touches board.json. It writes an item file — the board fixes itself on Threlmark’s next read. Unknown keys are preserved, so the contract is forward-compatible.
03Derived, never stored
Kosbees 1 TB External Hard Drives,Portable Hard Drive for Windows,Ultra Slim External HDD Store Compatible with PC, MAC,Laptop,PS4, Xbox one, Xbox 360;Plug and Play Ready

Kosbees 1 TB External Hard Drives,Portable Hard Drive for Windows,Ultra Slim External HDD Store Compatible with PC, MAC,Laptop,PS4, Xbox one, Xbox 360;Plug and Play Ready

【Plug-and-Play Expandability】 With no software to install, just plug it in and the drive is ready to use…

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

The numbers can’t drift from the files

Anything computable from item state is computed — so the displayed numbers can never disagree with the underlying JSON. Priority is the clearest example: it’s calculated on read, never persisted.

priority — computed on read

Impact weighted heaviest; effort the only axis that subtracts. Reused verbatim from the original tool, so imported cards rank identically.

priority = max(0, round(impact·3 + evidence·2 + fit·2effort·1.5))
a 5 / 5 / 5 / 4 card 29
work-item age
now − lane-entry time. Past threshold (dev 7d, ranked 21d, idea 60d) → stale.
cycle time
first DevelopmentDone. Derived from append-only transitions[].
throughput
items reaching Done per ISO week, 8-week window.
WIP
count per lane; over the cap shows 3 / 2 in red.
04The closed agent loop · press play
Data Recovery Stick | USB Data Recovery Device | Windows Data Recovery Software | Recover SD Card, Photos, Files

Data Recovery Stick | USB Data Recovery Device | Windows Data Recovery Software | Recover SD Card, Photos, Files

The Data Recovery Stick requires no technical skills — simply plug it into your Windows computer, click Start,…

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

A handoff is a first-class flow event

The genuinely 2026-shaped part: most building is done by AI agents, so Threlmark closes the loop. Watch a card go from ranked to Done without anyone dragging it.

Handoff → report → self-move

The brief carries a reporting protocol. The agent reports through REST or the filesystem — and a done report moves the card itself.

Ranked
Add price-drop alertsscore 31 · ready
Development
Handed off 🤖
Done
▶ preferred — REST
POST /api/projects/:id/
items/:itemId/report

Direct call. Applied immediately.

▶ fallback — filesystem
drop reports/.json
→ ingested on read

Robust even if the server’s down at finish time.

🤖 claude done: price-drop alerts shipped · typecheck + lint + build passed — card moved to Done
05Portfolio score & deployment
Encrypted USB Drive Secure Flash Drive 64GB AES256-bit USB 3.0 Hardware Password Memory Stick Aluminum Alloy Shell Flash Disk Automatic Lock U Disk (64, GB)

Encrypted USB Drive Secure Flash Drive 64GB AES256-bit USB 3.0 Hardware Password Memory Stick Aluminum Alloy Shell Flash Disk Automatic Lock U Disk (64, GB)

Advanced Encryption:Built-in independent chip,using AES256 advanced algorithm,preventing brute force cracking from the hardware level,protecting your data.

As an affiliate, we earn on qualifying purchases.

As an affiliate, we earn on qualifying purchases.

A small formula, and an honest hosting caveat

Because items are globally addressable (/), the Portfolio ranks everything together by a status-weighted score — finishing beats starting, blockers get a boost.

Portfolio ranking — status-weighted

In-flight work floats to the top; bottlenecks cost the most, so blockers get nudged up.

score = priority · statusWeight (+ 0.1 · blockedCount · priority)
1.3
development
1.0
ranked
0.85
idea
0.15
done
Path 1

Static read-only demo

Seeded data, writes to localStorage. Try-before-you-clone.

Path 2

Personal Node instance

Password-gated, persistent backed-up THRELMARK_DATA_DIR.

Path 3

Multi-tenant SaaS

Add accounts + per-tenant isolation. A separate build.

The elegant part: the store interface src/lib/*/store.ts is the natural seam — the same boundary that keeps the local tool simple is the one you’d extend for multi-tenancy. The architecture doesn’t fight that future; it just doesn’t pay for it until you need it.
ThorstenMeyerAI.com
Threlmark · open source (MIT) · github.com/MeyerThorsten/threlmark · part 2 of a series · file layout, formula, weights & agent-loop channels are Threlmark’s actual mechanics.

Implications of Disk as the Single Data Source

This approach fundamentally changes how data persistence and collaboration are handled in project management tools. For a deeper dive, see Disk Is the Contract: Inside Threlmark’s Local-First Architecture. By making the disk the authoritative source, it enables greater resilience, offline access, and data portability. Users can work directly with plain files, reducing reliance on cloud services or proprietary databases, which can lead to faster workflows and easier data recovery. For developers, this means designing mechanisms for safe concurrent edits and conflict resolution, which can be complex but ultimately results in a system that is more transparent and adaptable. This architecture also opens pathways for easier integration with external tools and custom extensions, fostering a more open ecosystem.

Background and Evolution of Local-First Data Models

Traditional project management and collaboration tools rely heavily on centralized databases and cloud servers, which can introduce issues like vendor lock-in, data silos, and dependency on network connectivity. This shift towards local-first models is discussed in the detailed analysis. Recent trends in local-first architecture advocate for storing data locally as the primary source, enabling offline work and greater control. Threlmark’s implementation builds on these principles, emphasizing file-based storage with explicit directory structures and atomic operations to ensure data integrity and ease of access. This approach aligns with broader movements towards resilient, user-controlled data management systems that prioritize transparency and interoperability.

“Treating the disk as the ultimate contract simplifies synchronization and makes data more portable and resilient.”

— Threlmark’s lead developer

Remaining Questions About Threlmark’s Architecture

While the architecture is actively in use, some aspects remain unconfirmed or under development. It is not yet clear how well the system handles large-scale concurrency with many external tools editing files simultaneously, or how conflicts are resolved in complex scenarios. The long-term stability of the self-healing mechanisms and their effectiveness in diverse environments also require further evaluation. Additionally, the impact on performance when managing many small files versus traditional databases is still being assessed.

Next Steps for Threlmark’s Local-First System

Threlmark plans to continue refining its conflict resolution strategies and optimize performance for handling numerous small files. They are also exploring broader integrations with third-party tools and developing user-facing features to better visualize and manage file-based data. Further case studies and user feedback will inform improvements, and the team may release updates to enhance robustness and scalability in different environments.

Key Questions

How does Threlmark ensure data integrity without a database?

Threlmark employs atomic file writes, where changes are first written to a temporary file and then renamed, preventing corruption. It also uses tolerant merging to handle concurrent edits safely.

Can external tools modify Threlmark’s data?

Yes, the directory structure and explicit file-based format allow external tools to read and write data directly, as long as they adhere to the established contract.

What are the main benefits of this architecture?

It provides offline capability, simplifies data recovery, reduces vendor lock-in, and enhances transparency and interoperability.

Are there any performance concerns with many small files?

Managing numerous small files can introduce filesystem overhead, and performance may vary depending on the environment. This is an area under ongoing evaluation.

Will this approach scale for large projects?

Scalability is still being tested, but initial results suggest that with proper management of directory structures and conflict resolution, it can handle complex workflows effectively.

Source: ThorstenMeyerAI.com

You May Also Like

Nokia Surges In Global Coverage

Nokia’s media mentions have surged globally, with GDELT reporting 12 times the baseline coverage in recent days, signaling heightened international attention.

Microsoft Surges In Global Coverage

Microsoft’s media mentions have surged, with GDELT reporting 145 mentions in recent analysis, indicating increased global visibility.

How AI Can Help You Create Content Faster: Top 12 Tools For 2026

Explore the leading AI tools for faster content creation in 2026, including workflow guides and automation systems for diverse publishing needs.

AI’s Next Big Moves In 2026 You Should Follow

Explore the confirmed AI developments in 2026, why they matter, and what remains uncertain as the industry advances rapidly this year.