DESIGN.md@docsA

This file is byte-identical to the first copy the registry indexed, one of 3 indexed copies. Same content hash, so the same checks give both the same grade.

DESIGN.md@docs from pinto-notes/pinto-notes is a DESIGN.md file: the design rules coding agents follow in that repo.

Install it, pinned
mdr add pinto-notes/pinto-notes/docs/DESIGN.md@git:20261016.19bb864

Pins git:20261016.19bb864 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
DESIGN.md file
Repository
pinto-notes/pinto-notes
Path
docs/DESIGN.md
Versions recorded
6
Latest version
git:20261016.19bb864, committed Oct 16, 2026
First version recorded
Oct 13, 2026
Size
10,141 bytes
Repository stars
27
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

# Pinto Notes design rules

One set of rules for the app (Mac and iPhone), the website and the emails. If a screen breaks one, the screen changes, not the rule. To change a rule, change this file first, in its own commit, with the reason.

## The bar

People pick a notes app because it looks lovely. Each surface should look like someone cared about every pixel: every state has been designed (hover, press, focus, disabled, empty, loading, done), every icon sits on the same grid, and nothing moves unless the motion says something.

Apple Notes is still the reference for behaviour, and Apple's Human Interface Guidelines are still the floor. These rules decide the look on top of that floor.

## Our signature

1. **Paper-craft illustrations.** Warm, tactile, cut-paper scenes, one per moment: the Templates cards, the email heroes, the sign-in leaf. This is the thing people remember, and no one else has it. Use one where a screen has a moment: a welcome, an empty state, a finished import, an email, a section of the home page. Never use one inside a working view such as the note list or the editor.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add pinto-notes/pinto-notes/docs/DESIGN.md@sha256:d429bcd5ad08eebf

The line at the top of this page pins the label git:20261016.19bb864, 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_pk2nwscl2khrmv3h.svg)](https://markdownregistry.com/a/art_pk2nwscl2khrmv3h)

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

Versions

The registry has recorded 6 versions of this file, between Oct 13, 2026 and Oct 16, 2026, more than one a day.

versioncommittedcommitsizeaudit
git:20261016.19bb864 latest2026-10-16 19bb864 10,141 BA view · diff
git:20261014.2db60412026-10-14 2db6041 9,919 BA view · diff
git:20261014.b30e9262026-10-14 b30e926 9,226 BA view · diff
git:20261014.e17e7f82026-10-14 e17e7f8 9,691 BA view · diff
git:20261013.906240e2026-10-13 906240e 9,004 BA view · diff
git:20261013.7ec25a52026-10-13 7ec25a5 8,639 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 (10141 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

pinto-notes/pinto-notes · 27 stars · license MIT · pushed 2026-10-21 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_pk2nwscl2khrmv3h
GET https://markdownregistry.com/api/v1/resolve?ref=pinto-notes/pinto-notes/docs/DESIGN.md
GET https://markdownregistry.com/api/v1/blob/d429bcd5ad08eebf572a762f567b42d8e936a9125a788707f0ccdd32f2b83301

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 pinto-notes/pinto-notes

amber-release-gate SKILL.md skill
pinto-notes/pinto-notes · .agents/skills/amber-release-gate/SKILL.md · Run the Pinto Notes release gate (performance, security, storage and network) on a candidate commit and read its…
git:20261011.c3c3cf7 · audit A · 27 stars
AGENTS.md AGENTS.md file
pinto-notes/pinto-notes · AGENTS.md
git:20261013.a28cffa · audit A · 27 stars
CLAUDE.md CLAUDE.md file
pinto-notes/pinto-notes · CLAUDE.md
git:20260929.eb991c2 · audit B · 27 stars
AGENTS.md@plugins/amber-notes AGENTS.md file
pinto-notes/pinto-notes · plugins/amber-notes/AGENTS.md
git:20261014.2f5aeb6 · audit A · 27 stars
amber-notes SKILL.md skill
pinto-notes/pinto-notes · plugins/amber-notes/skills/amber-notes/SKILL.md · Use the person's notes in Pinto Notes (pintonotes.com, formerly Amber Notes) through the amber-notes MCP server. Use…
git:20261013.b08ba54 · audit A · 27 stars
note-pages SKILL.md skill
pinto-notes/pinto-notes · plugins/amber-notes/skills/note-pages/SKILL.md · Build, change, check and fill the apps in Pinto Notes notes (a note's App side: habit trackers, budgets, reading or…
git:20261013.a711814 · audit A · 27 stars
pinto-notes SKILL.md skill
pinto-notes/pinto-notes · plugins/grok/pinto-notes/skills/pinto-notes/SKILL.md · Use the person's notes in Pinto Notes (pintonotes.com) through the pinto-notes MCP server. Use when they mention their…
git:20261013.df7a785 · audit A · 27 stars

Every file in pinto-notes/pinto-notes

Other files named DESIGN.md@docs

DESIGN.md@docs DESIGN.md file
mvschwarz/openrig · docs/DESIGN.md
git:20261005.f6358a2 · audit A · 7,989 stars
DESIGN.md@docs DESIGN.md file
geekjourneyx/md2wechat-skill · docs/DESIGN.md
git:20260319.1e4d509 · audit A · 3,754 stars
DESIGN.md@docs DESIGN.md file
keli-wen/agy-staff · docs/DESIGN.md
git:20261007.65a1ab4 · audit A · 765 stars
DESIGN.md@docs DESIGN.md file
1ay1/agentty · docs/DESIGN.md
git:20261010.227e92e · audit A · 623 stars
DESIGN.md@docs DESIGN.md file
vintlin/skill-flow · docs/DESIGN.md · A compact macOS operations workspace built from layered neutral surfaces, user-selectable accents, reusable group…
beta · audit A · 264 stars
DESIGN.md@docs DESIGN.md file
mobileaidev/ai-app-bridge · docs/DESIGN.md
git:20261012.3200529 · audit A · 227 stars
DESIGN.md@docs DESIGN.md file
shellishack/infinite-pokemon · docs/DESIGN.md
git:20260914.2f240d9 · audit A · 187 stars
DESIGN.md@docs DESIGN.md file
ghalebdweikat/winnow · docs/DESIGN.md
git:20261006.4547a81 · audit A · 115 stars

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