Status report
Return one snapshot-dated status board for the current repository and all of its
worktrees. Reconcile local state with current issue, pull-request, review, and CI
state before classifying anything.
Read-only contract
- Inspect and report only. Never fetch, pull, switch, edit repository or
worktree files, stage, commit, push, rerun CI, retrigger a reviewer, resolve a
thread, post a comment, or change PR state.
- Include every open PR regardless of author, automation, or target branch.
- Treat CI and review evidence as valid only for the current PR head. Any head
change resets both gates.
- Record the observation time and disclose unavailable, incomplete, stale, or
permission-limited sources. Missing evidence is pending, never green.
- Inspect every worktree, but preserve one card per logical work item. Attach a
linked worktree to its PR card; use
Local work only when no open PR
represents the work.
Gather evidence
- Resolve the repository, remote default branch, applicable instructions,
review policy, branch protection, and merge requirements without changing
local state. Distinguish live issue, pull-request, review, and CI data from
possibly stale remote-tracking refs.
- Paginate every open PR and read its URL, author, base and head refs, head
commit, draft and merge states, update time, review requests and decisions,
commit statuses, and check runs.
- For each current head, read inline review threads, top-level reviews,
summaries, walkthroughs, suggestions, nitpicks, and reviewer status. Discover
active review tools from repository configuration, protection rules, and
current PR evidence; a disabled, historical, or merely installed tool is not
a gate.
- Enumerate all repository worktrees and inspect branch, HEAD, upstream,
ahead/behind state, staged, unstaged, and untracked changes, recent commits,
and a compact diff summary. Do not mutate a worktree to inspect it.
- Map local branches and HEADs to PRs. A clean default checkout with no
divergent work needs no card. Preserve separate cards for distinct detached
or PR-less work.
When one read interface is unavailable or permission-limited, try another
configured authenticated read-only interface before declaring an evidence gap.
Current official Git hosting and reviewer semantics override enumerated status
names when an API evolves; preserve the completion gates rather than guessing.
Classify once
Render lanes in this visual order:
Local work → Draft → CI running → CI failed → Active review → Ready
Place each item in exactly one lane using this precedence:
- Local work: meaningful dirty, unpushed, or divergent work with no open PR.
- Draft: any draft PR. Show its CI and review condition on the card without
moving it to another lane.
- CI failed: a non-draft PR with any applicable current-head failure,
timeout, cancellation, action-required result, stale result, or equivalent
terminal failure. A failure outranks checks that are still running.
- CI running: a non-draft PR with no failure but at least one applicable
current-head check expected, queued, requested, pending, waiting, in progress,
missing, or unavailable.
- Active review: CI is terminal and green, but human review, an active
review tool, mergeability, or another repository readiness requirement is
incomplete or blocked.
- Ready: the PR is non-draft and mergeable under repository policy; every
applicable current-head check is terminal and accepted; required and
explicitly requested human reviews are complete; every active review tool
has a current-head terminal verdict; and no unresolved actionable finding
remains.
Repository policy decides whether a non-required check is advisory and how
neutral, skipped, or intentionally absent results are treated. Without explicit
policy, never reinterpret a visible failure as green.
Review completion
- Treat an explicitly requested human or automated reviewer as active. Pending
review requests and
CHANGES_REQUESTED remain open; apply the repository's
current-head approval-dismissal policy.
- For every active review tool, inspect inline threads plus top-level status,
summaries, suggestions, and nitpicks. A rate limit, quota response, error,
incomplete run, missing verdict, or review against an older head is pending.
- For every active automation, include its current-head summary or walkthrough
status and every unresolved inline or top-level nitpick. Apply the same
evidence-based semantics without hardcoding a provider.
- Do not infer that source changes resolved a finding. Use the current review
resolution and verdict evidence; expose uncertainty as a blocker.
Summarize local work
Write one short semantic sentence for each local or linked-worktree change.
Infer intent from the linked PR, current handoff when it matches the branch,
branch name, commit subjects, and diff together. Never guess: if intent remains
unclear, say so concisely.
Keep local metadata compact: branch, linked PR when present, dirty-state counts,
ahead/behind state, worktree identity, and short HEAD. Do not dump changed paths
or a full diff. Add one concise next action to every non-ready card; use
Ready to merge for ready cards.
Present the board
Read the rendering contract, then render all six
lanes even when empty. Order cards within a lane by oldest meaningful activity
first. Keep evidence and access warnings close to the affected card, and add a
short evidence-gap list only when the board cannot contain them cleanly.
Do not write a durable report or repository file unless the user separately
requests one.
1---2name: status-report3description: Builds a read-only current-repository Kanban from live pull-request, CI, review, branch, and worktree evidence. Use when the user asks for a status report, PR board, review-readiness board, or local-work overview.4license: Unlicense OR MIT5---67# Status report89Return one snapshot-dated status board for the current repository and all of its10worktrees. Reconcile local state with current issue, pull-request, review, and CI11state before classifying anything.1213## Read-only contract1415- Inspect and report only. Never fetch, pull, switch, edit repository or16 worktree files, stage, commit, push, rerun CI, retrigger a reviewer, resolve a17 thread, post a comment, or change PR state.18- Include every open PR regardless of author, automation, or target branch.19- Treat CI and review evidence as valid only for the current PR head. Any head20 change resets both gates.21- Record the observation time and disclose unavailable, incomplete, stale, or22 permission-limited sources. Missing evidence is pending, never green.23- Inspect every worktree, but preserve one card per logical work item. Attach a24 linked worktree to its PR card; use `Local work` only when no open PR25 represents the work.2627## Gather evidence28291. Resolve the repository, remote default branch, applicable instructions,30 review policy, branch protection, and merge requirements without changing31 local state. Distinguish live issue, pull-request, review, and CI data from32 possibly stale remote-tracking refs.332. Paginate every open PR and read its URL, author, base and head refs, head34 commit, draft and merge states, update time, review requests and decisions,35 commit statuses, and check runs.363. For each current head, read inline review threads, top-level reviews,37 summaries, walkthroughs, suggestions, nitpicks, and reviewer status. Discover38 active review tools from repository configuration, protection rules, and39 current PR evidence; a disabled, historical, or merely installed tool is not40 a gate.414. Enumerate all repository worktrees and inspect branch, HEAD, upstream,42 ahead/behind state, staged, unstaged, and untracked changes, recent commits,43 and a compact diff summary. Do not mutate a worktree to inspect it.445. Map local branches and HEADs to PRs. A clean default checkout with no45 divergent work needs no card. Preserve separate cards for distinct detached46 or PR-less work.4748When one read interface is unavailable or permission-limited, try another49configured authenticated read-only interface before declaring an evidence gap.50Current official Git hosting and reviewer semantics override enumerated status51names when an API evolves; preserve the completion gates rather than guessing.5253## Classify once5455Render lanes in this visual order:5657`Local work` → `Draft` → `CI running` → `CI failed` → `Active review` → `Ready`5859Place each item in exactly one lane using this precedence:60611. **Local work**: meaningful dirty, unpushed, or divergent work with no open PR.622. **Draft**: any draft PR. Show its CI and review condition on the card without63 moving it to another lane.643. **CI failed**: a non-draft PR with any applicable current-head failure,65 timeout, cancellation, action-required result, stale result, or equivalent66 terminal failure. A failure outranks checks that are still running.674. **CI running**: a non-draft PR with no failure but at least one applicable68 current-head check expected, queued, requested, pending, waiting, in progress,69 missing, or unavailable.705. **Active review**: CI is terminal and green, but human review, an active71 review tool, mergeability, or another repository readiness requirement is72 incomplete or blocked.736. **Ready**: the PR is non-draft and mergeable under repository policy; every74 applicable current-head check is terminal and accepted; required and75 explicitly requested human reviews are complete; every active review tool76 has a current-head terminal verdict; and no unresolved actionable finding77 remains.7879Repository policy decides whether a non-required check is advisory and how80neutral, skipped, or intentionally absent results are treated. Without explicit81policy, never reinterpret a visible failure as green.8283## Review completion8485- Treat an explicitly requested human or automated reviewer as active. Pending86 review requests and `CHANGES_REQUESTED` remain open; apply the repository's87 current-head approval-dismissal policy.88- For every active review tool, inspect inline threads plus top-level status,89 summaries, suggestions, and nitpicks. A rate limit, quota response, error,90 incomplete run, missing verdict, or review against an older head is pending.91- For every active automation, include its current-head summary or walkthrough92 status and every unresolved inline or top-level nitpick. Apply the same93 evidence-based semantics without hardcoding a provider.94- Do not infer that source changes resolved a finding. Use the current review95 resolution and verdict evidence; expose uncertainty as a blocker.9697## Summarize local work9899Write one short semantic sentence for each local or linked-worktree change.100Infer intent from the linked PR, current handoff when it matches the branch,101branch name, commit subjects, and diff together. Never guess: if intent remains102unclear, say so concisely.103104Keep local metadata compact: branch, linked PR when present, dirty-state counts,105ahead/behind state, worktree identity, and short HEAD. Do not dump changed paths106or a full diff. Add one concise next action to every non-ready card; use107`Ready to merge` for ready cards.108109## Present the board110111Read [the rendering contract](references/rendering.md), then render all six112lanes even when empty. Order cards within a lane by oldest meaningful activity113first. Keep evidence and access warnings close to the affected card, and add a114short evidence-gap list only when the board cannot contain them cleanly.115116Do not write a durable report or repository file unless the user separately117requests one.