CLAUDE.mdA

CLAUDE.md from adw-19/build_a_product_agent is a CLAUDE.md file: the standing instructions Claude Code reads in that repo.

Install it, pinned
mdr add adw-19/build_a_product_agent/CLAUDE.md@git:20260918.82c2ad4

Pins git:20260918.82c2ad4 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
CLAUDE.md file
Repository
adw-19/build_a_product_agent
Path
CLAUDE.md
Versions recorded
7
Latest version
git:20260918.82c2ad4, committed Sep 18, 2026
First version recorded
Aug 27, 2026
Size
8,216 bytes
Repository stars
117
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

# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## 项目本质(README 概览之外)

这是一个**纯文档项目**——没有源码、没有依赖、没有构建/测试命令,内容是一份面向开发者的中文技术手册,主题是"如何从零构建生产级 AI Agent 后端"。所有内容在 `docs/` 下,全部为简体中文 Markdown。

唯一的"可执行部分"是 `scripts/check_snippets.py`(文档代码块静态校验闸门),它校验的是文档里的代码块,不是项目源码。因此本项目的"开发任务"几乎都是**写/改 Markdown 文章**,而非写代码。代码块只是文章内容的一部分(示例代码)。

- 作者:Andy Yanqi Wang (ADW-19),中国,上海市,浦东新区,陆家嘴
- 许可:MIT
- 提交信息使用中文(如 `增加AI Infra章节`)
- 英文版:根目录和 `docs/01-首页/` 下有 `README-en.md` 落地页;正文英文版暂未发布(TBD)。新增正文无需同步英文。

## 目录与编号规范

`docs/` 下共 4 个一级目录,按"第 N 章"连续编号展开(一章一个二级目录):

```
build_a_product_agent/
├── scripts/
│   └── check_snippets.py            # 文档代码块校验闸门(语法 / YAML / 语言标注 / 已弃用 API)
└── docs/
    ├── 01-首页/                     # 落地页 README(中英各一份)
    ├── 02-生产级开发-通用知识/       # 第1~4章
    │   ├── 第1章:技术选型/          # 技术栈 / 中间件 / 协议与架构模式 / 运维架构
    │   ├── 第2章:开发基本要求/      # 开发习惯(.env、Redis、async、日志、异常处理、类型注解)
    │   ├── 第3章:模块开发/          # 对话接口 / 记忆 / 工具 / 工作流 / RAG
    │   └── 第4章:Agent通路/         # 单Agent / Multi-Agent(A2A)
    ├── 03-生产级测试-系统测试/       # 第5章:系统测试
    └── 04-生产级AI Infra-基座与运维/ # 第6章:AI Infra基础知识
```

命名规则:
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add adw-19/build_a_product_agent/CLAUDE.md@sha256:e4306dac62352044

The line at the top of this page pins the label git:20260918.82c2ad4, 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_l5stkqgr5jafy7d4.svg)](https://markdownregistry.com/a/art_l5stkqgr5jafy7d4)

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

Versions

The registry has recorded 7 versions of this file, between Aug 27, 2026 and Sep 18, 2026, about one every 4 days.

versioncommittedcommitsizeaudit
git:20260918.82c2ad4 latest2026-09-18 82c2ad4 8,216 BA view · diff
git:20260918.0ceab7e2026-09-18 0ceab7e 8,207 BA view · diff
git:20260918.86025272026-09-18 8602527 8,177 BA view · diff
git:20260918.2580e4b2026-09-18 2580e4b 7,876 BA view · diff
git:20260918.b5f82b12026-09-18 b5f82b1 7,717 BA view · diff
git:20260827.c062b482026-08-27 c062b48 4,821 BA view · diff
git:20260827.4915a392026-08-27 4915a39 4,815 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 (8216 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

adw-19/build_a_product_agent · 117 stars · license MIT · pushed 2026-09-18 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_l5stkqgr5jafy7d4
GET https://markdownregistry.com/api/v1/resolve?ref=adw-19/build_a_product_agent/CLAUDE.md
GET https://markdownregistry.com/api/v1/blob/e4306dac62352044d737b71587c9838579a6bf9e706edc7eb12cfe0d1f4abcc9

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 a CLAUDE.md file is · keeping AGENTS.md and CLAUDE.md in sync · which agent file does what.

Other files named CLAUDE.md

CLAUDE.md CLAUDE.md file
affaan-m/ecc · CLAUDE.md
git:20261020.9471ef4 · audit A · 299,696 stars
CLAUDE.md CLAUDE.md file
firecrawl/firecrawl · CLAUDE.md
git:20261008.5a75dca · audit A · 199,595 stars
CLAUDE.md CLAUDE.md file
garrytan/gstack · CLAUDE.md
git:20261107.ef99eb5 · audit A · 140,694 stars
CLAUDE.md CLAUDE.md file
juliusbrussee/caveman · CLAUDE.md
git:20261106.af560e1 · audit B · 118,366 stars
CLAUDE.md CLAUDE.md file
addyosmani/agent-skills · CLAUDE.md
git:20260720.8fd2081 · audit A · 113,383 stars
CLAUDE.md CLAUDE.md file
nexu-io/open-design · CLAUDE.md
git:20260430.9b57c22 · audit B · 106,541 stars
CLAUDE.md CLAUDE.md file
pbakaus/impeccable · CLAUDE.md
git:20261105.71dfd50 · audit A · 106,186 stars
CLAUDE.md CLAUDE.md file
debpalash/voicestudio · CLAUDE.md
git:20261104.c2998f6 · audit A · 102,675 stars

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