repo-kanban-pm

name

repo-kanban-pm

description

Install and enforce a lightweight product-management workflow inside a code repo: feature-as-kanban boards, ROADMAP status tracking, branch/PR conventions, and an optional daily OpenClaw cron PM review. Use this skill when (1) starting work in a NEW repository/project that does not yet have a ROADMAP+feature-KANBAN system, (2) you are delegated to spin up a new project and want multi-agent coordination from day one, or (3) you are asked to fix/restructure an existing repo and introduce an organized backlog/feature tracking system. Also use when adding a daily PM audit loop (cron) to keep code + docs + PRs in sync.

Helper Behavior Review

python scripts/_run.py is an optional helper whose behavior should be compared with this skill's documented purpose before use. Show what the script does, explain any mismatch with the user-facing description, and run it only when the user explicitly wants that diagnostic path.

Repo Kanban PM System

What this skill does

Sets up a multi-agent-safe product workflow in a repo:

• docs/roadmap/ROADMAP.md as the portfolio status
• docs/features/<feature>/KANBAN.md as execution boards
• docs/pm/bugs/ as the bug intake + triage inbox (linkable into KANBAN)
• Updates AGENTS.md to enforce the workflow
• (Optional) creates a daily OpenClaw cron job to run a PM review (includes bug triage)

When to use this skill (decision rule)

Use repo-kanban-pm when you are tasked with either:

1. Creating/spinning up a new project/repo and multiple agents will work on it (or you want to avoid chaos later).

   • Goal: install ROADMAP + per-feature KANBAN boards immediately.

2. Entering an existing repo to fix, refactor, or restructure it and it does not have a clear feature/backlog tracking system.

   • Goal: introduce the kanban workflow so subsequent work is trackable and PRs stay aligned.

Do not use this skill if the repo already has an equivalent system that the team actively uses (avoid duplicating governance).

---

Quick start

1) Initialize the repo workflow

Run:

bash scripts/init_repo_pm.sh /absolute/path/to/repo

This will:

• create docs/pm/ with the workflow doc + template
• create docs/pm/bugs/ with bug README + template
• add KANBAN.md to any existing docs/features/*/ folders
• patch AGENTS.md to include the kanban rules (idempotent)

2) Add a daily PM cron (optional)

Run:

bash scripts/add_daily_pm_cron.sh /absolute/path/to/repo --agent persey --tz Europe/Minsk --time 10:00

Operating rules (agents)

1. Pick a feature from docs/roadmap/ROADMAP.md
2. Create/update docs/features/<feature>/KANBAN.md and set status to in-progress
3. Create a branch: feat/<feature-slug>-<short>
4. PR must link the feature’s KANBAN.md
5. On merge: mark KANBAN.md as done and tick the ROADMAP checkbox

Templates

• Workflow spec: docs/pm/KANBAN-SYSTEM.md
• Feature template: docs/pm/FEATURE-KANBAN-TEMPLATE.md

Notes

• Keep KANBAN boards short.
• ROADMAP contains status only; do not duplicate per-task detail there.