# source: 2026-08-11/rec_20260811_191248.m4a
# model: Systran/faster-whisper-small
# transcribed: 2026-10-22T03:55:46Z

[00:00:00] Хорошим, чтобы документацию в системе нужно документацию
[00:01:07] делить на две части, то есть первая часть, это триоргование
[00:01:13] декларативное, то есть как это должно в принципе
[00:01:17] работать, и вот эту документацию надо писать не так, что это
[00:01:23] промд, который ты закеешь в систему, и он потом после
[00:01:30] того как переживается системой, да, с тебе какой-то на выход
[00:01:34] просто экзитант, а как то, что должно в итоге остаться
[00:01:38] отца, рядом с разработанным чем-то, то есть мы разрабатываем
[00:01:44] описание базы знаний, отстать базы, да, на этой скрипе, и я тоже
[00:01:50] был писать какой-то язык, который должно было остаться рядом
[00:01:53] с этим навыком, чтобы задержать требования, как он должен
[00:02:00] работать, то есть требования функциональные, и второй,
[00:02:07] собственно, набор требований, это требования императивные,
[00:02:15] а как надо реализовать, что надо конкретно сделать,
[00:02:20] чтобы реализовать требования, как это должно работать,
[00:02:24] и как это должно работать, может быть это ухурованивые
[00:02:26] требования, функциональные, технические, и так далее,
[00:02:30] например, как должна быть настроена по заданных, еще что-то
[00:02:34] там, все как бы может достаться как требования, а вот рядом
[00:02:37] может лежать план работ, да, или как бы директивная
[00:02:42] инструкция, что делать, и как, что реализовать эти требования,
[00:02:46] и вот эта история, можно выкинуть потом узорное ведро,
[00:02:50] да, потому что у тебя есть разработанный навык, у тебя
[00:02:56] есть документация, как он должен работать, то есть
[00:02:59] требования к нему, и этого достаточно, то есть, как он
[00:03:03] создавался, для истории можно сохранить, но в принципе
[00:03:07] не обязательно, понимаешь, да, и вот эта вот внутренняя
[00:03:12] реализация головы, да, то есть, подход такой, то есть,
[00:03:15] он позволяет, как бы в будущем момент сразу, кроме
[00:03:21] инструментов, документацию на них, если ты еще инструмента
[00:03:25] постоянно правишь, дорабатываешь, или с ними активно работаешь,
[00:03:28] то эта документация всегда очень полезна, и поэтому
[00:03:32] вот сейчас, когда ты пишешь требования, мы должны их
[00:03:36] писать так, что они потом останутся с нами навсегда
[00:03:42] к самим, и будут лежать вместе с разработанной системой
[00:03:47] рядом, это в том числе решает вопрос инкременности,
[00:03:51] то есть, когда ты сделал систему, потом доделываешь
[00:03:54] или изменяешь или все, то, что, по сути, ты садишься
[00:03:58] и дописываешь новый модуль с требованием, и кладешь
[00:04:01] большой бакет документации, а императивную инструкцию
[00:04:05] пишешь, говоришь, что вот, пожалуйста, принять его
[00:04:10] внимание, ну или там, реализуй вот эту дополнительную
[00:04:13] новую часть, понимаешь, вот это вот такая штука в
[00:04:20] голове, потому что если мы все замешиваем в одну
[00:04:22] кашу, то потом, вот как сейчас, я написал, он его
[00:04:27] реализовал, просто выкинул, есть решение, нет
[00:04:32] документации, да, и можно, конечно, его сейчас легко
[00:04:35] попросить сказать, а пиши требования к тому, как ты
[00:04:39] реализовал навык из сохранения, и он это сделает, да, как
[00:04:44] бы, но, возможно, какие-то вещи, которые я писал, там,
[00:04:48] цель или там, или еще что-то, они могут и потеряться при
[00:04:51] таком подходе, но фишка вот как раз в том, что агенты
[00:04:57] позволяют именно очень классно...