Initial commit: antigravity-claudekit

skills/ck-plans-kanban/SKILL.md

@@ -0,0 +1,89 @@
+---
+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