tender is an IRC bot that helps you run standups for distributed teams using IRC.
#team: [11:00] < tender> Time for standup! It's in #standup #standup: [11:00] < tender> Time for standup! Tell me 'start' when everyone's here. [11:00] --> bob has joined #standup [11:00] --> alice has joined #standup [11:00] < markpasc> tender: start [11:00] < tender> alice: your turn [11:00] < alice> i did some stuff and it was pretty awesome [11:00] < alice> tender: next [11:00] < tender> bob: your turn [11:01] < bob> i also got some things done [11:01] < bob> today i'm hell of rocking something else [11:01] < bob> i forgot i had to talk to alice about getting the splines reticulated though [11:02] < alice> tender: park reticulating the splines [11:02] < tender> alice: Parked. [11:02] < bob> tender: next [11:02] < tender> markpasc: your turn [11:02] < markpasc> i also did some awesome stuff but today's stuff is even more awesomer [11:02] < markpasc> tender: next [11:02] < tender> All done! Standup was 2 minutes. back in #team: [11:02] < tender> Parked topics: [11:02] < tender> * reticulating the splines
You'll need these things to run tender:
- Perl 5.10
Once you have these, copy the
standup.yaml and customize it for your team. Specify any of Bot::BasicBot's attributes to set them for your bot. One attribute of particular note is:
ignore_list: the names of people to ignore. Include the other bots you use in your standup channel here and they won't be called on.
The standups are configured in the
standups setting. It's a list in case you want to run multiple standups on your server, but you probably only have one at first. For each standup you can specify:
id: a code name for that team.
team_channel: the channel the team normally chats in. The bot announces standups to this channel, and afterward pastes the parking lot there.
standup_channel: the channel to run the standup in. Anyone in this channel (except for other bots named in the
ignore_list) are considered "the team" and will be called on during the standup. If you have no lurking chickens, this can be the same as the
schedule: a cron style specification for when your standups are. See
man 5 crontabfor how to write one of these. If not specified, standups only happen when started manually with the
schedule_tz: the time zone
scheduleis specified in. This is also the main time zone used by the
whencommand, so it should be the primary time zone for your team. If not specified, times are in UTC.
additional_tz: another time zone your team uses. The
whencommand also says what time the next standup is in this time zone. If not specified,
whenonly lists one time zone.
Once you've configured it, run:
$ perl Standup.pm
to start the bot.
Standups are better when held at a regular time, so when you can, configure tender with a schedule. Tender will tell you when it's time to have the meeting (though a little warning is always nice, so you should still keep a meeting alarm in your calendar). Use the
when command to ask tender when it will call the next scheduled standup. When you need to hold a standup at an odd time, or if you can't really schedule your team's standup, you can ask for a standup manually with the
standup or if a standup was scheduled, you can start the standup with
start or cancel it with
Once the standup starts, the last person to arrive in the standup channel will be called on first. Once you've given your update, use the
next command to pass to someone else. Once everyone has gone, tender will say so and end the meeting. If you wonder who hasn't yet taken their turns, you can ask with the
left command. (Don't worry if someone arrives late: as long as they join the standup channel before the last person has gone, they'll get called on to take their turn.)
During the meeting, if a topic comes up that needs discussion, park it for later with the
park <topic> command. Tender will repeat these topics in the team channel when the meeting is over.
Everyone should try to stay present during the meeting to help keep it short. However if someone had to go AFK and it becomes their turn, you can also use the
next command during someone else's turn to come back to them later. Tender will pick someone else to go next instead. However, if everyone else has gone, they might be the only team member left to pick, and will get picked again immediately. If someone is in the standup channel accidentally when they aren't actually present, use the
skip <name> command and they'll be skipped for the whole meeting. (Avoid being that person by not lurking in the standup channel between meetings.)
standup: manually ask for a standup.
start: begin a standup that was scheduled or asked for with
cancel: cancel a standup that was scheduled or asked for, before it's started with
next: finish your turn, passing it to someone else.
skip <name>: skip over someone for the rest of the meeting.
park <topic>: park a topic for later.
left: ask who hasn't yet taken their turns in the open meeting.
when: ask when the next scheduled standup will be.
help: ask tender about these commands.