AGENTS.mdA

AGENTS.md from ai-daming/clickvibe is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned
mdr add ai-daming/clickvibe/AGENTS.md@git:20260918.a6b0241

Pins git:20260918.a6b0241 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
AGENTS.md file
Repository
ai-daming/clickvibe
Path
AGENTS.md
Versions recorded
6
Latest version
git:20260918.a6b0241, committed Sep 18, 2026
First version recorded
Aug 25, 2026
Size
11,540 bytes
Repository stars
17
License
none declared

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

# AGENTS.md — ClickVibe 代码治理(改动代码的 Agent 必读)

> 本文件定义任何 agent / 维护者在 ClickVibe 仓库改代码时必须遵守的施工规则。当前有效架构入口是 `docs/architecture.md`;带日期的 `docs/plans/` 仅为历史实施记录。

## 0. 项目是什么

ClickVibe 是一个 DSH Web 插件和 Issue-to-Merge 交付控制面:右侧面板把 GitHub issue 变成「开发 → review → 返工 → 合并」的可恢复异步流水线。Git/GitHub 原生事实决定代码与远端协作状态;本地状态拥有会话、租约和事件等 ClickVibe 自有事实。Agent 可使用完成任务所需的 git/gh 工具;merge 由项目/任务策略与全部门禁共同决定,不再永久限定为人工点击。宿主侧(server)与客户端(client)分居 `src/index.ts` 与 `src/client/index.tsx` 两个 bundle 入口(构建与产物见 `tsdown.config.ts`)。

### 主仓库开发守则

直接在主仓库 checkout 工作的 agent,开始任务前必须先执行 `git fetch origin --prune`,检查遗留冲突(`MERGE_HEAD`)、工作区状态与本地分支落后情况;先同步最新代码并解决冲突,再开始任务。禁止用自动 stash、rebase 或丢弃改动绕过现场。

## 1. 结构三规则(issue #61,机器门禁守护)

**规则一:每文件 ≤500 行(>800 无条件拆)。**
- 以物理行数计;`(500, 800]` 必须可解释:文件首行注释写明理由,或登记 `scripts/file-size-exceptions.json`;>800 直接拒绝。
- 新代码禁止制造超限文件;拆分动作=纯搬移+分层,不得把函数劈成两半跨文件。

**规则二:目录按领域组织,模块依赖单向。**
- 四层架构,层号即依赖上限,文件只能 import 层号 ≤ 自身的模块:

| 层 | 目录 | 职责 | 禁止 |
|---|---|---|---|
| 0 | `src/infra/` | I/O 适配:HTTP 传输、shell/git、进程监督、持久化、流编解码、TTL 门 | import 上层 |
| 1 | `src/github/` | GitHub 适配:`gh api` 读写、REST 映射、仓库/issue/pr/依赖读取 | import workflow/agent |
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add ai-daming/clickvibe/AGENTS.md@sha256:09d15dbd51dafeb5

The line at the top of this page pins the label git:20260918.a6b0241, 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_hwizc2wfo62muycj.svg)](https://markdownregistry.com/a/art_hwizc2wfo62muycj)

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

Versions

The registry has recorded 6 versions of this file, between Aug 25, 2026 and Sep 18, 2026, about one every 5 days.

versioncommittedcommitsizeaudit
git:20260918.a6b0241 latest2026-09-18 a6b0241 11,540 BA view · diff
git:20260829.16733722026-08-29 1673372 11,545 BA view · diff
git:20260829.943b5f32026-08-29 943b5f3 11,149 BA view · diff
git:20260827.157d8d92026-08-27 157d8d9 10,715 BA view · diff
git:20260826.bd1a1e02026-08-26 bd1a1e0 10,472 BA view · diff
git:20260825.7deb6282026-08-25 7deb628 9,520 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 (11540 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

ai-daming/clickvibe · 17 stars · license none declared · pushed 2026-09-21 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_hwizc2wfo62muycj
GET https://markdownregistry.com/api/v1/resolve?ref=ai-daming/clickvibe/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/09d15dbd51dafeb57fca4f48f21d2225a7ec5d5a1a5a9a14adc49f8b3a8d59a4

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: how to write a good AGENTS.md · AGENTS.md vs CLAUDE.md · which agent file does what.

More from ai-daming/clickvibe

CLAUDE.md CLAUDE.md file
ai-daming/clickvibe · CLAUDE.md
git:20260824.c0f0531 · audit A · 17 stars
clickvibe SKILL.md skill
ai-daming/clickvibe · skills/clickvibe/SKILL.md · Trigger ClickVibe pipeline operations (develop / review / rework / resume / sync / stop / merge / status / issues) as…
git:20260822.0e41161 · audit B · 17 stars
gh-issue SKILL.md skill
ai-daming/clickvibe · skills/gh-issue/SKILL.md · Safely create, update, comment on, classify, relate, and close GitHub Issues while preserving the target repository's…
git:20260902.0a05785 · audit A · 17 stars
impl-gate SKILL.md skill
ai-daming/clickvibe · skills/impl-gate/SKILL.md · Decide whether a software change may enter implementation by verifying an accepted architecture baseline, including…
git:20260914.a99d9c0 · audit A · 17 stars
observer SKILL.md skill
ai-daming/clickvibe · skills/observer/SKILL.md · Protocol Observer for ClickVibe engineering loops. This is NOT the per-workflow Runtime Observer: it audits repeated…
git:20260826.bd1a1e0 · audit A · 17 stars
root-cause-review SKILL.md skill
ai-daming/clickvibe · skills/root-cause-review/SKILL.md · Adversarial multi-round code review that digs for root causes instead of verifying the latest patch. Reads the FULL…
git:20260829.1673372 · audit A · 17 stars

Every file in ai-daming/clickvibe

Other files named AGENTS.md

AGENTS.md AGENTS.md file
morluto/rea · AGENTS.md
git:20261102.920d634 · audit A · 433,876 stars
AGENTS.md AGENTS.md file
obra/superpowers · AGENTS.md
git:20261020.b739a8a · audit A · 314,583 stars
AGENTS.md AGENTS.md file
affaan-m/ecc · AGENTS.md
git:20261030.f29e332 · audit A · 299,696 stars
AGENTS.md AGENTS.md file
firecrawl/firecrawl · AGENTS.md
git:20261008.5a75dca · audit A · 199,595 stars
AGENTS.md AGENTS.md file
dietrichgebert/ponytail · AGENTS.md
git:20261008.2a1fe84 · audit A · 185,249 stars
AGENTS.md AGENTS.md file
graphify-labs/graphify · AGENTS.md
git:20260926.98d73fe · audit A · 144,492 stars
AGENTS.md AGENTS.md file
garrytan/gstack · AGENTS.md
git:20261107.ef99eb5 · audit A · 140,694 stars
AGENTS.md AGENTS.md file
juliusbrussee/caveman · AGENTS.md
git:20261106.e45976c · audit A · 118,366 stars

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