# Mk Watzup

> Generate short handoff reports from Git branches, remote refs, worktrees, unfinished plans, and roadmap docs. Surfaces priority-ranked next steps with checkbox progress and rationale. Use when the user asks what's in flight, wants progress/next steps, is in a fresh worktree or detached checkout, or needs end-of-session status.

- Skill: `phuc-nt/mk-watzup` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx skillmds@latest add phuc-nt/mk-watzup`
- Raw SKILL.md: https://api.skillmd.com/api/skills/phuc-nt/mk-watzup/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: phuc-nt (https://skillmd.com/u/phuc-nt)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/phuc-nt/mk-watzup

---


# Wrap Up

Create a short, evidence-backed handoff report for the active project, with priority-ranked next steps grounded in plan progress and roadmap state.

This skill handles status and handoff reporting only. It does not implement, edit, commit, checkout, merge, push, or fetch unless the user explicitly requests fresh remote refs.

## Required Scan

Run the scanner first from the project root:

```bash
node .claude/skills/watzup/scripts/watzup-scan.cjs --json
```

Use `--fetch` only when the user asks to refresh remotes before the report:

```bash
node .claude/skills/watzup/scripts/watzup-scan.cjs --json --fetch
```

When developing from this source repository before install, use `node claude/skills/watzup/scripts/watzup-scan.cjs --json` only if `.claude/skills/...` is not present.

Default behavior:
- Scan local branches and remote branch refs.
- Scan registered worktrees.
- Scan unfinished plans from visible worktrees and tracked branch refs.
- Count `- [ ]` / `- [x]` checkboxes in each plan directory (plan.md + phase-*.md) for progress %.
- Scan `docs/*roadmap*.md` and `docs/*milestones*.md` for active milestones.
- Build priority-ranked next steps via composite scoring (see below).
- Do not run network operations.
- Do not change branches or mutate the checkout.

## Priority Ranking

The scanner now emits `nextSteps[]` as objects with `{priority, action, rationale, planId?}`. Ordering reflects a composite score per plan:

- **Status**: `in-progress` (+400) > `in-review` (+300) > `pending` (+150).
- **Workspace alignment**: current worktree (+600), current branch (+400).
- **Provenance**: filesystem source (+80), local ref (+40).
- **Momentum**: plans between 40-90% complete get bumped (close to done). Brand-new plans (<10%) get a small starter bump.

Hygiene steps (dirty working tree, detached HEAD) always rank first. Roadmap milestones fill remaining slots after plan-driven actions.

## Report Format

Keep output brief. Prefer this structure:

1. **Current State** - branch or detached HEAD, dirty/clean, active worktree.
2. **Recent Work** - only the highest-signal branches/worktrees.
3. **In-Flight Plans** - unfinished plans with `X/Y todos · NN% done` annotation.
4. **Roadmaps** - active milestones from `docs/*roadmap*.md`, if any.
5. **Next Steps** - 5 to 6 priority-ranked actions, each with one-line rationale.
6. **Warnings** - scanner failures, stale remote-ref caveat, detached HEAD.

If the scanner fails, say it failed and include the error. Then use minimal read-only fallback commands:

```bash
git status --short --branch
git worktree list --porcelain
git for-each-ref --format='%(refname:short) %(committerdate:iso8601) %(objectname:short) %(subject)' refs/heads refs/remotes
find plans -maxdepth 2 -name plan.md -print
find docs -maxdepth 2 -iname '*roadmap*.md' -print
```

Do not pretend the full scan completed when fallback was used.