DESIGN.md@websiteA

DESIGN.md@website from constellation-works/orbit is a DESIGN.md file: the design rules coding agents follow in that repo.

Install it, pinned
mdr add constellation-works/orbit/website/DESIGN.md@git:20261025.522b1c0

Pins git:20261025.522b1c0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
DESIGN.md file
Repository
constellation-works/orbit
Path
website/DESIGN.md
Versions recorded
27
Latest version
git:20261025.522b1c0, committed Oct 25, 2026
First version recorded
Sep 6, 2026
Size
10,752 bytes
Repository stars
19
License
MIT

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

# Orbit Website — Design

The design contract for `orbit-cli.com`: what the site is for, how it looks, how it is organized and how its pages are written. Read it before changing the site's look, navigation or homepage.

---

## 1. Purpose & Audience

The Orbit website is a **documentation site**, not a marketing site. It exists to host:

- Reference documentation (CLI commands, activity/job YAML schemas, policy formats)
- How-to guides (task lifecycle, delivery windows, recurring work, task publication)
- Conceptual explainers (activity/job model, task lifecycle, agent runtimes)

**Primary audience:** engineers evaluating or actively using Orbit. They arrive via search, know roughly what they want, and leave as soon as they have it. The site optimizes for that path.

**Non-goals:**
- Lead generation, conversion funnels, email capture
- Blog, changelog-as-narrative, release announcements (those live in `CHANGELOG.md` and git)
- Interactive playgrounds or live demos (revisit if Orbit grows a hosted offering)

---

## 2. Design Principles

1. **Reference-heavy, search-first.** Users land via `⌘K` or Google. Every page must be findable and self-contained.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add constellation-works/orbit/website/DESIGN.md@sha256:59ae22360596522e

