twg-status-rollups

# twg-status-rollups Use with the root `twg` skill. Get exact command grammar from live `twg help`, `twg help <terms>`, or `twg help describe <path>`. ## CLI launcher fallback Run `twg <command>`. On shell `command not found`, use `$HOME/.local/bin/twg` (macOS/Linux) / `$env:LOCALAPPDATA\Programs\twg\bin\twg.exe` (PowerShell), then tell user to add that directory to PATH. Do not treat auth or command errors as PATH failures. ## Use When - "What did I/person/team/org work on?", weekly update, standup, handoff, or restart after time away - "Status of project/goal/topic/focus area" - "Is this project ready to launch?" or go/no-go brief - Leadership, monthly, annual, cycle, appraisal, or goal-alignment readout - Org bottlenecks, priorities, stale goals, or project risks ## First Move Resolve scope before retrieval: - Person/team/org: resolve identity, roster, or org-tree groups. - Project, goal, focus area, or topic: resolve native key, ARI, URL, name, or a central page/workitem anchor. Establish the time window. If absent, ask when precision matters; otherwise use a recent bounded window and state it. Keep personal summaries to a year or less. ## Tree Routing Matrix - `pr-tree`: merged/open PRs, reviews, shipped work, or repo momentum by manager or team. Default for PR-constrained evidence. - `org-tree`: manager chain, roster, and reporting structure; grouping only, not delivery evidence. - `workitem-tree`: Jira issue load and active/done movement by org tree. - `work-tree`: multi-surface org counts across Jira, PRs, goals, projects, docs, videos. Not for PR-only or Jira-only asks. ## Fast Path: PR-Based Leadership Rollup For PR-based leadership prompts: 1. Preserve the requested scope and window; for "last 2 weeks," use `--since 14d`. 2. Use `pr-tree` first. It groups by reporting-tree `directReports`; add `org-tree` only for hierarchy context. 3. If option shape is uncertain, inspect `twg help describe "pr-tree"` before the data call; do not probe incompatible flag combinations. 4. Start count-first, then at most one supported sampling/full-fetch pass for repo or theme evidence, and synthesize at manager/team level. Do not issue per-person queries to populate groups; add one targeted PR follow-up only when a material theme lacks proof. 5. Add one secondary surface only for a named gap. Target 2-4 calls. ## Evidence Policy - Match evidence to prompt constraints; merged-PR conclusions need PR evidence. - Start count-first on tree surfaces; hydrate examples only for themes, risks, or owner attribution. - Rank broad lists before minimal hydration. - Hydrate the ranked set in one call, never one per item: `goals get`, `projects get`, `focus-areas get`, `jira workitem get`, `docs get`, and `pull-requests get` take every key or URL at once. - Distinguish authored delivery from review, coordination, and influence. - Stop when evidence is sufficient. After two identical backend failures, stop that path and report the gap. ## Recipe Cards ### Person Or Personal Update Resolve the person, then pull recent Jira work, PRs, docs/pages, meetings, and project/goal involvement. Load `references/personal-work-summary.md` for subject, notification, PR hydration, and outcome-first rules. Separate delivery, review, docs/strategy, coordination, and influence. ### Short-Window Personal Update / Standup Load `references/personal-work-summary.md`. Resolve the person, preserve the requested project and window, prioritize material work, and separate evidence gaps from confirmed blockers. ### Team Or Org Leadership Readout Resolve org-tree first. Org projects: `twg projects query --scope org --include-inferred` (`[Paid: Enriched]`). Group results; hydrate outliers affecting momentum, blockers, or ownership. ### Project Or Goal Status Fetch the native project/goal first, with owner, state, update, links, dates, and recency. Hydrate only risk, progress, or dependency evidence. ### Decision Readiness / Go-No-Go Load `references/decision-readiness.md`. Resolve the native project or decision anchor first and keep explicit links as the scope boundary. Identify the gates, then give the decision or recommendation with confidence, gaps, and change conditions. Do not infer owners. ### Topic Status Resolve/search once, select central project, goal, page, or workitem anchors, then hydrate those before broad work/activity queries. ## References - `references/personal-work-summary.md` - standups, catch-ups, and broader personal status evidence - `references/decision-readiness.md` - cross-domain go/no-go and approval evidence ### Appraisal / Performance Evidence Resolve person and horizon. Separate delivery, review, collaboration, docs/strategy, project/goal impact, and stakeholder signals. Avoid count-only ranking; caveat weak evidence. ## Output Shape - Executive summary first, with 3-6 high-signal observations. - Table with owner/team/workstream, positive and risk signals, current focus, confidence, and evidence. - Risks ranked by impact and owner. - Confidence and gaps: stale updates, missing coverage, ACL gaps, or sampling boundaries. ## Anti-Patterns - Do not list every artifact. - Do not infer goal/project health from issue counts alone. - Do not fan out per org member when manager/team grouping answers the prompt. - Do not use search snippets as final evidence for status or risk. - Start explicit merged/open PR rollups with `pr-tree`, not the other trees.