What is this I don't even
This is a scrum (or "scrum-but") tool for monitoring your sprint progress in Pivotal Tracker. By default it doesn't tell you anything that Pivotal Tracker can't: it uses your project's velocity to estimate how many points can still be completed in the current iteration. But if you give it a particular person's initials, it will try to do the same estimation for that particular person.
Of course this requires some extra assumptions. It won't do any good unless the stories in current already have owners. (This is "scrum-but": in our small team we each have our area of expertise and stories are assigned accordingly.) You will also need to give some more refined productivity estimates than the velocity calculated by Pivotal (how many feature points per day an individual team member expects to complete, and how much extra to budget for chores and bugs).
You'll need a unix-style environment (linux, terminal in a mac, or similar),
hg installed (and
virtualenv if you follow my
Installing (if you know enough to do this differently you don't need my advice):
$ hg clone https://email@example.com/tikitu/pivotal_slippage $ cd pivotal_slippage $ virtualenv --no-site-packages . $ bin/pip install zc.buildout $ bin/buildout
Run the script from the commandline:
$ bin/slippage --help $ bin/slippage --describe-format $ bin/slippage --token <pivotal-api-token> --project <project-id> $ bin/slippage --token <pivotal-api-token> --project <project-id> --users <initials>
The only absolutely necessary configuration is an API token for Pivotal Tracker and the ID of your project. You can give both on the commandline, or put them in a config file (see below) for convenience. The project ID can be found in the URL you use to access Pivotal Tracker; your API token is at the bottom of your "Profile" page in Pivotal Tracker.
--users can be specified in a config
file, which must be located at
The same file can contain individual estimates (per-programmer) for how many feature points should be completed per day (default 3), how many points a bug or chore should count as for estimation purposes (default 1) and how many total points (features plus extras) should be completed per day (default 4).
The format of the config file is (where each line or block is optional):
[defaults] token: <api-token> project: <project-id> users: <initials> <more-initials> <more-initials> [points] feature_per_day: <float> total_per_day: <float> bugs_chores: <float>
Here is some example output:
bin/slippage --describe-format to get a complete explanation of what it
all means (including the pretty colours).