---
title: "Monorepo 把规则沉到包目录"
summary: "根目录写通用约定，前端/后端/基础设施在各自目录放更具体的 AGENTS.md，避免套用错误命令。"
category: agents-md
level: intermediate
surfaces: [cli, app]
tags: ["monorepo", "分层", "AGENTS.md"]
canonical: /tips/nested-monorepo-agents/
---

# Monorepo 把规则沉到包目录

根目录写通用约定，前端/后端/基础设施在各自目录放更具体的 AGENTS.md，避免套用错误命令。

例如：

```text
AGENTS.md                      # 通用：提交信息、安全、禁止提交密钥
apps/web/AGENTS.md              # pnpm、Playwright、不要改 public API
services/payments/AGENTS.md    # make test-payments，禁止擅自轮转密钥
```

从 `services/payments` 启动时，会先吃到根规则，再吃到支付服务规则。后出现的覆盖前者。

不要把所有语言的测试命令堆在根文件里——那会让错误的命令被用到错误的包上。

## 来源

- [OpenAI · AGENTS.md](https://developers.openai.com/codex/guides/agents-md)