docs: 添加协议文档作为数据格式信源的约束
This commit is contained in:
@@ -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.
|
||||
|
||||
Reference in New Issue
Block a user