From 9a79f97aefd6ba44e0835d2d72f5ed57cb6a3540 Mon Sep 17 00:00:00 2001 From: Willem Jiang Date: Thu, 29 Oct 2026 20:42:07 +0800 Subject: [PATCH] docs: keep version guidance within inherited size budget --- AGENTS.md | 16 +++++++--------- 1 file changed, 7 insertions(+), 9 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 2f37892bb2..211a859b8d 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -238,14 +238,12 @@ Repo-wide conventions: - **Skill text encoding** — use explicit UTF-8 for textual skill resources. Read `SKILL.md` with `encoding="utf-8-sig"` to strip a leading BOM; write with `encoding="utf-8"`. Never rely on the platform locale. -- **Version sources must stay in lockstep** — a release version must match identically in - `backend/pyproject.toml`, `backend/packages/harness/pyproject.toml`, `frontend/package.json`, - and `deploy/helm/deer-flow/Chart.yaml` (`version` + `appVersion`), and `backend/uv.lock` must - record the same version for the root `deer-flow` and `deerflow-harness` workspace members - (uv stores its PEP 440 form, e.g. `2.1.0rc0`). Pushing a `v*` git tag triggers CI - that runs `scripts/verify_versions.sh` and **blocks all publishing** if any source drifts. - Before bumping a version, run `scripts/bump_version.sh ` (aligns the five fields and - refreshes `backend/uv.lock` at once — it needs `uv` on `PATH`) and - `scripts/verify_versions.sh ` to catch drift early. See [RELEASING.md](RELEASING.md). +- **Version lockstep** — keep `backend/pyproject.toml`, + `backend/packages/harness/pyproject.toml`, `frontend/package.json`, and + `deploy/helm/deer-flow/Chart.yaml` (`version`/`appVersion`) identical. + `backend/uv.lock` must match both `deer-flow` and `deerflow-harness` in PEP 440 form. + Run `scripts/bump_version.sh ` (requires `uv` on `PATH`) to update all five + fields and the lock, then `scripts/verify_versions.sh `. `v*` tag CI blocks + all publishing on drift. See [RELEASING.md](RELEASING.md). - **Don't edit `CLAUDE.md`** — it only contains `@AGENTS.md`. All agent guidance changes belong here in `AGENTS.md`; `CLAUDE.md` is a thin import shim.