# kanban:init

> Initialize kanban board infrastructure in project. Creates .kanban directory, copies viewer HTML, adds npm script. Use when setting up kanban board for first time.

- Author: orm
- Repository: ormizj/koalires
- Version: 20260120164156
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/ormizj/koalires
- Web: https://mule.run/skillshub/@@ormizj/koalires~kanban:init:20260120164156

---

---
name: kanban:init
description: Initialize kanban board infrastructure in project. Creates .kanban directory, copies viewer HTML, adds npm script. Use when setting up kanban board for first time.
allowed-tools: Bash, Read, Write, Edit
---

# Init Kanban Skill

Sets up the kanban board viewer infrastructure in the project.

## Steps

Execute these steps in order:

### 1. Create .kanban Directory

```bash
mkdir -p .kanban
```

### 1.5. Create Logs Directory

```bash
mkdir -p .kanban/logs
```

### 1.6. Create .gitignore

Create `.kanban/.gitignore` with content:

```gitignore
# Ignore worker logs
logs/
```

### 2. Copy Viewer Template (Always Override)

Read the template file from this skill directory and write it to the project:

- Source: `.claude/commands/kanban/init/kanban-viewer.template.html`
- Destination: `.kanban/kanban-viewer.html`

**Always overwrite** the existing file to ensure the latest template is used.

### 3. Initialize Empty Board File (Skip if Exists)

Create an initial kanban board at `.kanban/kanban-board.json` **only if it doesn't exist**:

```json
{
  "project": "Project Name",
  "projectType": "unknown",
  "tasks": []
}
```

This file will be populated by `/kanban:create`. Skip this step if the file already exists.

### 4. Initialize Empty Progress File (Skip if Exists)

Create an empty progress tracker at `.kanban/kanban-progress.json` **only if it doesn't exist**:

```json
{}
```

This is an object where keys are task names and values contain progress data:

```json
{
  "task-name": {
    "status": "running",
    "startedAt": "2026-01-20T10:00:00.000Z",
    "log": "Narrative of work done, useful for resuming context across sessions",
    "affectedFiles": ["path/to/file1.ts", "path/to/file2.ts"],
    "agents": ["backend-developer", "change-impact-analyzer"]
  }
}
```

Task status is derived from `passes` (kanban-board.json) and `status` (kanban-progress.json):

- `passes: true` + `status: "completed"` → completed
- `passes: true` + `status != "completed"` → code-review
- `passes: false` + `status: "blocked"` → blocked
- `passes: false` + entry exists in progress.json → in-progress
- No entry in progress.json → pending

Skip this step if the file already exists to preserve progress state.

### 5. Add NPM Script

Read `package.json`, add the following script to the `scripts` object:

```json
"kanban": "start http://localhost:4150/.kanban/kanban-viewer.html && npx serve . -p 4150 --cors"
```

Use the Edit tool to add this script.

## Completion

After completing all steps, report:

- Created `.kanban/` directory
- Created `.kanban/logs/` directory
- Created `.kanban/.gitignore`
- Created `.kanban/kanban-viewer.html`
- Created `.kanban/kanban-board.json`
- Created `.kanban/kanban-progress.json`
- Added `kanban` script to package.json

The user can now:

1. Run `/kanban:create <feature description>` to create a kanban board
2. Run `npm run kanban` to open the kanban board viewer
3. Run `/kanban:process` to start processing tasks