Markdown становится исходным кодом, а не документацией

Markdown in /src

Carson Gross утверждает, что при агентном программировании Markdown превращается в исходный код, а не в документацию. Он предлагает хранить его в каталоге /src/md рядом с кодом, чтобы фиксировать архитектурные решения, спецификации и намерения, из которых затем выводятся код и тесты. Это обеспечивает локальность контекста для людей и агентов и избавляет от эфемерных промптов и разрозненных вики.