Home / nytc69 / review-loop · DESIGN.md · GitHub

DESIGN.md designA

DESIGN.md is agent-read markdown (design) from nytc69/review-loop.

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# <Component / Flow / System> Design

**Status**: Draft | Active | Superseded by <design#anchor>
**Last updated**: 2026-04-19
**Owner**: <who to ask>

## Goals

## Non-goals

## Behavior spec

## Edge cases & error handling

## Interfaces / contracts

## Open questions

## References

<!-- 迁移自 README.md:292-317 via compass:adopt 于 2026-04-19 plan=e2439220c6bd -->
## Migrated — README.md:292-317

## Key Design Features

**Live Reports** — After every review round, the Orchestrator shows you what
the Reviewer found: CRITICAL issues, MINOR suggestions, and the verdict.
You see the value of the review loop in real time.

**Plan Conformance** — The Reviewer checks that the Executor's implementation
stays within the approved plan. Unauthorized design decisions are flagged as
CRITICAL even if the code is technically correct.

**Context File** — All loop state is persisted to
`.review-loop/sessions/{uuid}.md`. Both agents read it each round
for instant context. Session files are preserved permanently — the UUID
is printed in the delivery summary. To trace a bug back to a specific
review session, find the UUID in the delivery output and open the
…

Read the whole file at its exact version.

How to install

Latest version
mdr add nytc69/review-loop/DESIGN.md@git:20260419.3b9deb7
Exact content
mdr add nytc69/review-loop/DESIGN.md@sha256:50913f34007d2a50

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_rbtehlfxczeg3upg.svg)](https://markdownregistry.com/a/art_rbtehlfxczeg3upg)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260419.3b9deb7 latest2026-04-19 3b9deb7 1,713 BA view

Audit of the latest version

A  14 of 14 checks passed. Deterministic, no model, same answer every run.
  • pass: Size between 200 bytes and 200 KB (1713 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

nytc69/review-loop · 3 stars · license Apache-2.0 · pushed 2026-09-23 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_rbtehlfxczeg3upg
GET https://markdownregistry.com/api/v1/resolve?ref=nytc69/review-loop/DESIGN.md
GET https://markdownregistry.com/api/v1/blob/50913f34007d2a5089582e7138fb2304db0db6cb1cc34f9df68c8256ff4358df

Your agent 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.

More from nytc69/review-loop

execute skill
nytc69/review-loop · .agents/skills/execute/SKILL.md · Codex Stage 1 execute skill. Run the execution + quality polish + delivery stages of review-loop against one of three…
git:20260919.2175063 · audit A · 3 stars
guide skill
nytc69/review-loop · .agents/skills/guide/SKILL.md · Codex Stage 1 guide for review-loop and the shared Claude/Codex state model.
git:20260916.8dd269c · audit A · 3 stars
plan skill
nytc69/review-loop · .agents/skills/plan/SKILL.md · Codex Stage 1 planning-only skill. Drives a work item from raw description to a reviewer-approved plan in…
git:20260919.2175063 · audit A · 3 stars
review-loop skill
nytc69/review-loop · .agents/skills/review-loop/SKILL.md · Codex-native Stage 1 review-loop skill. Orchestrates planning and execution with a Codex Executor and Claude/Codex…
git:20260919.2175063 · audit A · 3 stars
CLAUDE.md claude
nytc69/review-loop · CLAUDE.md
git:20260919.2175063 · audit A · 3 stars
code-quality-loop skill
nytc69/review-loop · skills/code-quality-loop/SKILL.md · Iterative review-fix loop: reviews code, auto-fixes issues, repeats until clean or stuck. Finishes with reorganize (for…
git:20260919.2cc1340 · audit A · 3 stars
execute skill
nytc69/review-loop · skills/execute/SKILL.md · Run the execution + quality polish + delivery stages of review-loop against one of three entry modes: resume an…
git:20260916.8dd269c · audit A · 3 stars
guide skill
nytc69/review-loop · skills/guide/SKILL.md · Show review-loop usage guide: how it works, commands, configuration, and key features. Use when the user asks for help…
git:20260916.8dd269c · audit A · 3 stars
plan skill
nytc69/review-loop · skills/plan/SKILL.md · Run the planning phase only: drive a work item from raw description to a reviewer-approved plan in…
git:20260916.8dd269c · audit A · 3 stars
reorganize skill
nytc69/review-loop · skills/reorganize/SKILL.md · Reorganize code file structure: rearrange modules, extract reuse, remove redundancy, add section comments. Preserves…
git:20260402.b86bf98 · audit A · 3 stars
review-loop skill
nytc69/review-loop · skills/review-loop/SKILL.md · Automates a Plan-Execute-Review workflow with built-in iteration loops. An Orchestrator coordinates an Executor…
git:20260916.8dd269c · audit A · 3 stars
review-pr skill
nytc69/review-loop · skills/review-pr/SKILL.md · Comprehensive code review using specialized agents. Each agent focuses on a different quality aspect (code, errors…
git:20260919.2cc1340 · audit A · 3 stars

Every file in nytc69/review-loop

Other files named DESIGN.md

DESIGN.md design
garrytan/gstack · DESIGN.md
git:20260909.c8f0c4e · audit A · 134,082 stars
DESIGN.md design
tt-a1i/archify · DESIGN.md · A precise, vivid technical instrument for trustworthy interactive architecture maps.
git:20260817.a0bc059 · audit A · 71,092 stars
DESIGN.md design
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 · 70,779 stars
DESIGN.md design
heygen-com/hyperframes · DESIGN.md
git:20260408.fe9cd30 · audit A · 52,820 stars
DESIGN.md design
cherryhq/cherry-studio · DESIGN.md
git:20260819.300ab2e · audit A · 52,106 stars
DESIGN.md design
amruthpillai/reactive-resume · DESIGN.md · A monochrome, content-first design system for a free and open-source resume builder. Dark-by-default with light mode…
alpha · audit A · 43,394 stars
DESIGN.md design
reactive-resume/app · DESIGN.md · A monochrome, content-first design system for a free and open-source resume builder. Dark-by-default with light mode…
alpha · audit A · 43,367 stars
DESIGN.md design
garrytan/gbrain · DESIGN.md
git:20260519.3a0e111 · audit A · 30,275 stars

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