github-initiative-pulse git:20260601.8d67212A

Immutable. This exact content never changes and is served at /api/v1/blob/f61aa14b8c9cd8fb.

---
name: github-initiative-pulse
description: Generates markdown digests and CSV exports for GitHub initiative health. Use when reporting on issue/PR progress across a milestone or project.
alwaysApply: false
category: project-management
tags:
- github
- projects
- reporting
- status
- dashboards
dependencies: []
tools: []
provides:
  reporting:
  - status-digest
  - github-comment
  governance:
  - blocker-radar
  - initiative-health
usage_patterns:
- weekly-status
- issue-digests
- release-briefings
complexity: foundational
model_hint: standard
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 and 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.