| 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
When NOT To Use
- Delivery-performance metrics (use
minister:dora-metrics)
- Approving a release (use
minister:release-health-gates)
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
- Capture work via
tracker.py add or sync from GitHub Projects.
- Review blockers/highlights using the Blocker Radar table.
- Generate GitHub comment via
tracker.py status --github-comment or module snippets.
- 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.
