/retro-ken

A slack bot for doing retrospectives with the team

Primary LanguageRuby

Retro Ken

Code Climate Issue Count Build Status


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

Example

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.