DESIGN.mdA

DESIGN.md from huangpufan/ssot-skill is a DESIGN.md file: the design rules coding agents follow in that repo.

Install it, pinned

mdr add huangpufan/ssot-skill/DESIGN.md@git:20261106.92c0365

Pins git:20261106.92c0365 in mdr.lock. Pin the fingerprint instead.

Audit grade: A, 14 of 14 checks passed
Kind: DESIGN.md file
Repository: huangpufan/ssot-skill
Path: DESIGN.md
Versions recorded: 5
Latest version: git:20261106.92c0365, committed Nov 6, 2026
First version recorded: Oct 26, 2026
Size: 6,946 bytes
Repository stars: 11
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

# Design: why SSOT Skill is shaped this way

This file records the design inherited from version 3 and the ownership changes in version 4, so that later changes do not quietly rebuild what it removed. How to change the protocol is in [CONTRIBUTING.md](./CONTRIBUTING.md#changing-the-protocol). What a consumer's `SSOT/` contains is in [memory-model.md](./skills/ssot-preflight/references/memory-model.md).

## The job

A coding agent starts every session without the history of the project. SSOT Skill gives each repository a small, maintained memory: what the project is for, how it works, which rules people decided, why things are the way they are, and where the traps are. The next agent reads it before working and updates it when something durable changes. The bundle's value is that this reading and updating cost less than the mistakes they prevent.

## What happened in v2

Version 2 grew from 0.8 MB of skills (2.50, June 2026) to 1.9 MB (2.86, October 2026), and its lint script grew from 50 KB to 400 KB of Bash. There were 36 protocol versions in four months. Most later commits reconciled clauses that earlier fixes had made inconsistent.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint

mdr add huangpufan/ssot-skill/DESIGN.md@sha256:6bec1d3d3bd8ea7c

The line at the top of this page pins the label git:20261106.92c0365, 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](https://markdownregistry.com/badge/art_mu3zsvjld2es3viv.svg)](https://markdownregistry.com/a/art_mu3zsvjld2es3viv)

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

Versions

The registry has recorded 5 versions of this file, between Oct 26, 2026 and Nov 6, 2026, about one every 3 days.

version	committed	commit	size	audit
git:20261106.92c0365 latest	2026-11-06	92c0365	6,946 B	A	view · diff
git:20261029.40a6315	2026-10-29	40a6315	4,388 B	A	view · diff
git:20261027.8fc8635	2026-10-27	8fc8635	4,085 B	A	view · diff
git:20261026.4713c7f	2026-10-26	4713c7f	4,136 B	A	view · diff
git:20261026.974847a	2026-10-26	974847a	4,085 B	A	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 (6946 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

huangpufan/ssot-skill · 11 stars · license MIT · pushed 2026-11-06 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_mu3zsvjld2es3viv
GET https://markdownregistry.com/api/v1/resolve?ref=huangpufan/ssot-skill/DESIGN.md
GET https://markdownregistry.com/api/v1/blob/6bec1d3d3bd8ea7c88fe882195b692c814081ff27d872505ab834ea7660d1c48

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 huangpufan/ssot-skill

AGENTS.md AGENTS.md file

huangpufan/ssot-skill · AGENTS.md

git:20261106.92c0365 · audit B · 11 stars

ssot-audit SKILL.md skill

huangpufan/ssot-skill · skills/ssot-audit/SKILL.md · Compatibility name for catching a repository's SSOT up on past commits. Use only when a prompt or an instruction file…

git:20261027.8fc8635 · audit A · 11 stars

ssot-bootstrap SKILL.md skill

huangpufan/ssot-skill · skills/ssot-bootstrap/SKILL.md · Create, continue, or migrate a repository's SSOT. Use when the user agrees to create SSOT for a repository that has…