Code 2025
Backlog.md: Terminal Kanban Board for Managing Tasks with AI Agents — Alex Gavrilescu, Funstage
Overview
BacklogMD is a terminal-based Kanban board designed for managing tasks with AI agents and humans. It addresses the common issue of AI agents going off-track or running out of context by breaking down large features into smaller, manageable Markdown tasks. This approach facilitates clearer communication, better scope definition, and a more robust review process for AI-assisted development.
Who should watch
- AI Engineers
- Product Managers
- Developers building with AI agents
- Anyone struggling with AI agent context limitations or task management
- Teams looking for structured AI-assisted workflows
Key takeaways
- Tasks are stored as Markdown files within a Git repository, including metadata, descriptions, and acceptance criteria.
- BacklogMD provides a terminal Kanban interface for visualizing and managing task status (e.g., To Do, In Progress, Done).
- AI agents can interact with BacklogMD through MCP tools, enabling them to create, view, update, and search for tasks natively.
- The workflow emphasizes clear requirements and acceptance criteria, crucial for both human and AI understanding.
- A multi-stage review process is integrated: reviewing task creation, implementation plans, and final code.
- Breaking down work into smaller, atomic tasks helps prevent AI agents from exceeding context windows and ensures defined scope.
- The tool supports parallel work on tasks using Git, provided there are no dependencies.
- The majority of the BacklogMD codebase itself was generated by AI agents, demonstrating the tool's practical application.
Notable quotes
*Have you ever had your agent working for almost one hour only to understand that he went in the wrong direction or in the middle of something very important he ran out of context window? Me too.*
*Backlog empty tasks are stored as markdown files in your repository.*
*The scope is well defined. So you can really define with using the acceptance criteria what should be part of this feature and what should be not part of this feature.*
Unofficial community note. Prefer the recording for nuance.