chore: add workspace coordination rules
This commit is contained in:
parent
c0f6fed3fd
commit
66d42c59dc
36
AGENTS.md
36
AGENTS.md
@ -1,5 +1,41 @@
|
|||||||
# AGENTS.md
|
# AGENTS.md
|
||||||
|
|
||||||
|
## Workspace Coordination
|
||||||
|
|
||||||
|
本仓库现在是 `water-workspace` 下的文档总控仓,默认作为正式规格、计划、任务、验收与治理台账的单一入口。
|
||||||
|
|
||||||
|
### 邻接仓库
|
||||||
|
|
||||||
|
- `../water-backend/`:后端实现仓,默认主开发分支为 `develop`
|
||||||
|
- `../water-frontend/`:前端实现仓,默认主开发分支为 `develop`
|
||||||
|
|
||||||
|
### 启动规则
|
||||||
|
|
||||||
|
- 需要运行 `/speckit.specify`、`/speckit.plan`、`/speckit.tasks`、正式文档修订、治理台账更新、验收结论汇总时,必须从 `water-docs` 根目录启动代理。
|
||||||
|
- 需要检查正式规格、计划、任务、基线、evidence 时,以 `water-docs/specs/` 与 `water-docs/docs/` 为准。
|
||||||
|
- 未经用户明确要求,不在本仓库直接修改 `../water-backend/` 或 `../water-frontend/` 中的业务代码。
|
||||||
|
|
||||||
|
### 多仓协作规则
|
||||||
|
|
||||||
|
- 本仓库中的 `.specify/` 是唯一正式流程入口,backend/frontend 不复制第二套 `.specify/`。
|
||||||
|
- backend/frontend 仓内实现结论,必须回写到本仓库的正式文档或 `specs/` 工件,不能仅停留在代码仓口头说明。
|
||||||
|
- 重要 feature 默认记录代码基线:
|
||||||
|
- backend commit SHA
|
||||||
|
- frontend commit SHA
|
||||||
|
- 验证日期
|
||||||
|
|
||||||
|
### Worktree 约定
|
||||||
|
|
||||||
|
- 推荐在 `../worktrees/` 下按 feature 建立平铺 worktree:
|
||||||
|
- `docs-<feature>`
|
||||||
|
- `backend-<feature>`
|
||||||
|
- `frontend-<feature>`
|
||||||
|
- `verify-<feature>`
|
||||||
|
- 文档 lane 只改 `water-docs`
|
||||||
|
- backend lane 只改 `water-backend`
|
||||||
|
- frontend lane 只改 `water-frontend`
|
||||||
|
- verify lane 负责样本、日志、验收结论和基线固定
|
||||||
|
|
||||||
本文件用于指导通用代码代理(包括 Codex 类代理)在本仓库中的工作方式。
|
本文件用于指导通用代码代理(包括 Codex 类代理)在本仓库中的工作方式。
|
||||||
|
|
||||||
## 项目定位
|
## 项目定位
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user