DESIGN.md@docs/desktopA

DESIGN.md@docs/desktop from ulises-jeremias/agent-toolkit is a DESIGN.md file: the design rules coding agents follow in that repo.

Install it, pinned
mdr add ulises-jeremias/agent-toolkit/docs/desktop/DESIGN.md@git:20261016.a0c27e9

Pins git:20261016.a0c27e9 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
DESIGN.md file
Repository
ulises-jeremias/agent-toolkit
Path
docs/desktop/DESIGN.md
Versions recorded
17
Latest version
git:20261016.a0c27e9, committed Oct 16, 2026
First version recorded
Sep 7, 2026
Size
23,022 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

# Agent Toolkit Desktop Design Contract

**Status: CURRENT CONTRACT** — governing visual and interaction design
direction for Agent Toolkit Desktop. **Visual reset adopted 2026-09-30**
([ADR-035](../adrs/ADR-035-cozy-pixel-world.md)): the **Cozy Pixel World**
language is the single visual contract. The previous Paper Co. language is
deprecated and survives only in git history.

This document defines how Agent Toolkit Desktop should look, feel, and present
information. It complements [PRODUCT_VISION.md](PRODUCT_VISION.md),
[UX_ARCHITECTURE.md](UX_ARCHITECTURE.md), [USER_JOURNEYS.md](USER_JOURNEYS.md),
[workflows.yaml](workflows.yaml), [VISUAL_QA.md](VISUAL_QA.md), and
[SEMANTIC_WORLD.md](SEMANTIC_WORLD.md). It is not an executable token file and
it does not override Engine truth, accessibility, or platform constraints.

The goal is simple:

> A real developer workstation presented as a **beautiful, cozy top-down
> pixel world**. The world is the screen. The menus feel like the world.
> Nothing on screen lies.

## 0. North Star

Agent Toolkit Desktop should feel like opening a polished classic top-down
pixel game — and then discovering it is an extremely capable developer
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add ulises-jeremias/agent-toolkit/docs/desktop/DESIGN.md@sha256:dc7a63499dddcd0d

