72 lines
2.8 KiB
Markdown
72 lines
2.8 KiB
Markdown
---
|
||
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."
|
||
---
|
||
|
||
# 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
|
||
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
|
||
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.
|