DESIGN.mdA

DESIGN.md from nebius/nebius-physical-ai is a DESIGN.md file: the design rules coding agents follow in that repo.

Install it, pinned
mdr add nebius/nebius-physical-ai/DESIGN.md@git:20260906.525ee24

Pins git:20260906.525ee24 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
DESIGN.md file
Repository
nebius/nebius-physical-ai
Path
DESIGN.md
Versions recorded
4
Latest version
git:20260906.525ee24, committed Sep 6, 2026
First version recorded
Jul 31, 2026
Size
43,327 bytes
Repository stars
45
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

# DESIGN — real parallel execution and real runtime control flow for `npa.workflow/v0.0.1`

This document covers the two tiers added to the `npa.workflow` engine:

1. **Parallel execution** — a spec can declare a fan-out group that launches as
   genuinely concurrent SkyPilot jobs, with a barrier and bounded concurrency.
2. **Runtime control flow** — an orchestrator above `build_scheduler_task` that
   submits a wave, polls it to a terminal state, reads the *actual* decision
   artifact from S3, and replans: real early-exit, real data-dependent branching,
   retry/idempotency/resume, and a trigger/watch pattern.

Both are **additive and opt-in**. Every pre-existing spec plans, renders and
submits exactly as before, and the plan-time `--assume-decision` path is retained
as the offline/plan-only mode.

---

## 1. Where the engine was

| Layer | Behaviour before this change |
| --- | --- |
| `interpreter.build_plan` | Statically unrolls loops (`for iteration in range(1, max+1)`) into a flat serial plan; the loop-exit predicate is fed a **plan-time assumption** (`--assume-decision`) |
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add nebius/nebius-physical-ai/DESIGN.md@sha256:d48ac809caf26d1e

The line at the top of this page pins the label git:20260906.525ee24, 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_br2hdulkvod2wgqw.svg)](https://markdownregistry.com/a/art_br2hdulkvod2wgqw)

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

Versions

The registry has recorded 4 versions of this file, between Jul 31, 2026 and Sep 6, 2026, about one every 13 days.

versioncommittedcommitsizeaudit
git:20260906.525ee24 latest2026-09-06 525ee24 43,327 BA view · diff
git:20260830.7e837812026-08-30 7e83781 43,323 BA view · diff
git:20260802.5fa17712026-08-02 5fa1771 41,737 BA view · diff
git:20260731.aa555d72026-07-31 aa555d7 23,593 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 (43327 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

nebius/nebius-physical-ai · 45 stars · license Apache-2.0 · pushed 2026-10-20 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_br2hdulkvod2wgqw
GET https://markdownregistry.com/api/v1/resolve?ref=nebius/nebius-physical-ai/DESIGN.md
GET https://markdownregistry.com/api/v1/blob/d48ac809caf26d1e818e49d72acdaf3cda18c06aabe69c2ffc1147af8672f261

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 nebius/nebius-physical-ai

.cursorrules Cursor rule
nebius/nebius-physical-ai · .cursorrules
git:20260703.ce2e3a8 · audit A · 45 stars
AGENTS.md AGENTS.md file
nebius/nebius-physical-ai · AGENTS.md
git:20261018.f0ea799 · audit A · 45 stars
CLAUDE.md CLAUDE.md file
nebius/nebius-physical-ai · CLAUDE.md
git:20261018.f0ea799 · audit A · 45 stars
access-approval SKILL.md skill
nebius/nebius-physical-ai · skills/atomic/access-approval/SKILL.md · Prepare, verify, and resume operator-owned Hugging Face or NVIDIA NGC access for exact NPA dependencies, including…
git:20260912.c87fdb2 · audit A · 45 stars
agent-development SKILL.md skill
nebius/nebius-physical-ai · skills/atomic/agent-development/SKILL.md · Use when building, enhancing, or testing the NPA chat agent backend — grounded-first routing, cost-aware Token Factory…
git:20261003.bd54c8c · audit A · 45 stars
agent-run-data-collection SKILL.md skill
nebius/nebius-physical-ai · skills/atomic/agent-run-data-collection/SKILL.md · Use when collecting NPA agent work for fine-tuning or evaluation so every goal-level episode emits a sanitized…
git:20260906.2f687b4 · audit A · 45 stars
agent-visual-feedback SKILL.md skill
nebius/nebius-physical-ai · skills/atomic/agent-visual-feedback/SKILL.md · Use when the NPA agent should describe or critique the current viewer (Rerun, video, image, or data) via the Describe…
git:20260906.4539e93 · audit A · 45 stars
architecture SKILL.md skill
nebius/nebius-physical-ai · skills/atomic/architecture/SKILL.md · Use for Claude Code architectural review of the Nebius Physical AI platform, workbench layer, orchestrator choices, and…
git:20260906.2f687b4 · audit A · 45 stars
audit-container-docs SKILL.md skill
nebius/nebius-physical-ai · skills/atomic/audit-container-docs/SKILL.md · Reconcile NPA container-image catalogs and related documentation whenever a workbench image or solution is added…
git:20260827.6716731 · audit A · 45 stars
build-and-push-image SKILL.md skill
nebius/nebius-physical-ai · skills/atomic/build-and-push-image/SKILL.md · Use when building, tagging, validating, or publishing NPA workbench container images through immutable full-SHA public…
git:20260906.2f687b4 · audit A · 45 stars
contributions SKILL.md skill
nebius/nebius-physical-ai · skills/atomic/contributions/SKILL.md · Write or review NPA contributions, including workbench agent changes, using the repository's readability…
git:20260907.370e595 · audit A · 45 stars
cosmos3-codebase-nav SKILL.md skill
nebius/nebius-physical-ai · skills/atomic/cosmos3-codebase-nav/SKILL.md · Use when navigating the Cosmos3 integration in NPA or locating upstream Cosmos3 framework files, defaults, scripts…
git:20260906.a7b9ddb · audit A · 45 stars

Every file in nebius/nebius-physical-ai

Other files named DESIGN.md

DESIGN.md DESIGN.md file
garrytan/gstack · DESIGN.md
git:20260909.c8f0c4e · audit A · 136,966 stars
DESIGN.md DESIGN.md file
paperclipai/paperclip · DESIGN.md
git:20261009.417db14 · audit A · 105,684 stars
DESIGN.md DESIGN.md file
tt-a1i/archify · DESIGN.md · A precise, vivid technical instrument for trustworthy interactive architecture maps.
git:20260817.a0bc059 · audit A · 85,866 stars
DESIGN.md DESIGN.md file
pbakaus/impeccable · DESIGN.md · Neo kinpaku system. Two brand anchors, kinpaku gold and verdigris patina, sit on dark warm-black lacquer. Restraint in…
git:20260721.d7d1027 · audit A · 83,565 stars
DESIGN.md DESIGN.md file
heygen-com/hyperframes · DESIGN.md
git:20260408.fe9cd30 · audit A · 67,662 stars
DESIGN.md DESIGN.md file
cherryhq/cherry-studio · DESIGN.md
git:20260819.300ab2e · audit A · 52,815 stars
DESIGN.md DESIGN.md file
garrytan/gbrain · DESIGN.md
git:20260519.3a0e111 · audit A · 31,074 stars
DESIGN.md DESIGN.md file
different-ai/openwork · DESIGN.md
git:20261013.6d48e23 · audit A · 24,200 stars

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