Github Initiative Pulse

---
name: github-initiative-pulse
description: |

Triggers: github, dashboards, reporting, pulse, initiative
  Generate program dashboards, GitHub-ready comment digests, and CSV summaries
  sourced from Minister's tracker data.

  Triggers: initiative pulse, status report, weekly update, stakeholder briefing,
  github dashboard, blocker radar, initiative health, program metrics

  Use when: creating status reports, weekly updates, stakeholder briefings,
  generating GitHub comment digests, tracking initiative health

  DO NOT use when: release gates/readiness - use release-health-gates.
  DO NOT use when: project planning - use spec-kit:speckit-orchestrator.

  Outputs markdown digests and CSV exports for GitHub issues and PRs.
version: 1.3.5
category: project-management
tags: [github, projects, reporting, status, dashboards]
dependencies: []
tools: [minister-tracker]
provides:
  reporting: [status-digest, github-comment]
  governance: [blocker-radar, initiative-health]
usage_patterns:
  - weekly-status
  - issue-digests
  - release-briefings
complexity: foundational
estimated_tokens: 650
progressive_loading: true
modules:
  - modules/status-digest.md
  - modules/github-comment-snippets.md
---

# GitHub Initiative Pulse

## Overview

Turns tracker data and GitHub board metadata into initiative-level summaries. Provides markdown helpers and CSV exports for pasting into issues, PRs, or Discussions.

## Ritual

1. Capture work via `tracker.py add` or sync from GitHub Projects.
2. Review blockers/highlights using the **Blocker Radar** table.
3. Generate GitHub comment via `tracker.py status --github-comment` or module snippets.
4. Cross-link the weekly Status Template and share with stakeholders.

## Key Metrics

| Metric | Description |
|--------|-------------|
| Completion % | Done tasks / total tasks per initiative. |
| Avg Task % | Mean completion percent for all in-flight tasks. |
| Burn Rate | Hours burned per week (auto-calculated). |
| Risk Hotlist | Tasks flagged `priority=High` or due date in past. |

## GitHub Integrations

- Links every task to an issue/PR URL.
- Supports auto-labeling by referencing `phase` in the tracker record.
- Encourages posting digests to coordination issues or PR timelines.

## Exit Criteria

- All initiatives represented with updated metrics.
- Markdown digest pasted into relevant GitHub thread.
- Risk follow-ups filed as issues with owners + due dates.
## Troubleshooting

### Common Issues

If metrics appear outdated, ensure `tracker.py` has successfully synced with GitHub. If the Markdown digest renders incorrectly in GitHub, check for unescaped characters in task titles or missing newlines between table rows.