tomevault-io 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
- Capture work via
tracker.py addor sync from GitHub Projects. - Review blockers/highlights using the Blocker Radar table.
- Generate GitHub comment via
tracker.py status --github-commentor 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
phasein 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.
Converted and distributed by TomeVault — claim your Tome and manage your conversions.