Expand and refine software catalog

AGENTS.md

@@ -50,11 +50,12 @@ description: Описание категории на русском языке.
    Markdown.
 6. `homepage` — необязательный URL домашней страницы.
 7. `source` — необязательный URL исходного кода.
-8. `author` — необязательное имя автора или название организации-разработчика.
-9. `screenshots` — обязательный массив путей; используй `[]`, если изображений
+8. `forum` — необязательный URL темы программы на форуме.
+9. `author` — необязательное имя автора или название организации-разработчика.
+10. `screenshots` — обязательный массив путей; используй `[]`, если изображений
    нет.
-10. `versions` — обязательный непустой массив версий.
-11. `additional_files` — необязательный массив файлов, не привязанных к версии.
+11. `versions` — обязательный непустой массив версий.
+12. `additional_files` — необязательный массив файлов, не привязанных к версии.
 
 Новые версии добавляй в начало `versions`, от новых к старым. Каждая версия
 имеет такой вид:
@@ -87,6 +88,11 @@ description: Описание категории на русском языке.
 SHA-256 не добавляй в индекс программы: они хранятся только в автоматически
 создаваемом `catalog/files.yaml`.
 
+`description` файла добавляй только для существенной информации: отличия от
+других вариантов, особого назначения или дополнительных материалов в архиве.
+Не повторяй в нём название программы, номер версии, имя файла или тип
+«программа», «дистрибутив», «исполняемый файл».
+
 ### Короткое описание
 
 `summary` выводится рядом с названием программы в списке категории. Напиши
@@ -109,12 +115,17 @@ additional_files:
 
 - Названия категорий, описания программ, версий и файлов пиши на русском языке.
   Официальные названия продуктов и технологий не переводи.
+- Если доступно авторское описание, сохраняй его лексику, тон, порядок мыслей и
+  характерные формулировки. Не переписывай текст в нейтральном справочном стиле
+  и не заменяй авторские термины своими. Исправляй только оформление Markdown,
+  явные опечатки и очевидные грамматические ошибки.
 - Сохраняй полноту исходного описания. Не сокращай перечень возможностей до
   общего пересказа и не удаляй значимые технические подробности.
 - Содержимое каждого `description` интерпретируется как Markdown. Для длинного
   описания со списком используй литеральный блок `|-` и Markdown-списки; для
   обычного абзаца, перенесённого на несколько строк, используй `>-`. Не вставляй
   HTML-разметку.
+- Каждый пункт Markdown-списка начинай с заглавной буквы.
 - Не выдумывай даты, ссылки, возможности или платформы. Неизвестное
   необязательное поле лучше не добавлять.
 - Сначала пытайся определить версию по странице, имени файла, README и
@@ -134,8 +145,13 @@ additional_files:
 - Дистрибутивы и отдельные исполняемые файлы храни в ZIP, совместимом со
   встроенным распаковщиком Windows XP: методы Store или Deflate, без шифрования
   и Zip64. Не добавляй RAR, 7z и незапакованные EXE.
-- При перепаковке сохраняй имена, содержимое и время изменения файлов внутри
-  архива.
+- RAR, 7z, ZIP и отдельные EXE перепаковывай только командой
+  `pnpm repack-archive <путь>`. Она создаёт рядом проверенный ZIP и сохраняет
+  имена, содержимое и время изменения файлов. По умолчанию исходник остаётся;
+  `--replace` используй только когда его нужно удалить после успешной проверки.
+  Для другого пути назначения используй `--output <путь>`.
+- После перепаковки замени путь в `index.yaml` и выполни
+  `pnpm fill-metadata`, чтобы обновить `catalog/files.yaml`.
 - Архивы должны проходить через Git LFS согласно `.gitattributes`. Остальные
   файлы хранятся в обычном Git.