cybercog / telegram-devpoker-bot

Planning Poker (Scrum Poker) for Agile software development teams. The bot allows you to introduce a consensus-based, gamified technique of task estimating into Telegram group chats.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Telegram DevPoker Bot

Discord Releases License

Planning Poker (Scrum Poker) for Agile software development teams. The bot allows you to introduce a consensus-based, gamified technique of task estimating into Telegram group chats.

devpoker-hero-image

Usage

⚠️ Work in progress. Public bot may be offline until the first stable release.

Add @devpoker_bot to the group chat.

To start Planning Poker use /poker command. Add any description after the command to provide context.

Example:

/poker https://issue.tracker/TASK-123

Example with multiline description:

/poker https://issue.tracker/TASK-123
Design DevPoker bot keyboard layout

Only initiator can open cards or restart game at any moment.

Discussion phase

Discussion phase votes:

  • 👍 — Ready to estimate
  • ⁉️ — I have a questions or something to add
  • ✂️ — Split task into subtasks
  • ☠️️ — Cancel task (already done or not actual)
  • ♾️ — Impossible to estimate or task cannot be completed
  • ☕️ — I need a break

Estimation phase

Currently, there is only one sequence of numbers:

0.5, 1, 2, 3, 4, 5
6, 7, 8, 9, 10, 12
18, 24, 30, 36

Special cases:

  • ❓ — Unsure how to estimate (out of context, never solved such tasks)

Self-hosted usage

Bot works on Python 3.6.

Run run.sh script with bot api token to start the Docker container.

You need to obtain own bot token from https://t.me/BotFather, then run:

DEVPOKER_BOT_API_TOKEN=11111424242:some-token ./run.sh

This command will create image and container devpoker-bot.

Bot uses SQLite database at host in ~/.devpoker_bot/devpoker_bot.db.

Credits

This project is inspired by the tg-planning-poker.

License

About CyberCog

CyberCog is a Social Unity of enthusiasts. Research the best solutions in product & software development is our passion.

CyberCog

About

Planning Poker (Scrum Poker) for Agile software development teams. The bot allows you to introduce a consensus-based, gamified technique of task estimating into Telegram group chats.

License:MIT License


Languages

Language:Python 98.5%Language:Shell 1.0%Language:Dockerfile 0.5%