90 lines
2.4 KiB
Markdown
90 lines
2.4 KiB
Markdown
---
|
|
name: ck-plans-kanban
|
|
description: View plans dashboard with progress tracking and Gantt timeline. Use for kanban boards, plan status overview, phase progress visualization, and milestone tracking across plan directories.
|
|
---
|
|
|
|
# Plans Kanban Dashboard
|
|
|
|
Visual dashboard for plan directories with progress tracking, Gantt timeline, and activity heatmap.
|
|
|
|
## When to Use
|
|
|
|
- Viewing progress across multiple implementation plans
|
|
- Tracking phase statuses (completed, in-progress, pending)
|
|
- Visualizing plan timelines and activity
|
|
- Monitoring milestone completion
|
|
|
|
## Don't Use When
|
|
|
|
- Managing individual tasks within a single file (edit the plan.md directly)
|
|
- Real-time agent orchestration (not yet supported)
|
|
|
|
## Installation Required
|
|
|
|
```bash
|
|
cd $HOME/.claude/skills/plans-kanban
|
|
npm install # installs gray-matter dependency
|
|
```
|
|
|
|
## Usage
|
|
|
|
```bash
|
|
# Start dashboard for ./plans directory
|
|
node $HOME/.claude/skills/plans-kanban/scripts/server.cjs --dir ./plans --open
|
|
|
|
# Remote access (all interfaces)
|
|
node $HOME/.claude/skills/plans-kanban/scripts/server.cjs --dir ./plans --host 0.0.0.0 --open
|
|
|
|
# Background mode
|
|
node $HOME/.claude/skills/plans-kanban/scripts/server.cjs --dir ./plans --background
|
|
|
|
# Stop all running servers
|
|
node $HOME/.claude/skills/plans-kanban/scripts/server.cjs --stop
|
|
```
|
|
|
|
## CLI Options
|
|
|
|
| Option | Description | Default |
|
|
|--------|-------------|---------|
|
|
| `--dir <path>` | Plans directory | required |
|
|
| `--port <n>` | Server port | 3500 |
|
|
| `--host <addr>` | Host to bind | localhost |
|
|
| `--open` | Auto-open browser | false |
|
|
| `--background` | Run in background | false |
|
|
| `--stop` | Stop all servers | - |
|
|
|
|
## Plan Structure Required
|
|
|
|
Plans directory must contain subdirectories with `plan.md` files:
|
|
|
|
```
|
|
plans/
|
|
├── 251215-feature-a/
|
|
│ ├── plan.md # Required - parsed for phases
|
|
│ └── phase-01-setup.md
|
|
└── 251214-feature-b/
|
|
└── plan.md
|
|
```
|
|
|
|
## HTTP Routes
|
|
|
|
| Route | Description |
|
|
|-------|-------------|
|
|
| `/` or `/kanban` | Dashboard view |
|
|
| `/api/plans` | JSON API for plans data |
|
|
|
|
## Features
|
|
|
|
- Plan cards with progress bars
|
|
- Phase status breakdown
|
|
- Gantt-style timeline
|
|
- Activity heatmap
|
|
- Issue and branch links
|
|
|
|
## Troubleshooting
|
|
|
|
- **Port in use:** Server auto-increments from 3500-3550
|
|
- **No plans found:** Ensure directories contain `plan.md` files
|
|
- **Remote access denied:** Use `--host 0.0.0.0`
|
|
- **Error 500:** Run `npm install` in skill directory first
|