docs(agents): require keeping AGENTS.md in sync with the code
Add a maintenance note: AGENTS.md is a living document and must be updated in the same commit whenever code/flags/structure/scripts change, and reconciled first whenever it diverges from the code.
This commit is contained in:
@@ -2,6 +2,19 @@
|
|||||||
|
|
||||||
Руководство для агентов (и людей), работающих с этим репозиторием.
|
Руководство для агентов (и людей), работающих с этим репозиторием.
|
||||||
|
|
||||||
|
## Сопровождение этого файла (ВАЖНО)
|
||||||
|
|
||||||
|
- **AGENTS.md должен отражать актуальное состояние кода.** Это живой документ,
|
||||||
|
а не одноразовая справка.
|
||||||
|
- При любом изменении, влияющем на: архитектуру, состав пакетов/файлов, флаги
|
||||||
|
CLI или env-переменные (`WEBVNC_*`), протокол/поведение гейтвея, скрипты,
|
||||||
|
кодировки файлов, процесс сборки/запуска или известные ограничения —
|
||||||
|
**обязательно обнови соответствующий раздел AGENTS.md в том же коммите**.
|
||||||
|
- Если заметил расхождение между AGENTS.md и реальным кодом (функция переименована,
|
||||||
|
файл удалён, флаг изменён и т.п.) — сначала приведи AGENTS.md в соответствие
|
||||||
|
с кодом, затем продолжай работу. Не оставляй устаревшие инструкции.
|
||||||
|
- Коммит, меняющий поведение/структуру, но не трогающий AGENTS.md при расхождении,
|
||||||
|
считается неполным.
|
||||||
## Что это
|
## Что это
|
||||||
|
|
||||||
`web-vnc` — один Go-бинарник, который открывает доступ к рабочему столу (VNC)
|
`web-vnc` — один Go-бинарник, который открывает доступ к рабочему столу (VNC)
|
||||||
|
|||||||
Reference in New Issue
Block a user