Report · marked 10 Oct 2026

clash-verge-rev/clash-verge-rev

Ready for an agent to work in without hand-holding.

Rust · 150,301 stars · 746 files · branch dev

91 /100 A

Instructions 21/27Whether the repo tells an agent how to behave before it starts guessing. Losing marks on instruction quality.Setup 16/16Whether an agent can install the project and get it running without a human. Full marks.Verification loop 20/22Whether an agent can check its own work. This is the category that most decides whether agent output is trustworthy. Losing marks on tests exist.Context economy 19/20Whether the repo fits in a context window, or fights it. Losing marks on repository weight.Navigability 10/10How quickly anything new can orient itself. Full marks.

Higher is better. Accent marks what is costing you most.

Fix these first

Instruction quality

Worth fixing: it never states a build, test, or run command; has no code blocks.

The full marking

Every deduction below names the file or setting it came from.

Instructions 21/27 A-

Whether the repo tells an agent how to behave before it starts guessing.

✓Agent instruction file 12/12

AGENTS.md is present, which is the format the most tools read.

Also found: CLAUDE.md

✗Instruction quality 6/12

Real instructions, with gaps.

Worth fixing: it never states a build, test, or run command; has no code blocks.

3,724 characters, a workable length

uses headings, so an agent can skim it

✓README as an entry point 3/3

README has a clear getting-started section.

Setup 16/16 A+

Whether an agent can install the project and get it running without a human.

✓Deterministic install 6/6

pnpm-lock.yaml pins the dependency tree.

Found pnpm-lock.yaml

✓Discoverable commands 6/6

Commands are declared where an agent will look for them.

package.json scripts (prepare, dev, dev:service, dev:sidecar, dev:diff, dev:trace…)

scripts/ directory

–Environment config n/a

Not applicable — this reads as a library, with no environment to configure.

✓Pinned runtime version 2/2

The language runtime version is pinned.

Found .tool-versions

✓Reproducible environment 2/2

.devcontainer/devcontainer.json gives a known-good environment.

Verification loop 20/22 A

Whether an agent can check its own work. This is the category that most decides whether agent output is trustworthy.

✗Tests exist 6/8

22 test files against 432 source files.

e.g. .github/workflows/autobuild-check-test.yml, .github/workflows/signpath-test.yml, crates/clash-verge-draft/tests/test_me.rs

✓Test command is discoverable 7/7

An agent can find and run `npm run test`.

✓Continuous integration 4/4

19 GitHub Actions workflows define what "passing" means.

✓Lint and format rules 3/3

eslint.config.ts encodes the house style.

–Static type checking n/a

Not applicable — the Rust compiler type checks every build.

Context economy 19/20 A+

Whether the repo fits in a context window, or fights it.

✓No committed build output 6/6

No generated directories committed.

✓.gitignore hygiene 3/3

.gitignore covers 19 patterns.

✓File sizes fit in context 6/6

No source file is large enough to crowd out a context window.

✗Repository weight 4/5

About 87.1MB checked out, which is comfortable.

Here is your AGENTS.md

Drafted from what is actually in this repository: the install command from your lockfile, the commands you already declare, your real directory layout. Anything marked TODO needs a person. Save it at the root as AGENTS.md.

AGENTS.md — drafted for clash-verge-rev/clash-verge-rev

# AGENTS.md

A modern GUI client based on Tauri, designed to run in Windows, macOS and Linux for tailored proxy experience

## Setup

```
pnpm install
```

## Commands

```
pnpm dev           # run locally
pnpm build         # produce a build
pnpm test          # run the test suite, must pass before any commit
pnpm typecheck     # type check without emitting
pnpm lint          # lint
pnpm format        # format
pnpm prepare
pnpm dev:service
```

## Layout

- `src/`              250 source files
- `src-tauri/`        126 source files
- `scripts/`          26 source files
- `crates/`           25 source files
- `scripts-workflow/` 3 source files

## Conventions

- Tests live alongside the code they cover, following `.github/workflows/autobuild-check-test.yml`.
- TypeScript runs in strict mode. Type errors are the fastest feedback available, so do not weaken it.
- CI defines what passing means. See `.github/workflows/ai-slop-gate.yml`, and keep it green.
- TODO: add the two or three conventions a newcomer always gets wrong here.

---

Drafted by agentreadme.com from what is in this repository. Everything marked TODO
needs a human. Check it in as AGENTS.md at the root.

Open the raw markdown or curl -o AGENTS.md agentreadme.com/draft/clash-verge-rev/clash-verge-rev.md

A draft gets the commands right and stops at the things only a maintainer knows. What a good Rust AGENTS.md looks like covers what to add by hand, and what AGENTS.md is explains the format itself.

Show the mark

The badge re-checks daily, so it keeps up as the repository changes. Use mark again to force it now.

[![agent ready](https://agentreadme.com/badge/clash-verge-rev/clash-verge-rev.svg)](https://agentreadme.com/clash-verge-rev/clash-verge-rev)

Other Rust repositories, marked

ultraworkers/claw-code 71 B+ farion1231/cc-switch 63 B openai/codex 61 B- rustdesk/rustdesk 72 B+ rust-lang/rust 65 B tauri-apps/tauri 64 B

All Rust repositories

Think this mark is wrong?

Every deduction above names the file it came from, so this can be settled by looking. If a check missed something, that is a rule worth fixing.

Open an issue, already filled in