-
Notifications
You must be signed in to change notification settings - Fork 3.8k
Add roundup plugin: self-configuring status briefing generator #1157
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Merged
Merged
Changes from 1 commit
Commits
Show all changes
5 commits
Select commit
Hold shift + click to select a range
065a244
Add roundup plugin: self-configuring status briefing generator
dvelton 6c36ee0
Address PR review comments
dvelton 3f0eae9
Improve example-pasting UX in setup flow
dvelton 56d6256
Reinforce that more examples = better output
dvelton f2c720f
Merge upstream/staged into roundup-plugin
dvelton File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,24 @@ | ||
| { | ||
| "name": "roundup", | ||
| "description": "Self-configuring status briefing generator. Learns your communication style from examples, discovers your data sources, and produces draft updates for any audience on demand.", | ||
| "version": "1.0.0", | ||
| "author": { | ||
| "name": "Awesome Copilot Community" | ||
| }, | ||
| "repository": "https://github.com/github/awesome-copilot", | ||
| "license": "MIT", | ||
| "keywords": [ | ||
| "status-updates", | ||
| "briefings", | ||
| "management", | ||
| "productivity", | ||
| "communication", | ||
| "synthesis", | ||
| "roundup", | ||
| "copilot-cli" | ||
| ], | ||
| "skills": [ | ||
| "./skills/roundup-setup/", | ||
| "./skills/roundup/" | ||
| ] | ||
| } |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,101 @@ | ||
| # Roundup | ||
|
|
||
| Status briefing generator that learns how you communicate. | ||
|
|
||
| Roundup watches your work across GitHub, email, Teams, Slack, and other tools, then drafts status updates and briefings in your own voice for any audience you define. | ||
|
|
||
| ## The Problem | ||
|
|
||
| Managers and team leads spend hours each week assembling status updates from scattered sources: scanning PR activity in GitHub, reading email threads for decisions, checking Teams or Slack for context, then rewriting all of it for different audiences at different levels of detail. | ||
|
|
||
| The data to write these updates already exists. The work is in gathering it and packaging it. Roundup automates the gathering and drafting. You provide quality control and hit send. | ||
|
|
||
| ## How It Works | ||
|
|
||
| **First time (5 minutes):** Run the setup skill. It asks about your role, your audiences, and where your team's work happens. Then you paste in an example or two of updates you've already written. From those examples, it learns your format, tone, structure, and what you include vs. skip. | ||
|
|
||
| **Every time after:** Tell roundup which audience you're writing for. It pulls fresh data from your configured sources, synthesizes across them, and drafts a briefing matching your style. | ||
|
|
||
| ## Installation | ||
|
|
||
| ```bash | ||
| copilot plugin install roundup@awesome-copilot | ||
| ``` | ||
|
|
||
| ## Getting Started | ||
|
|
||
| ### First-Time Setup | ||
|
|
||
| ``` | ||
| use roundup-setup | ||
| ``` | ||
|
|
||
| The setup flow walks you through: | ||
| - Describing your role and team | ||
| - Pasting in example updates you've already written | ||
| - Defining your audiences (leadership, team, partners, etc.) and what each one cares about | ||
| - Identifying where your team's work and conversations happen | ||
|
|
||
| ### Generating a Briefing | ||
|
|
||
| ``` | ||
| use roundup | ||
| ``` | ||
|
|
||
| Or be more specific: | ||
|
|
||
| ``` | ||
| use roundup -- generate a leadership briefing covering this past week | ||
| ``` | ||
|
|
||
| ``` | ||
| use roundup -- draft a team update since Monday | ||
| ``` | ||
|
|
||
| ## What's Included | ||
|
|
||
| | Skill | What It Does | | ||
| |-------|-------------| | ||
| | `roundup-setup` | Interactive onboarding that learns your style, audiences, and data sources | | ||
| | `roundup` | Generates draft briefings from your config on demand | | ||
|
|
||
| ## What It Can Pull From | ||
|
|
||
| Roundup adapts to whatever tools are available in your environment: | ||
|
|
||
| | Source | What It Looks For | | ||
| |--------|-------------------| | ||
| | GitHub | PRs, issues, commits, review activity across your configured repos | | ||
| | M365 / WorkIQ | Email threads, Teams messages, calendar events, shared docs | | ||
| | Slack | Channel messages, threads, announcements | | ||
| | Google Workspace | Gmail, Calendar, Drive activity | | ||
|
|
||
| During setup, roundup discovers which of these you have access to and configures itself accordingly. If you add new tools later, re-run setup to include them. | ||
|
|
||
| No API keys or additional setup required beyond what's already configured in your Copilot CLI environment. | ||
|
|
||
| ## What Makes It Different | ||
|
|
||
| **It learns from your examples.** Rather than forcing you into a template, roundup analyzes how you actually write and replicates that style. Your briefings sound like you wrote them. | ||
|
|
||
| **It works with whatever you have.** GitHub only? Fine. Full M365 suite? Great. Mix of Slack and Google? Works too. The setup flow discovers your environment and adapts. | ||
|
|
||
| **Multiple audiences, one setup.** Define different audience profiles with different detail levels and formats. Same underlying data, different output for each. | ||
|
|
||
| **Your config is a readable file.** Everything roundup learned lives in `~/.config/roundup/config.md` -- plain markdown you can open, read, and hand-edit anytime. No opaque settings or hidden state. | ||
|
|
||
| ## Reconfiguring | ||
|
|
||
| To start setup over from scratch: | ||
|
|
||
| ``` | ||
| use roundup-setup | ||
| ``` | ||
|
|
||
| It will ask before overwriting your existing config. | ||
|
|
||
| To make small adjustments, just open `~/.config/roundup/config.md` in any text editor. The file is written in plain English and organized by section. Your changes are respected on the next run. | ||
|
|
||
| ## License | ||
|
|
||
| MIT | ||
Oops, something went wrong.
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.