The line at the top of this page pins the label git:20261025.522b1c0, 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.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_pw4mzy7s6qajbv6s.svg)](https://markdownregistry.com/a/art_pw4mzy7s6qajbv6s)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 27 versions of this file, between Sep 6, 2026 and Oct 25, 2026, about one every 2 days.

versioncommittedcommitsizeaudit
git:20261025.522b1c0 latest2026-10-25 522b1c0 10,752 BA view · diff
git:20261017.a3c68c72026-10-17 a3c68c7 10,753 BA view · diff
git:20261011.6ba720a2026-10-11 6ba720a 10,753 BA view · diff
git:20261011.a914ff32026-10-11 a914ff3 10,489 BA view · diff
git:20261010.b8705d02026-10-10 b8705d0 10,486 BA view · diff
git:20261010.d58e6ef2026-10-10 d58e6ef 10,364 BA view · diff
git:20261007.efe48802026-10-07 efe4880 13,105 BA view · diff
git:20261004.07ed5c82026-10-04 07ed5c8 12,963 BA view · diff
git:20261004.271bd702026-10-04 271bd70 12,987 BA view · diff
git:20261001.b9c87fc2026-10-01 b9c87fc 12,523 BA view · diff
git:20261001.1d091612026-10-01 1d09161 12,265 BA view · diff
git:20261001.77503c82026-10-01 77503c8 12,473 BA view · diff
git:20260929.a37d1ec2026-09-29 a37d1ec 11,787 BA view · diff
git:20260927.1c96fe12026-09-27 1c96fe1 11,671 BA view · diff
git:20260927.a9c2ced2026-09-27 a9c2ced 11,478 BA view · diff
git:20260925.b65f9f92026-09-25 b65f9f9 12,256 BA view · diff
git:20260921.f61e0752026-09-21 f61e075 12,597 BA view · diff
git:20260918.0a4dbde2026-09-18 0a4dbde 12,631 BA view · diff
git:20260918.495e6a32026-09-18 495e6a3 12,480 BA view · diff
git:20260918.0866e692026-09-18 0866e69 12,075 BA view · diff
git:20260914.78f1b192026-09-14 78f1b19 11,803 BA view · diff
git:20260911.0cf63422026-09-11 0cf6342 11,247 BA view · diff
git:20260907.09182a22026-09-07 09182a2 11,402 BA view · diff
git:20260907.5fc8d642026-09-07 5fc8d64 11,157 BA view · diff
git:20260907.e2454bc2026-09-07 e2454bc 10,567 BA view · diff
git:20260906.86d48eb2026-09-06 86d48eb 10,401 BA view · diff
git:20260906.932d7002026-09-06 932d700 10,224 BA view

Audit of the latest version

A  14 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Size between 200 bytes and 200 KB (10752 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

GitHub

constellation-works/orbit · 19 stars · license MIT · pushed 2026-11-02 · branch agent-main

API

GET https://markdownregistry.com/api/v1/artifacts/art_pw4mzy7s6qajbv6s
GET https://markdownregistry.com/api/v1/resolve?ref=constellation-works/orbit/website/DESIGN.md
GET https://markdownregistry.com/api/v1/blob/59ae22360596522e7628a74a14fc3ed9a6111926d39f4a95a676ef4c3525180d

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 constellation-works/orbit

AGENTS.md AGENTS.md file
constellation-works/orbit · AGENTS.md
git:20260419.715e592 · audit B · 19 stars
CLAUDE.md CLAUDE.md file
constellation-works/orbit · CLAUDE.md
git:20261101.ae36aaf · audit A · 19 stars
AGENTS.md@crates/orbit-auth AGENTS.md file
constellation-works/orbit · crates/orbit-auth/AGENTS.md
git:20261026.7154cd6 · audit B · 19 stars
CLAUDE.md@crates/orbit-auth CLAUDE.md file
constellation-works/orbit · crates/orbit-auth/CLAUDE.md
git:20261027.1d2eac0 · audit A · 19 stars
AGENTS.md@crates/orbit-cli AGENTS.md file
constellation-works/orbit · crates/orbit-cli/AGENTS.md
git:20260523.c8e1b11 · audit B · 19 stars
CLAUDE.md@crates/orbit-cli CLAUDE.md file
constellation-works/orbit · crates/orbit-cli/CLAUDE.md
git:20261031.23ea26b · audit A · 19 stars
AGENTS.md@crates/orbit-cmd AGENTS.md file
constellation-works/orbit · crates/orbit-cmd/AGENTS.md
git:20260829.e25929a · audit B · 19 stars
CLAUDE.md@crates/orbit-cmd CLAUDE.md file
constellation-works/orbit · crates/orbit-cmd/CLAUDE.md
git:20261012.2c9dd80 · audit A · 19 stars
AGENTS.md@crates/orbit-common AGENTS.md file
constellation-works/orbit · crates/orbit-common/AGENTS.md
git:20260829.e25929a · audit B · 19 stars
CLAUDE.md@crates/orbit-common CLAUDE.md file
constellation-works/orbit · crates/orbit-common/CLAUDE.md
git:20261024.fda79c7 · audit A · 19 stars
AGENTS.md@crates/orbit-core AGENTS.md file
constellation-works/orbit · crates/orbit-core/AGENTS.md
git:20260829.e25929a · audit B · 19 stars
CLAUDE.md@crates/orbit-core CLAUDE.md file
constellation-works/orbit · crates/orbit-core/CLAUDE.md
git:20261025.a65138b · audit A · 19 stars

Every file in constellation-works/orbit

Other files named DESIGN.md@website

DESIGN.md@website DESIGN.md file
huiliyi37/tianshu-harness · website/DESIGN.md
git:20260731.0dde176 · audit A · 1,254 stars
DESIGN.md@website DESIGN.md file
kitfunso/hippo-memory · website/DESIGN.md
git:20261004.66024d2 · audit A · 791 stars
DESIGN.md@website DESIGN.md file
ginuim/skill-base · website/DESIGN.md · An inspired interpretation of Uber's design language — a transportation-and-delivery super-app brand whose web surface…
alpha · audit A · 121 stars
DESIGN.md@website DESIGN.md file
yannelli/be-concise · website/DESIGN.md · A straightforward developer product site with readable examples, direct actions, and complete documentation.
git:20261031.8144c24 · audit A · 4 stars

Browse by kind, by grade A, or by owner.