Platform
Team Usage
Ideal workflow for using Tusk as a team
Workflow for Engineers
- Product Manager (PM) creates a ticket in their ticketing software with a detailed description and assigns it to an engineer.
- The Actual and Expected Results or Given-When-Then formats are good ways to prompt Tusk.
- Engineer sees Tusk’s comment on the ticket which says that Tusk may be able to complete it.
- If more context is required, the engineer adds details to the ticket description as prompted by Tusk’s clarifying questions
- Engineer adds the
Tusk
label to the ticket. - After Tusk creates a PR, the engineer receives a GitHub / Jira / Linear / Notion notification.
- If Tusk self-determines that its changes aren’t satisfactory, it will instead create a branch and leave engineering advice on the ticket as a jumping-off point
- Engineer tests the PR on a preview environment.
- If the changes look right, the engineer approves the PR.
- If the PR is not entirely correct, they 1) request changes from Tusk via a PR review, or 2) checkout the branch to make changes manually
- If the PR is directionally wrong, they close the PR with a comment and un-assign themselves from the ticket. Tusk will learn from this for future tasks.
- Engineer merges PR after it is approved. If you have Jira, Linear, or Notion’s GitHub integration set up, this will change the ticket status to “Done” automatically. 🎉
Workflow for PMs
- PM creates a ticket in their ticketing software with a detailed description.
- The Actual and Expected Results or Given-When-Then formats are good ways to prompt Tusk.
- Tusk leaves a comment on the ticket saying that it may be able to complete it.
- If more context is required, PM adds details to the ticket description as prompted by Tusk’s clarifying questions
- PM adds the
Tusk
label to the ticket. - After Tusk creates a PR, the PM receives a GitHub / Jira / Linear / Notion notification.
- If Tusk self-determines that its changes aren’t satisfactory, it will instead create a branch and leave engineering advice on the ticket as a jumping-off point
- PM tests the PR on a preview environment.
- PM assigns the ticket to an engineer.
- If the changes look right, the engineer approves the PR.
- If the PR is not entirely correct, they 1) request changes from Tusk via a PR review, or 2) checkout the branch to make changes manually
- If the PR is directionally wrong, they close the PR with a comment and un-assign themselves from the ticket. Tusk will learn from this for future tasks.
- Engineer merges PR after it is approved. If you have Jira, Linear, or Notion’s GitHub integration set up, this will change the ticket status to “Done” automatically. 🎉