mdtask — это CLI-инструмент для разработчиков, которые хотят, чтобы спецификация, задачи и код жили в одном месте и менялись одним коммитом. Задачи хранятся как Markdown-файлы прямо в репозитории — без отдельных досок или баз данных.
Идея простая: каждый spec-файл содержит описание поведения фичи сверху и список задач-чекбоксов снизу. Когда задача выполнена, разработчик или агент закрывает чекбокс, обновляет описание и коммитит всё вместе — код, изменение состояния задачи и актуальную спецификацию. Ревьюер видит полную картину изменений прямо в диффе.
Инструмент особенно хорошо подходит для агентных циклов: агент может взять незаблокированную задачу, реализовать её и закрыть в одном коммите, придерживаясь заданного рабочего процесса. Задача считается выполненной только тогда, когда обновлены реализация, состояние задачи и документация — всё сразу.
Через CLI можно смотреть открытые задачи, фильтровать по тегам, видеть заблокированные, работать с кастомными полями и связями между задачами. Поддерживаются архивирование и автоматическое обнаружение задач без ID. Поле @blocked_by mdtask понимает из коробки — задача автоматически отображается как заблокированная.
Формат задачи минималистичный: чекбокс, стабильный ID, заголовок и опциональное описание. Приоритет, теги и кастомные поля добавляются по необходимости. Весь бэклог — это просто набор Markdown-файлов в папке, которые можно просматривать как текст или опрашивать через CLI.
Блог