dansteele/retro-ken

A slack bot for doing retrospectives with the team

Retro Ken

---

Retro Ken is a bot for automating your retrospectives with your team. It is based on the awesome slack-ruby-bot.

Install (quick)

To get up and running off your local machine, just add a new bot, then run

SLACK_API_TOKEN=my-token-from-slack RACK_ENV=production rackup config.ru -p 24558

Commands

Ken expects there to be no more than one Retrospective being referenced at any point. An advantage of this is you can interact with the same retrospective in either one large chat, or via DMs to Ken.

Either speak to Ken publicly with @retro-ken, or you can leave this out when speaking to him in a DM.

Retrospectives

Start / stop a retrospective

retro start
retro stop

Adding a thought

A thought is either a 'continue' or 'stop' thought. You can send a thought to Ken when there's a retrospective running. Like the way something is being done in your company? Message ken with something like

+ I love the new reviewing process

Want something to change?

- The new reviewing process is too time consuming

Anonymity

Append 'anon' to the end of your thought. Anonymity is applied to each thought. This enables those who are worried about speaking up about a certain issue to do so.

- Directionless company branding anon

Voting

To spit out a list for people to vote on, use

retro messages

Summaries

To view the results

retro summary

This prints out all of the messages that had a reaction in order of positivity, and displays the quantity of each reaction.

retro summary quick

Shows how many positive/negative messages there were.

Contributing

See CONTRIBUTING.

retro-ken's Issues

Remove icons from messages

✅ and 🚫 make it confusing for people to 👍 or 👎. Let's just remove them.

Ken should take bulk messages

I'd like to be able to submit feedback in the following format and the bot to interpret it as separate messages:

In one message

• I liked thing 1
• I liked thing 2
• I liked thing 3

• I didn't like thing 4

Use case: I might collect my feedback over the week in notes and posting it item by item could be tidious

Make hostable on Heroku

Currently, Ken speaks to the DB directly, which isn't Heroku-friendly. Perhaps use Sequel to manage the connection?

Ken should message people when a retrospective starts

If you have a channel in which someone says retro start, everyone in that channel should be messaged privately with instructions on how to interact with Ken