DESIGN.mdA

DESIGN.md from mhmtsrfglu/superwiki is a DESIGN.md file: the design rules coding agents follow in that repo.

Install it, pinned
mdr add mhmtsrfglu/superwiki/DESIGN.md@git:20261015.9415b7c

Pins git:20261015.9415b7c in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
DESIGN.md file
Repository
mhmtsrfglu/superwiki
Path
DESIGN.md
Versions recorded
7
Latest version
git:20261015.9415b7c, committed Oct 15, 2026
First version recorded
Oct 7, 2026
Size
70,472 bytes
Repository stars
30
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

# Superwiki design

This file explains why Superwiki works the way it does. How to install and use it is in [README.md](README.md); how to build it is in [CONTRIBUTING.md](CONTRIBUTING.md).

Superwiki is a set of agent skills that turn a project's `docs/` folder into a wiki the coding agent writes and keeps current, with an optional task tracker. The wiki follows the LLM Wiki pattern described by Andrej Karpathy: raw sources, a wiki the agent owns, and a schema that tells the agent how to maintain it.

Contents: [Principles](#principles) · [The vault](#the-vault) · [How a task runs](#how-a-task-runs) · [Why the work is split](#why-the-work-is-split) · [Running many tasks](#running-many-tasks) · [Measuring a session](#measuring-a-session) · [Across agents](#across-agents) · [Viewer and CLI](#viewer-and-cli) · [Migration](#migration) · [Evals](#evals) · [Status](#status)

## Principles

Every decision below follows from one observation: what a task costs is what the agents read, and each step of a session sends everything read so far again.

1. **Little to read.** The only mandatory read is `index.md`. `log.md` is read with `tail`, never whole.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add mhmtsrfglu/superwiki/DESIGN.md@sha256:8168fa98636caaba

The line at the top of this page pins the label git:20261015.9415b7c, 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_sckb45bbc3ip7uzz.svg)](https://markdownregistry.com/a/art_sckb45bbc3ip7uzz)

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

Versions

The registry has recorded 7 versions of this file, between Oct 7, 2026 and Oct 15, 2026, about one every day.

versioncommittedcommitsizeaudit
git:20261015.9415b7c latest2026-10-15 9415b7c 70,472 BA view · diff
git:20261015.f0d67952026-10-15 f0d6795 69,390 BA view · diff
git:20261014.168a56c2026-10-14 168a56c 68,822 BA view · diff
git:20261008.42c67522026-10-08 42c6752 67,806 BA view · diff
git:20261008.fcdf8142026-10-08 fcdf814 67,003 BA view · diff
git:20261008.fa7e7cf2026-10-08 fa7e7cf 61,959 BA view · diff
git:20261007.f92553a2026-10-07 f92553a 53,536 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 (70472 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

mhmtsrfglu/superwiki · 30 stars · license MIT · pushed 2026-10-31 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_sckb45bbc3ip7uzz
GET https://markdownregistry.com/api/v1/resolve?ref=mhmtsrfglu/superwiki/DESIGN.md
GET https://markdownregistry.com/api/v1/blob/8168fa98636caabacf0b71937489718ba69f26af5e522f485d037e0f65b96c47

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 mhmtsrfglu/superwiki

AGENTS.md AGENTS.md file
mhmtsrfglu/superwiki · AGENTS.md
git:20261015.e65e6c7 · audit A · 30 stars
CLAUDE.md CLAUDE.md file
mhmtsrfglu/superwiki · CLAUDE.md
git:20261005.6c37eac · audit B · 30 stars
AGENTS.md@evals/e2e/fixture AGENTS.md file
mhmtsrfglu/superwiki · evals/e2e/fixture/AGENTS.md
git:20261015.e65e6c7 · audit A · 30 stars
CLAUDE.md@evals/e2e/fixture CLAUDE.md file
mhmtsrfglu/superwiki · evals/e2e/fixture/CLAUDE.md
git:20261007.ceee12d · audit B · 30 stars
sw-autopilot SKILL.md skill
mhmtsrfglu/superwiki · skills/sw-autopilot/SKILL.md · Use when the user wants several Superwiki tasks worked through one after another without being asked at each step (run…
git:20261015.9415b7c · audit A · 30 stars
sw-brainstorm SKILL.md skill
mhmtsrfglu/superwiki · skills/sw-brainstorm/SKILL.md · Use when the user has an idea to think through before it is a task, is not sure what to build or what is in scope…
git:20261008.42c6752 · audit A · 30 stars
sw-config SKILL.md skill
mhmtsrfglu/superwiki · skills/sw-config/SKILL.md · Use when the user wants to choose or change which model plans, implements or reviews Superwiki tasks (opus, sonnet, gpt…
git:20261015.f0d6795 · audit A · 30 stars
sw-doctor SKILL.md skill
mhmtsrfglu/superwiki · skills/sw-doctor/SKILL.md · Use when the user wants to make agent sessions lighter or cheaper to start, asks what fills the context window before…
git:20261008.42c6752 · audit A · 30 stars
sw-explain SKILL.md skill
mhmtsrfglu/superwiki · skills/sw-explain/SKILL.md · Use when the user asks what a Superwiki task is for, why it exists, what it depends on, what it blocks or what changes…
git:20261015.e65e6c7 · audit A · 30 stars
sw-implement SKILL.md skill
mhmtsrfglu/superwiki · skills/sw-implement/SKILL.md · Use when the user wants to implement, build, execute, start or continue a Superwiki task or its plan, or invokes…
git:20261031.2a014e1 · audit A · 30 stars
sw-index SKILL.md skill
mhmtsrfglu/superwiki · skills/sw-index/SKILL.md · Use when the user wants the task list in docs/index.md refreshed, updated or rebuilt, says the index is out of date…
git:20261008.42c6752 · audit A · 30 stars
sw-ingest SKILL.md skill
mhmtsrfglu/superwiki · skills/sw-ingest/SKILL.md · Use when the user adds or points to a source (article, paper, transcript, notes, meeting record, PDF, URL, data file)…
git:20261008.42c6752 · audit A · 30 stars

Every file in mhmtsrfglu/superwiki

Other files named DESIGN.md

DESIGN.md DESIGN.md file
garrytan/gstack · DESIGN.md
git:20261104.2ff2d3b · audit A · 140,694 stars
DESIGN.md DESIGN.md file
paperclipai/paperclip · DESIGN.md
git:20261105.56517dd · audit A · 111,624 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 · 106,186 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 · 94,561 stars
DESIGN.md DESIGN.md file
heygen-com/hyperframes · DESIGN.md
git:20260408.fe9cd30 · audit A · 80,701 stars
DESIGN.md DESIGN.md file
cherryhq/cherry-studio · DESIGN.md
git:20261102.a500029 · audit A · 53,286 stars
DESIGN.md DESIGN.md file
garrytan/gbrain · DESIGN.md
git:20260519.3a0e111 · audit A · 31,587 stars
DESIGN.md DESIGN.md file
different-ai/openwork · DESIGN.md
git:20261105.74b7c70 · audit A · 24,407 stars

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