docs: 添加协议文档作为数据格式信源的约束

This commit is contained in:
qzl
2026-03-12 16:42:25 +08:00
parent 01c36eb32e
commit 78c2488144
+13
View File
@@ -40,6 +40,19 @@ If two rules conflict, use the stricter one.
- Never push remote changes unless the user explicitly requests it.
- Keep AGENTS chain lean: put domain details in sub-AGENTS, avoid duplicate rules across layers.
## Protocol as Source of Truth
`docs/protocols/` is the single source of truth for data formats and protocols.
- All data schemas, API contracts, and UI schema definitions MUST be documented in `docs/protocols/`.
- Frontend and backend implementations MUST conform to the protocols defined in `docs/protocols/`.
- Before modifying any data format or protocol:
1. Update the corresponding document in `docs/protocols/` first
2. Verify the change is backward compatible or plan migration
3. Then implement the code changes
This ensures frontend and backend stay synchronized and prevents drift.
## Skills Index
- `ag-ui`: AG-UI protocol implementation guidance.