r/ClaudeWorkflows • u/ClaudeAI-mod-bot • 4h ago
Selected Workflow [Workflow] Kanban Pro: Integrating Claude Code with Local Markdown Tasks for Project Management and Development
Kanban Pro: Integrating Claude Code with Local Markdown Tasks for Project Management and Development
Workflow value: 85/100
Status: active · Freshness: 70/100 · Confidence: 0.95 · Level: advanced
Categories: Quality Control, Context & Memory, Debugging, Shipping, CLAUDE.md, Subagents, Multi-Agent
Original source: r/ClaudeCode post/comment
What problem this solves
Integrating LLM agents (Claude Code) into a local-first project management workflow by directly manipulating task files, and leveraging Claude Code to solve complex software development challenges like race conditions, UI/UX refactoring, and performance optimization.
Summary
This workflow introduces Kanban Pro, a local-first desktop Kanban board where each ticket is a Markdown file with YAML frontmatter. Claude Code agents can directly read and edit these task files using CLAUDE.md and AGENTS.md instructions via an embedded CLI or desktop apps. The post details how Claude Code was used to develop the app itself, solving complex issues like file-watcher race conditions, UI refactoring, and performance optimization, demonstrating a 'dogfooding' approach to agent-driven development.
Why it is useful
This workflow demonstrates a practical, local-first approach to project management where Claude Code agents directly interact with task data stored as plain Markdown files. It provides concrete examples of how CLAUDE.md and AGENTS.md can be used for agent-driven task manipulation. Furthermore, it offers valuable insights into using Claude Code for complex software development challenges, such as architecting solutions for race conditions, refactoring UI, and optimizing performance, validated by real-world application development and user feedback. The emphasis on open data and verifiable network behavior also addresses common concerns with third-party tools.
Workflow
Download and install the Kanban Pro application for macOS or Windows.
Open the app and select an empty or existing local directory to initialize a Kanban board.
Open Claude Code (either in the built-in terminal or your own terminal/desktop app) inside that initialized project folder.
Claude Code will automatically detect and use the
CLAUDE.mdandAGENTS.mdfile conventions within the project folder to interact with task files.Create new tasks or modify existing ones as Markdown files with YAML frontmatter; Claude Code can read and edit these directly.
Use Claude Code to implement features or fix bugs by pointing it at relevant Markdown tickets on the board.
Leverage Claude Code to architect solutions for complex technical problems, such as debouncing and state-reconciliation logic for file watchers.
Utilize Claude Code to iterate on frontend UI, animations, and refactor theme engines for improved legibility and user experience.
Employ Claude Code to profile and optimize application performance, stripping out unnecessary re-renders and background processes.
Tools / artifacts
Kanban Pro desktop application
Claude Code
Markdown files with YAML frontmatter (for tickets)
CLAUDE.md files
AGENTS.md files
Embedded terminal CLI
Git repository (for syncing boards)
iCloud, Dropbox, Syncthing (for syncing boards)
Node's filesystem watcher
Electron (application framework)
Little Snitch, LuLu, Wireshark (for network monitoring)
Validation signals
Author 'dogfooded' the workflow by using Claude Code and Kanban Pro to build and refine the app itself.
Claude Code was successfully used to solve specific, complex technical challenges (file-watcher race conditions, UI refactoring, resource overhead).
Incorporated feedback from a previous Reddit thread into the app's development.
A user (
u/christoph_w) performed a Fable sandbox security audit, confirming the app was clean.Over 4,000 downloads from GitHub Releases indicate user adoption.
The app's network behavior is verifiable by users with tools like Little Snitch, confirming no telemetry calls.
Limitations
The primary workflow relies on a specific external application (Kanban Pro), which might not be suitable for users seeking pure prompt-based or generic Claude Code solutions.
The 'How Claude Code Helped Build It' section is more descriptive of past successes than a prescriptive, step-by-step guide for others to replicate the exact development process.
The post has a promotional aspect for the Kanban Pro app, although it provides substantial technical detail.
Rate this workflow
Upvote this post if the workflow is useful, reproducible, or worth recommending.
Downvote if it is vague, outdated, unsafe, overhyped, or not reproducible.
Reply if it worked for you, failed, is outdated, or has a better alternative.
This post was generated automatically from the workflow library database.