Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@
"name": "edge-scrum",
"source": "./plugins/edge-scrum",
"description": "Agents, skills, and workflows relevant to scrum process management for the OpenShift Edge Team",
"version": "1.5.0"
"version": "1.6.0"
},
{
"name": "git-commits",
Expand Down
2 changes: 1 addition & 1 deletion plugins/edge-scrum/.claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"name": "edge-scrum",
"description": "Agents, skills, and workflows relevant to scrum process management for the OpenShift Edge Team",
"version": "1.5.0",
"version": "1.6.0",
"author": { "name": "jeff-roche" },
"homepage": "https://github.com/openshift-eng/edge-tooling",
"license": "Apache-2.0"
Expand Down
9 changes: 8 additions & 1 deletion plugins/edge-scrum/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -107,7 +107,14 @@ Output is saved to `.reports/release_planning_{version}_{YYYY-MM-DD}.md`.

### chai-bot Skills

Playbooks under [`chai/`](chai/) are for the chai-bot coordinator, not Claude Code.
Playbooks under [`chai/`](chai/) are for the chai-bot coordinator, not Claude Code. Register them with chai-bot from `plugins/edge-scrum/chai/`. They are read-only, ask no questions, use no sub-agents, and run the [`bin/`](bin/) scripts in `sandbox_exec` on data fetched with chai-bot's Jira tools ([`bin/chai_jira_adapter.py`](bin/chai_jira_adapter.py) converts `query_jira` text into the scripts' input).

| Skill | What it does |
|-------|--------------|
| [`scrum-context`](chai/scrum-context/SKILL.md) | Current sprint and week, release phases, ceremonies, team availability per sprint |
| [`sprint-health`](chai/sprint-health/SKILL.md) | Team-level sprint health: capacity mode in week 1, mid-sprint mode after |
| [`release-health`](chai/release-health/SKILL.md) | One release: refinement and test-plan spike gaps, or capacity vs scope, cut line and features at risk |
| [`weekly-health-report`](chai/weekly-health-report/SKILL.md) | The weekly report of edge-context decision 0018: 3-line post, details and owner-mentioned actions in the thread |

#### `scrum-context`

Expand Down
13 changes: 13 additions & 0 deletions plugins/edge-scrum/bin/_jira_transforms.py
Original file line number Diff line number Diff line change
Expand Up @@ -365,6 +365,19 @@ def days_between(start, end, inclusive=True):
return delta + 1 if inclusive else delta


def sprint_day_counts(start, end, today):
"""``(days elapsed, days remaining, total days)`` of a sprint, in calendar days.

The single definition shared by ``transform-sprints.py`` (Claude Code) and
``chai_report.py`` (chai-bot). ``total`` counts the start and end days;
``elapsed`` counts today, clamped to ``[0, total]``; ``remaining`` is
``total - elapsed``, so ``elapsed + remaining == total``.
"""
total = days_between(start, end)
elapsed = max(0, min(days_between(start, today), total))
return elapsed, total - elapsed, total


def business_days_between(start, end):
"""Business days (Mon-Fri) between start (exclusive) and end (inclusive)."""
s = parse_date(start)
Expand Down
48 changes: 33 additions & 15 deletions plugins/edge-scrum/bin/assemble-report.py
Original file line number Diff line number Diff line change
Expand Up @@ -92,14 +92,24 @@ def build_blocks(checks, recs, params):

