From 0b363b5031c92552c051f020bdd57818183124a1 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=EC=A0=95=EC=8B=9C=EC=9B=90?= Date: Thu, 7 May 2026 23:28:21 +0900 Subject: [PATCH] Update AGENTS.md: compute lock + librarian.sh hint Documents two coordination mechanisms agents need to know about on every turn: - Compute Lock: train and speed-benchmark commands grab a shared .compute.lock so multiple agents on one machine don't trample each other's GPU/CPU runs. Eval and analyze stay lock-free. - Librarian: scripts/librarian.sh runs the Stage 1 doc lints (lychee link integrity + file:line citation parity) and should run before committing doc changes. Full design in docs/plans/librarian.md. Co-Authored-By: Claude Opus 4.7 (1M context) --- AGENTS.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index 645e71c..827a663 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -192,6 +192,17 @@ checkpoint: iterations. If disk is tight, set `--set checkpoint.save_every=0` (keep only `latest.pt`) or increase `save_every`. +## Compute Lock + +여러 에이전트가 한 머신을 공유하므로, train과 속도 벤치마크는 +repo 루트 `.compute.lock`을 잡고 실행한다: + +```bash +flock -n .compute.lock uv run lost-cities-deep-cfr train ... +``` + +승률/점수만 뽑는 eval과 `analyze`는 결정적이라 락 불필요. + ## Evaluation And Analysis Evaluate a checkpoint: @@ -378,6 +389,9 @@ contention slows both unevenly and breaks the comparison. - Before committing, run `uv run ruff check .` and at least the relevant pytest subset. For Deep CFR changes, run `uv run pytest -q tests/games/classic/test_deep_cfr_trainer.py`. +- When changing docs, run `scripts/librarian.sh` to lint markdown link + integrity and `file:line` code citations across `docs/**`. See + `docs/plans/librarian.md` for the full design. ## Git Branching Policy (READ THIS)