botanicus/now-task-manager

View on GitHub
doc/workflow.md

Summary

Maintainability
Test Coverage
_This document is WIP._

## The workflow

_If you don't understand any term, read [terms](https://github.com/botanicus/now-task-manager/blob/master/doc/terms.md)_

![Workflow diagram](https://raw.githubusercontent.com/botanicus/now-task-manager/master/doc/diagram.png)

### Planning

In the evening you'll do `pomodoro edit tomorrow`. This will check your schedules and picks one to use. Schedule is a list of time frames, for instance for a work day we could have something like this:

```
Morning routine (from 7:50)
Work for client 1 (9:20 – 12:00)
Lunch break (12:00 – 13)
Work for client 2 (13 – 18)
```

Then it will try to prepopulate the schedule with tasks. There will be various sources:

- The scheduled lists.
- Automatically scheduled tasks.
- Unfinished tasks from today and postponed tasks.

## Doing

3. Next day you simply start getting through your list using `pomodoro next` and `pomodoro complete` (as well as `pomodoro postpone` and `pomodoro move_on`).

The tasks will be looked for in the current time frame. That is even if you have unfinished tasks, if a new time frame started, the tool will pick a task from the newly started one.

### Today tasks

![](https://raw.githubusercontent.com/botanicus/now-task-manager/master/doc/img/today-annotated.png)

- Tasks are stored in readable plain text format.
- Command-line interface.
- [Vim plugin](https://github.com/botanicus/now-task-manager/tree/master/support/vim).
- BitBar plugin.

### Scheduled tasks

Scheduled tasks are either scheduled for a certain **date** (tomorrow, next Friday etc), for a ceratin **context** (next time I'm in Prague etc) or just generally for **later**.

```
Tomorrow
- Buy milk.

Prague
- Pick up my shoes.

Later
- Fix the expense gem.
```

That's all there is to it. It's a simple text file and you can edit it to your liking.

The only shortcut you get is `pomodoro + Another task.` which will add a task to the list for later.

_**Read next**: [getting started](https://github.com/botanicus/now-task-manager/blob/master/doc/getting-started.md)_