plandeck

Renders YAML task plans as a live Kanban board with dependency tracking and critical path computation.

65|1|Updated Jul 12, 2026
One-click install
npx skills add https://github.com/OthmanAdi/plandeck --skill plandeck-othmanadi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plandeck
Source: https://github.com/OthmanAdi/plandeck
Command: npx skills add https://github.com/OthmanAdi/plandeck --skill plandeck-othmanadi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? AI coding agents lose track of multi-step work after a context reset or /clear, and flat markdown checklists cannot express task dependencies, so agents guess the wrong next step. Plandeck keeps the plan as a structured plan.yaml file on disk and renders it as a live Kanban board that recomputes itself on every edit. ## Core Features & Use Cases - Self-organizing Kanban board: Cards auto-promote from Backlog to Ready when their dependencies complete, the critical path is drawn in gold, and a banner names the single next action, all streamed live over SSE with zero dependencies. - Deterministic planning engine: Pure functions over YAML compute the ready-queue, points-weighted critical path, progress rollups, velocity-based ETA, and one tie-broken next action, with no AI or LLM involved. - Crash-proof continuity: A mission journal, last-known-good snapshots, a doctor restore command, and a NEXT.md breadcrumb let an agent recover its exact next move after /clear without re-reading the whole plan. - Use Case: An agent shipping an onboarding flow breaks the work into ten cards with depends_on edges, runs plandeck board to watch progress live, and after a context reset runs plandeck next to instantly resume the one active card. ## Quick Start Ask the agent to initialize a Plandeck plan in the current project, break the task into dependency-linked cards, and start the live board with plandeck board.

Frequently Asked Questions about plandeck

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a Kanban board for an AI agent task plan?

Write a plan.yaml file with cards that declare id, column, estimate, and depends_on fields, then run plandeck board <dir>. The board serves live in the browser over SSE and reorganizes itself whenever you edit the YAML file.

How does an AI agent recover its task after a /clear or context reset?

Run plandeck next in the plan directory after a reset. It prints the single next action with progress, ready cards, and the critical path, while NEXT.md holds a fuller breadcrumb including recent transition history under Since you left.

Does Plandeck work with Claude Code, Codex, and Cursor?

Yes, Plandeck ships a SKILL.md following the open SKILL.md standard, so it loads in Claude Code, Codex, Cursor, and any agent that reads that format. Any agent with shell access can also use the plandeck CLI directly.

What happens when plan.yaml has a syntax error while the board is running?

The board keeps serving the last good state with a red parse-error banner instead of wiping the lanes. Run plandeck doctor to inspect the error and snapshots, then restore explicitly with --restore latest, which preserves the broken content as plan.yaml.corrupt.

When should I not use a Kanban planning board for agent tasks?

Skip it for one-shot work like a single edit, a quick answer, or a two-step fix that finishes before any context reset. The planning overhead only pays off when work spans many steps, has real dependencies, or must survive session boundaries.