«Две доки, чтоб править всеми»

Как сделать так, чтобы документация не пылилась в репозитории, а реально ускоряла разработку, помогала AI писать код и автоматически превращалась в пользовательские инструкции.