dima/jung
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

AGENTS.md: xref trigger points clarified (once done / start of each section / end-of-section stale check)

Browse source
This commit is contained in:
Dmitry Kokorin 2026-09-25 23:41:06 +03:00
parent 7d3794560e
commit a086faa2a4
1 changed files with 6 additions and 3 deletions
Download patch file Download diff file Expand all files Collapse all files

9
AGENTS.md
View file

@ -735,9 +735,12 @@ unbuffered logs; ads.php throttle → pause, don't hammer.
## Dedup rules (user, 2026-09-25) — КАЖДАЯ КНИГА ИЩЕТСЯ/СКАЧИВАЕТСЯ ОДИН РАЗ
- **Book level:** `data/MASTER-LIST.md` (генерируется `tools/xref.py --write`) — все 12 секций,
каноническая карточка + «Also listed in». Перед новой секцией: `python3 tools/xref.py --write`
и работать по её NEW/xref-меткам (xref-строка в карточке = cross-ref, поиск НЕ проводится).
RAW новой секции кладётся в sections/0N/RAW.md (или data/isap-raw/), xref.py подхватывает автоматически.
каноническая карточка + «Also listed in». Триггеры: (1) разово уже сделано 2026-09-25 (карта
для scope-решения 07–12); (2) **в начале каждой новой секции** — `python3 tools/xref.py --write`
и работать по её NEW/xref-меткам (raw↔raw-метки уточняются против карточек пред. секции);
(3) **в конце секции** (после даунлоудов) — plain `python3 tools/xref.py` = stale-line-чек
манифестов (см. правило ниже). RAW новой секции кладётся в sections/0N/RAW.md (или
data/isap-raw/), xref.py подхватывает автоматически. Скрипт локальный, ~1 c.
- **File level:** файл хранится ТОЛЬКО в первой секции, где книга появилась; поздние секции —
cross-ref «secNN: <file>» в MANIFEST/карточке. 2026-09-25: 17 md5-дублей удалено
(`tools/dedup_files.py`), в каждом MANIFEST — датированная Notes-строка.