pactkit-board

name	pactkit-board
description	Sprint Board atomic operations: add Story, update Task, archive completed Stories

PactKit Board

Atomic operations tool for Sprint Board (docs/product/sprint_board.md).

Script location: Use the base directory from the skill invocation header to resolve script paths.

Prerequisites

• docs/product/sprint_board.md must exist (created by /project-init)
• docs/product/archive/ directory is used for archiving (automatically created by the archive command)

Command Reference

add_story -- Add a work item (Story, Hotfix, or Bug)

python3 ${CLAUDE_PLUGIN_ROOT}/skills/pactkit-board/scripts/board.py add_story ITEM-ID "Title" "Task A|Task B"

• ITEM-ID: Work item identifier, e.g. STORY-001, HOTFIX-001, BUG-001
• Title: Item title
• Task A|Task B: Task list, use | as separator for multiple tasks
• Output: ✅ Story ITEM-ID added or ❌ error message

update_task -- Update Task status

python3 ${CLAUDE_PLUGIN_ROOT}/skills/pactkit-board/scripts/board.py update_task ITEM-ID "Task Name"

• Task Name: Must be an exact match with the task name in the Board
• Changes - [ ] Task Name to - [x] Task Name
• Output: ✅ Task updated or ❌ Task not found

archive -- Archive completed Stories

python3 ${CLAUDE_PLUGIN_ROOT}/skills/pactkit-board/scripts/board.py archive

• Moves all Stories with every task marked [x] to docs/product/archive/archive_YYYYMM.md

list_stories -- View current Stories

python3 ${CLAUDE_PLUGIN_ROOT}/skills/pactkit-board/scripts/board.py list_stories

snapshot -- Architecture snapshot

python3 ${CLAUDE_PLUGIN_ROOT}/skills/pactkit-board/scripts/board.py snapshot "v1.0.0"

• Saves current architecture graphs to docs/architecture/snapshots/{version}_*.mmd

fix_board -- Relocate misplaced stories to correct sections

python3 ${CLAUDE_PLUGIN_ROOT}/skills/pactkit-board/scripts/board.py fix_board

• Scans for stories outside their correct section and relocates them based on task status:
  • All [ ] → ## 📋 Backlog
  • Mixed [ ]/[x] → ## 🔄 In Progress
  • All [x] → ## ✅ Done
• Output: ✅ Board fixed: N stories relocated. or ✅ No misplaced stories found.

Usage Scenarios

• /project-plan: Use add_story to create a Story
• /project-act: Use update_task to mark completed tasks
• /project-done: Use archive to archive completed Stories
• pactkit-release skill: Use snapshot to archive architecture graphs during release
• pactkit-doctor skill: Use fix_board to repair misplaced stories