risk = meta.get("overall_risk", "LOW")
gap = meta.get("gap_sp", 0)
hidden = checks.get("hidden_scope", {})
gap_hidden_low = meta.get("gap_with_hidden_low", gap)
gap_hidden_high = meta.get("gap_with_hidden_high", gap)
# run-checks --no-hidden-scope-estimate emits these keys as None: never format
# them, and leave the hidden-scope figures out of the report.
hidden_estimated = all(v is not None for v in (
hidden.get("estimate_low", 0), hidden.get("estimate_high", 0), gap_hidden_low, gap_hidden_high))
headline = recs.get("headline") or recs.get("executive_summary") or ""
glyph = RISK_GLYPH.get(risk, "")
if gap < 0:
verdict = f"**{glyph} {risk} — ~{abs(gap)} SP must leave the release.**"
elif gap_hidden_low < 0:
elif hidden_estimated and gap_hidden_low < 0:
Comment thread
coderabbitai[bot] marked this conversation as resolved.
Resolved
verdict = (f"**{glyph} {risk} — pointed scope fits with {gap} SP to spare, but not once unpointed work "
f"is estimated ({gap_hidden_low:+d} SP at the high estimate).**")
elif not hidden_estimated and hidden.get("unpointed_open", 0) > 0:
# Not estimated: the gap covers pointed work only; count the rest, never size it.
verdict = (f"**{glyph} {risk} — pointed scope fits with ~{gap} SP to spare; "
f"{plural(hidden['unpointed_open'] + hidden.get('unpointed_bugs', 0), 'unpointed item')} not counted.**")
else:
verdict = f"**{glyph} {risk} — scope fits with {gap} SP to spare.**"
verdict += (f" {plural(params['remaining_sprints'], 'dev sprint')} left · pencils down S{params['pencils_down']}"
Expand Down Expand Up @@ -131,20 +141,28 @@ def build_blocks(checks, recs, params):
verdict += f"\n\n{headline}"
blocks["VERDICT"] = [{"t": "p", "text": verdict}]

hidden = checks.get("hidden_scope", {})
blocks["SUMMARY_STRIP"] = [{
"t": "table",
"headers": ["Scope (pointed)", "Hidden scope", "Capacity", "Gap"],
"align": ["r", "r", "r", "r"],
"rows": [[
f"**{meta['total_remaining_sp']} SP**",
f"{hidden.get('unpointed_open', 0)} stories unpointed ({hidden.get('unpointed_assigned', 0)} assigned)"
f" ≈ {hidden.get('estimate_low', 0)}–{hidden.get('estimate_high', 0)} SP"
+ (f"; {hidden.get('unpointed_bugs', 0)} unpointed bugs (excl.)" if hidden.get("unpointed_bugs") else ""),
f"**{meta['total_capacity_sp']} SP**",
f"**{gap:+d} SP** ({meta.get('gap_with_hidden_low', gap):+d} to {meta.get('gap_with_hidden_high', gap):+d} incl. hidden)",
]],
}]
if hidden_estimated:
blocks["SUMMARY_STRIP"] = [{
"t": "table",
"headers": ["Scope (pointed)", "Hidden scope", "Capacity", "Gap"],
"align": ["r", "r", "r", "r"],
"rows": [[
f"**{meta['total_remaining_sp']} SP**",
f"{hidden.get('unpointed_open', 0)} stories unpointed ({hidden.get('unpointed_assigned', 0)} assigned)"
f" ≈ {hidden.get('estimate_low', 0)}–{hidden.get('estimate_high', 0)} SP"
+ (f"; {hidden.get('unpointed_bugs', 0)} unpointed bugs (excl.)" if hidden.get("unpointed_bugs") else ""),
f"**{meta['total_capacity_sp']} SP**",
f"**{gap:+d} SP** ({gap_hidden_low:+d} to {gap_hidden_high:+d} incl. hidden)",
]],
}]
else:
blocks["SUMMARY_STRIP"] = [{
"t": "table",
"headers": ["Scope (pointed)", "Capacity", "Gap"],
"align": ["r", "r", "r"],
"rows": [[f"**{meta['total_remaining_sp']} SP**", f"**{meta['total_capacity_sp']} SP**",
f"**{gap:+d} SP**"]],
}]

blocks["STATS_LINE"] = [{"t": "small", "text": (
f"{plural(meta['active_features'], 'active feature')} · {meta['dormant_features']} dormant · "
Expand Down
Loading
Loading