vibe-import-kanban

vibe-import-kanban

Overview

One-way snapshot from vibe-kanban to a local plan file. Does not modify kanban state. The resulting plan-local.json is the input for vibe-ship-fast; the preserved kanban_id / simple_id per issue let vibe-export-kanban post the merge result back to the right issue after the final PR lands.

Core principle: Snapshot, don't subscribe. No polling, no two-way sync, no live updates. If kanban changes mid-flight, the local plan is stale by design — re-import if you need to.

Announce at start: "I'm using the vibe-import-kanban skill to snapshot issues."

When to use

• Issues already exist in vibe-kanban (created by you, a teammate, or vibe-plan without --local)
• You want vibe-ship-fast's local workflow (one PR at the end) but still want the kanban board to reflect "done" later
• Solo run on a shared project

Do NOT use if:

• Issues don't exist yet → vibe-plan --local (skip kanban entirely)
• You want per-issue PRs and per-PR review on GitHub → vibe-ship (no import needed)
• A .vibe-flow/plan-local.json from this run already exists → either resume vibe-ship-fast or delete the file first

The process

Step 1: Resolve scope

Read .vibe-flow.yaml for project_id. If $ARGUMENTS overrides, use that.

Ask the user (or take from $ARGUMENTS) which subset:

• All open issues in the project
• Issues with a specific tag (e.g., sprint:q2)
• A parent issue's sub-tree
• Explicit list of simple_ids

Step 2: Pull from kanban

Use MCP:

1. list_issues(project_id, status_filter, tag_filter) for the candidate set
2. For each candidate: get_issue(issue_id) for the full description and tags
3. list_issue_relationships(issue_id) to capture blocks / blocked_by edges

Do NOT issue any write call. This skill is read-only against kanban.

Step 3: Map to local schema

For each kanban issue, build:

{
  "id": "L<n>",
  "title": "<kanban title>",
  "description": "<kanban description, verbatim>",
  "tier": "<read from tag tier:t0..t4, fallback T2>",
  "depends_on": ["L<m>", "..."],
  "tags": ["<kanban tags except tier:* and the internal vibe-flow ones>"],
  "brainstorm": "<from tag brainstorm:interactive|autonomous, else null>",
  "files_hint": [],
  "kanban_id": "<issue_id>",
  "simple_id": "<simple_id>"
}