Series · Day 058 – 060 · 3 posts

What lives in the repo

Repo 里该留下什么
1/3Day 058
Building with AI: what belongs in the repo?和 AI 一起开发产品,repo 里到底该留下什么?

With coding agents, the documents in a repo are no longer just records for later; they directly decide how the agent understands the product, how it changes the code, and which way it guesses when something is ambiguous.

2/3Day 059
A good CLAUDE.md shouldn't re-explain the product一份好的 CLAUDE.md AGENTS.md,不应该重新介绍整个产品

CLAUDE.md’s job isn’t to store all project knowledge, but to tell the agent how to work in this repo: where to find the right facts, how to develop, what it mustn’t decide on its own, and which mistakes keep recurring.

3/3Day 060
Claude Design wrote DESIGN.md — why is the design still off?Claude Design 写了 DESIGN.md,为什么设计还是不对?

The DESIGN.md Claude Design wrote for me had colors, fonts, spacing and components, and was still off: it explained what the interface should look like, not why the product should be designed that way.