DESIGN.mdA
DESIGN.md from lukethecat/aperture is a DESIGN.md file: the design rules coding agents follow in that repo.
mdr add lukethecat/aperture/DESIGN.md@git:20260804.56d7759Pins git:20260804.56d7759 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 14 of 14 checks passed
- Kind
- DESIGN.md file
- Repository
- lukethecat/aperture
- Path
DESIGN.md- Versions recorded
- 3
- Latest version
- git:20260804.56d7759, committed Aug 4, 2026
- First version recorded
- Aug 3, 2026
- Size
- 4,105 bytes
- Repository stars
- 6
- 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 Notes ## Two core principles 1. **Prescreen wide, review strict, pool with dedup.** Precision comes from the second-pass review and deduplication, not from an over-tight first filter. The first stage is cheap and rules-based; the second stage can use an LLM; the pool stage collapses duplicates so the final report stays readable. 2. **Everything goes to the tape, append-only.** The tape is the single source of truth. Source snapshots, items at every stage, profile versions, evolution records, feedback, and reports are all stored as JSONL lines. This makes the system debuggable, auditable, and replayable months later. ## Four-stage pipeline: collect → edit → review → publish ### collect (scanner) For each configured source, fetch its list page, extract titles and URLs, normalize URLs, and diff against the previous snapshot. Only newly appearing URLs become candidates. Why diff against the frontpage instead of parsing publish times? Because a frontpage diff is robust across sources with inconsistent timestamps or anti-scraping layouts. ### edit (prescreen) Score each candidate with a simple rule: ``` score = sum(matched keyword weights) …
Read the whole file at its exact version.
How to install
mdr add lukethecat/aperture/DESIGN.md@sha256:8acfbf8866e48f40The line at the top of this page pins the label git:20260804.56d7759, 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.
[](https://markdownregistry.com/a/art_dm6nhm24tcva2gi5)
1 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 3 versions of this file, between Aug 3, 2026 and Aug 4, 2026, more than one a day.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260804.56d7759 latest | 2026-08-04 | 56d7759 | 4,105 B | A | view · diff |
| git:20260803.075c721 | 2026-08-03 | 075c721 | 4,051 B | A | view · diff |
| git:20260803.b6a59de | 2026-08-03 | b6a59de | 3,649 B | A | view |
Audit of the latest version
- pass: Size between 200 bytes and 200 KB (4105 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
lukethecat/aperture · 6 stars · license MIT · pushed 2026-10-21 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_dm6nhm24tcva2gi5 GET https://markdownregistry.com/api/v1/resolve?ref=lukethecat/aperture/DESIGN.md GET https://markdownregistry.com/api/v1/blob/8acfbf8866e48f400feb8603a6758cf853ea28743cc3e0a6c76fe6493e7999c7
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 lukethecat/aperture
Every file in lukethecat/aperture