How the parts connect
Every way in lands in the same Context, so one piece of work can lean on another: what a Task finds is there for the next one, a Task can set a Duty, a Duty gives a Task, and an Application records what a Task did. The model above plays this story. Here it is step by step, numbered as it is there.
-
A question in Slack
What a Task finds is kept as project knowledge, with where it came from, so the next piece of work starts from it instead of from scratch.
- Team chat Mira in #fares: @Jigward why are night fares doubled?
- Tasks A Task starts from the thread
- Repositories Reads the fare job in orbit-cab-api
- Tasks Searches CloudWatch Logs for night rides
- An answer or investigation The midnight job applies the night rate twice. Answered in the thread.
- Project knowledge Remembers the cause, with the log lines
-
An issue assigned on Jira
The Task recalls the cause found in Slack before it touches the code, and sets a Duty when asked, so the check keeps running after the fix is merged.
- Issue tracker ORB-218 on Jira: Apply the night rate once, and check it every morning.
- Tasks A Task starts from ORB-218
- Project knowledge Recalls the cause found in #fares
- Repositories Fixes the job in a workspace and runs the tests
- A draft pull request Draft pull request #142, linked on ORB-218.
- Duties Sets a Duty: check night fares, weekdays at 07:00
-
A pull request to review
A review weighs the change against the schema, the API and what earlier work settled, and leaves the approval to the people who own it.
- Code review Pull request #139 by Leo: Review requested from Jigward.
- Tasks A Task starts from the pull request
- Repositories Compares the change with the schema and the API
- Project knowledge Recalls: the night rate applies once
- An answer or investigation A comment on #139: the new discount also runs at midnight.
-
An Application from a Chat
A Chat reads the Context’s own Tasks and builds an Application on them: a page and the data it keeps, shared with the team.
- Jigward app Mira in a Chat: Make a board of the night fare checks.
- Chat Reads the Tasks that checked fares
- Applications Builds the board and the data it keeps
- An internal tool The night fare board is ready for the team.
-
The Duty wakes
The Duty set on Jira wakes on time and gives a Task. When that Task finishes, the board built in the Chat records its result.
- Scheduled work Duty, weekdays at 07:00: Check the night fares on staging.
- Duties Wakes and gives a Task
- Tasks Books a night ride on staging in a browser
- Browser check results The night fare is right. Recording and logs attached.
- Applications The night fare board adds this check
The story is set at Orbit Cab, a made-up cosmo-taxi company. It describes what Jigward does; it is not a recording of a real Task.