# Hs Sw Sprint Status Sync

> Refresh the sprint status bar — re-queries beads and regenerates tmp/sprint-status.sh when displayed status diverges from reality

- Skill: `harpreetsingh/hs-sw-sprint-status-sync` (Agent Skill)
- Install (CLI): `npx skillmds@latest add harpreetsingh/hs-sw-sprint-status-sync`
- Raw SKILL.md: https://api.skillmd.com/api/skills/harpreetsingh/hs-sw-sprint-status-sync/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: harpreetsingh (https://skillmd.com/u/harpreetsingh)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/harpreetsingh/hs-sw-sprint-status-sync

---


# /sprint-status-sync — Sync Sprint Status Bar

Regenerates `tmp/sprint-status.sh` from the current beads state. Use this
when the displayed status is wrong (e.g. shows 0/14 done after sprint closed,
or wave symbols are stale).

## Process

### Step 1 — Find ticket IDs

Two sources, in order:
1. **Existing script**: read `tmp/sprint-status.sh` — extract `ALL_IDS` and `WAVES` from it (fastest path)
2. **Sprint plan**: if no script, read `tmp/sprint-exec-plan.md` or `<feature_dir>/sprint-plan.md` — extract ticket IDs and wave groupings

If neither exists: tell user "No sprint plan found. Run `/hs-sw-sprint-exec-plan` to regenerate." and stop.

### Step 2 — Query current status

- Run `bd show <all-ids> --json` and parse actual statuses
- A ticket is "done" when it has the `qa-passed` label (agents never close beads — humans do)
- Show a quick summary: how many done (qa-passed) / in_progress / open
- If all done: note "Sprint appears complete — consider `/sprint-status-clear` instead"

### Step 3 — Regenerate script

- Rewrite `tmp/sprint-status.sh` with the same wave mapping but fresh from the plan
- Get absolute project path via `pwd`
- Script template:

```bash
#!/usr/bin/env bash
# Sprint status line — regenerated by /sprint-status-sync
# <timestamp>

cd <abs-path> 2>/dev/null || true

ALL_IDS="<space-separated ids>"

bd show $ALL_IDS --json 2>/dev/null | python3 -c '
import sys, json

try:
    data = json.load(sys.stdin)
except Exception:
    print("Sprint: loading...")
    sys.exit(0)

# Build status map: "done" = has qa-passed label (agents never close beads)
statuses = {}
for item in data:
    if "id" not in item:
        continue
    labels = item.get("labels", [])
    if "qa-passed" in labels:
        statuses[item["id"]] = "done"
    else:
        statuses[item["id"]] = item.get("status", "open")

WAVES = [
    # Wave 1
    ["id1", "id2"],
    # Wave 2
    ["id3", "id4"],
    # ... one list per wave
]

def wave_symbol(ids):
    stats = [statuses.get(i, "open") for i in ids]
    if all(s == "done" for s in stats):
        return "\u2713"
    if any(s in ("in_progress", "done") for s in stats):
        return "\u25d0"
    return "\u25cb"

all_ids = [i for w in WAVES for i in w]
total = len(all_ids)
done = sum(1 for i in all_ids if statuses.get(i) == "done")

bar = ""
for i in all_ids:
    s = statuses.get(i, "open")
    if s == "done":
        bar += "\u25a0"
    elif s == "in_progress":
        bar += "\u25a3"
    else:
        bar += "\u25a1"

wave_parts = " ".join(
    "W{}:{}".format(n + 1, wave_symbol(w)) for n, w in enumerate(WAVES)
)

print("Sprint: {} {}/{} done \u00b7 {}".format(bar, done, total, wave_parts))
' || echo "Sprint: loading..."
```

- `chmod +x tmp/sprint-status.sh`
- Verify: run `bash tmp/sprint-status.sh` and show the output

### Step 4 — Ensure settings.json is wired

- Check the project-level `.claude/settings.json` for `statusLine` (NOT `~/.claude/settings.json` — never touch global settings)
- If missing: add it pointing to `<abs-path>/tmp/sprint-status.sh`
- If present but pointing elsewhere: update to current path
- If `statusLine` exists in `~/.claude/settings.json` for this sprint: warn the user to remove it manually (it will bleed into all sessions)

### Step 5 — Report

```
✓ Sprint status bar synced.
  Current: Sprint: ■■■■■■■■■■■■■■ 14/14 done · W1:✓ W2:✓ W3:✓ W4:✓ W5:✓ W6:✓

If still showing stale output, reload Claude Code (Cmd+R).
Sprint complete? Run /sprint-status-clear to remove the bar.
```