Почему API‑First уже недостаточно и что меняется, когда SDD строится на.md‑файлах и обязательном участии агентов?
В агентном SDD спецификация становится не пояснением к коду, а рабочим контекстом, из которого агент строит план, тесты и реализацию. Это ускоряет разработку — и одновременно увеличивает цену неоднозначности. Разбираем, как превратить.md из документации в управляемый контракт.
Сразу дам некоторые вводные: я использовал TRAE, это IDE на базе VS Code, в которой уже встроен набор разных моделей, и всё это счастье можно использовать бесплатно. Чтобы вы не тратили время на проверку на момент написания там есть из коробки: GPT 5.4 и 5.2, Dola-seed 2.0 code, MiniMax M2.7 и M3, Kimi k2.5, Deepseek v3.2 и Gemini 2.5flash, 3Flash preview и 3.1 Pro preview. Есть ограничения в виде ожиданий между запросами, но если заплатить 30 долларов в месяц, то на сегодняшний день это безлимит по запросам с авто выбором моделей. И конечно же можно добавить любую свою модель, на которую у вас есть подписка, тот же Claude, например. Тут уже без безлимита, всё будет зависеть от вашего тарифа.
Есть в жизни вещи, которые приносят мне и радость, и печаль одновременно. Например, горький шоколад и markdown. Серьёзно, зачем он нужен? В половине случаев мы даже не используем этот язык целиком!
В данной статье я описал, с какими проблемами я встретился, будучи студентом, который на постоянной основе использует obsidian, из-за которых я создал свой экспортер подграфа в obsidian.
Стремительное развитие ИИ в последние годы привело к невиданному росту популярности Markdown. Почти все современные LLM — от ChatGPT до Claude — по умолчанию выдают ответы в этом формате. Мы привыкли оформлять в нем заметки в Obsidian, писать промпты, вести документацию в GitHub и общаться в рабочих мессенджерах. Markdown стал «лингва-франка» современного интернета.
Но есть одна проблема. Использовать Markdown с русским языком — это боль.
Вам нужно поставить заголовок? Alt+Shift -> # -> Alt+ShiftЧитать полностью »
Я веду несколько проектов параллельно. Как и многие, прошёл путь от Trello через Notion к Linear. Каждый раз одна и та же история: первую неделю всё красиво, потом доска превращается в кладбище карточек, которые никто не двигает. Потому что переключаться между кодом и трекером — это отдельная работа, на которую нет ни времени, ни желания.
В какой-то момент я понял: проблема не в инструменте. Проблема в том, что трекер — это отдельное окно. Отдельный контекст. Отдельное усилие.
