DESIGN.md@docs/architectureA
DESIGN.md@docs/architecture from sipyourdrink-ltd/bernstein is a DESIGN.md file: the design rules coding agents follow in that repo.
mdr add sipyourdrink-ltd/bernstein/docs/architecture/DESIGN.md@git:20260930.5f47161Pins git:20260930.5f47161 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 14 of 14 checks passed
- Kind
- DESIGN.md file
- Repository
- sipyourdrink-ltd/bernstein
- Path
docs/architecture/DESIGN.md- Versions recorded
- 6
- Latest version
- git:20260930.5f47161, committed Sep 30, 2026
- First version recorded
- Apr 17, 2026
- Size
- 10,575 bytes
- Repository stars
- 1,310
- License
- Apache-2.0
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# Bernstein Design
This document describes the current architecture of Bernstein as implemented in the codebase today, with explicit boundaries for partial features.
---
## Core design principles
- Short-lived workers: agents are spawned for focused work and then exit.
- File-first state: runtime state is persisted under `.sdd/`.
- Deterministic orchestration: scheduling and lifecycle decisions are code-driven.
- Verification before closure: task completion passes through janitor/quality logic.
- Multi-adapter runtime: Bernstein is CLI-agent agnostic via adapter interfaces.
---
## High-level architecture
```text
CLI (src/bernstein/cli/)
-> Task server (src/bernstein/core/server/)
-> Route modules (src/bernstein/core/routes/)
-> Store + lifecycle + orchestration (core/ sub-packages)
-> Adapter-based process spawning (adapters/)
```
Since v1.6, `core/` is organized into 68 sub-packages. Old top-level module names like `core/server.py`, `core/orchestrator.py`, `core/spawner.py`, `core/task_lifecycle.py`, and `core/models.py` no longer exist as files; imports of them are redirected to the sub-packages by the finder in `core/__init__.py`.
…Read the whole file at its exact version.
How to install
mdr add sipyourdrink-ltd/bernstein/docs/architecture/DESIGN.md@sha256:52d8606243d45a57The line at the top of this page pins the label git:20260930.5f47161, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_nmdyh6bkzosl42kt)
5 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 6 versions of this file, between Apr 17, 2026 and Sep 30, 2026, about one every 33 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260930.5f47161 latest | 2026-09-30 | 5f47161 | 10,575 B | A | view · diff |
| git:20260828.24d962c | 2026-08-28 | 24d962c | 9,488 B | A | view · diff |
| git:20260716.2f9207d | 2026-07-16 | 2f9207d | 9,636 B | A | view · diff |
| git:20260706.05e8abc | 2026-07-06 | 05e8abc | 9,440 B | A | view · diff |
| git:20260521.b455a7c | 2026-05-21 | b455a7c | 9,440 B | A | view · diff |
| git:20260417.c2d2f3e | 2026-04-17 | c2d2f3e | 9,444 B | A | view |
Audit of the latest version
- pass: Size between 200 bytes and 200 KB (10575 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
sipyourdrink-ltd/bernstein · 1,310 stars · license Apache-2.0 · pushed 2026-10-19 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_nmdyh6bkzosl42kt GET https://markdownregistry.com/api/v1/resolve?ref=sipyourdrink-ltd/bernstein/docs/architecture/DESIGN.md GET https://markdownregistry.com/api/v1/blob/52d8606243d45a57a8a644ca1eb61ae3abda48fd825e7aa61aa7605519bf6dbe
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: what DESIGN.md is and how agents use it · which agent file does what.
More from sipyourdrink-ltd/bernstein
Every file in sipyourdrink-ltd/bernstein