Skip to content

cybercog/telegram-devpoker-bot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

52 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

Packages

No packages published

Languages