Пост Я не рассказал про ключевой вопрос по SDD - где находится source of truth?

Я не рассказал про ключевой вопрос по SDD - где находится source of truth? До сих пор источником правды был код. По понятной причине - именно код работает на ПРОМе, не аналитика. Аналитика лежит в wiki и медленно, но верно расходится с кодом. Сейчас мы этот разрыв пытаемся убирать, и кладем аналитику поближе к коду. Но разрыв остается, т.к. LLM при разработке фичи условно правит 3 места: 1) спеки 2) код 3) документацию к коду Тот факт, что правка идет в одной сессии (на одном контексте) увеличивает вероятность, что все три источника будут одинаковы. Но не доводит ее до 100%. А главное - зачем нам три источника? Сложный вопрос. Где спека точно нужна? Спека на входе агента - да, т.е. в течение рабочей сессии. Нужна ли она далее - вопрос? Накину аргументы за спецификацию как источник правды: 1) спецификация упрощает совместную работу над фичей для ВП, аналитиков, разработчиков и тестировщиков. Тут наверное не поспоришь, пока в команде есть все эти роли. Разве что тестировщики сейчас автоматизируются и идут "в код". 2) актуальная спецификация может дать возможность выкинуть код и переписать сервис с нуля. В целом да, но вообще говоря спеку можно вытянуть из кода и JavaDoc. 3) агенту (и человеку) проще дорабатывать проект. Под вопросом - при хорошо структурированном коде и наличии документации там, где она нужна. А еще индексаторы кода есть. Про минусы я уже сказал - массовое нарушение DRY. Почему массовое? Потому что по факту источников больше, чем три. Новый реализуемый алгоритм появляется в: 1) коде 2) тестах 3) JavaDoc 4) spec.md 5) design.md (здесь и далее в терминологии OpenSpec) 6) proposal.md (верхнеуровнево) 7) tasks.md (на своем шаге реализации) 8) в файле с tasks от superpowers.md (при использовании superpowers) 9) AGENTS.md (такое возможно, если алгоритм влияет на требования к остальному коду. или в виде описания алгоритма как комментарий к параметрам вызова сервиса) 10) какой-нибудь скил валидации, проверяющий, что алгоритм вызывается там, где должен вызываться И если мы поменяли название алгоритма - где его менять? Везде? Или исторические документы не трогаем? А если их кто-то прочитает? Ясно, что это решается отдельным скилом синхронизации, но что делать с DRY? Я пока окончательного ответа для себя не нашел, но точно понятно, что дублирование надо уменьшать. code or not code, вот в чем вопрос? #ai #ai_agents