The line at the top of this page pins the label git:20261016.a0c27e9, 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_cadq7rwnnzuheziv.svg)](https://markdownregistry.com/a/art_cadq7rwnnzuheziv)

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

Versions

The registry has recorded 17 versions of this file, between Sep 7, 2026 and Oct 16, 2026, about one every 2 days.

versioncommittedcommitsizeaudit
git:20261016.a0c27e9 latest2026-10-16 a0c27e9 23,022 BA view · diff
git:20261016.8ed980b2026-10-16 8ed980b 22,962 BA view · diff
git:20261011.d8a9e3f2026-10-11 d8a9e3f 22,803 BA view · diff
git:20261009.4f7ffd62026-10-09 4f7ffd6 22,723 BA view · diff
git:20261009.30b2df12026-10-09 30b2df1 22,664 BA view · diff
git:20261009.6648c5b2026-10-09 6648c5b 22,509 BA view · diff
git:20261005.cc73e402026-10-05 cc73e40 22,412 BA view · diff
git:20261005.96ddd3f2026-10-05 96ddd3f 22,335 BA view · diff
git:20261002.0b944e52026-10-02 0b944e5 22,199 BA view · diff
git:20261002.f537f802026-10-02 f537f80 21,776 BA view · diff
git:20261001.79828d92026-10-01 79828d9 21,788 BA view · diff
git:20260930.084802d2026-09-30 084802d 22,570 BA view · diff
git:20260930.04f7dc32026-09-30 04f7dc3 21,947 BA view · diff
git:20260930.c3d97e42026-09-30 c3d97e4 21,933 BA view · diff
git:20260913.6bf289b2026-09-13 6bf289b 20,502 BA view · diff
git:20260907.b35d3542026-09-07 b35d354 20,442 BA view · diff
git:20260907.741d7b42026-09-07 741d7b4 17,957 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 (23022 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

ulises-jeremias/agent-toolkit · 19 stars · license MIT · pushed 2026-11-02 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_cadq7rwnnzuheziv
GET https://markdownregistry.com/api/v1/resolve?ref=ulises-jeremias/agent-toolkit/docs/desktop/DESIGN.md
GET https://markdownregistry.com/api/v1/blob/dc7a63499dddcd0d8aad33ff1006750e18c80019ed76dfe5384647686748b7f0

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 ulises-jeremias/agent-toolkit

AGENTS.md AGENTS.md file
ulises-jeremias/agent-toolkit · AGENTS.md
git:20261006.fc09e96 · audit A · 19 stars
AGENTS.md@plugins/agent-toolkit-agents AGENTS.md file
ulises-jeremias/agent-toolkit · plugins/agent-toolkit-agents/AGENTS.md
git:20260831.856ee57 · audit A · 19 stars
adr SKILL.md skill
ulises-jeremias/agent-toolkit · plugins/agent-toolkit-complete/.github/skills/adr/SKILL.md · WHAT — Create and maintain Architecture Decision Records (ADRs) per the process. Covers when
git:20260901.5d17d6a · audit A · 19 stars
agreement SKILL.md skill
ulises-jeremias/agent-toolkit · plugins/agent-toolkit-complete/.github/skills/agreement/SKILL.md · WHAT - Capture explicit agreements, terms, parties involved, dates, validity, and linked
git:20260831.856ee57 · audit A · 19 stars
architecture-diagram SKILL.md skill
ulises-jeremias/agent-toolkit · plugins/agent-toolkit-complete/.github/skills/architecture-diagram/SKILL.md · WHAT — Create polished dark-themed architecture diagrams as self-contained HTML+SVG files (inline SVG, CSS styling…
v1.0.0 · audit B · 19 stars
assistant SKILL.md skill
ulises-jeremias/agent-toolkit · plugins/agent-toolkit-complete/.github/skills/assistant/SKILL.md · Assistant — on any repo, scan README→docs→AGENTS→CONTRIBUTING→PR templates→task runners→devcontainer→CI→configs
v2.1 · audit A · 19 stars
aws-well-architected-review SKILL.md skill
ulises-jeremias/agent-toolkit · plugins/agent-toolkit-complete/.github/skills/aws-well-architected-review/SKILL.md · WHAT — AWS Well-Architected Framework review (6 pillars) — operational excellence, security, reliability, performance…
v1.0 · audit A · 19 stars
blast-radius SKILL.md skill
ulises-jeremias/agent-toolkit · plugins/agent-toolkit-complete/.github/skills/blast-radius/SKILL.md · Find what a change could break somewhere else before it ships, beyond the diff, and prove
git:20261016.f2102cf · audit A · 19 stars
brag-slim SKILL.md skill
ulises-jeremias/agent-toolkit · plugins/agent-toolkit-complete/.github/skills/brag-slim/SKILL.md · Turn a project directory or a website URL into a short, shareable launch video with music, motion, and share copy. One…
git:20260930.f5435b6 · audit A · 19 stars
brag SKILL.md skill
ulises-jeremias/agent-toolkit · plugins/agent-toolkit-complete/.github/skills/brag/SKILL.md · Turn the current project website into a short, polished, shareable launch video using Hyperframes. Use when someone…
git:20260930.f5435b6 · audit A · 19 stars
bug SKILL.md skill
ulises-jeremias/agent-toolkit · plugins/agent-toolkit-complete/.github/skills/bug/SKILL.md · WHAT - Draft and review bugs using the Bug Template; classifies whether an issue should be
git:20260831.856ee57 · audit A · 19 stars
c4-model SKILL.md skill
ulises-jeremias/agent-toolkit · plugins/agent-toolkit-complete/.github/skills/c4-model/SKILL.md · WHAT — C4 model methodology (Context, Container, Component, Code) guidance — what to draw at each level, when, and how…
v1.0 · audit A · 19 stars

Every file in ulises-jeremias/agent-toolkit

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