Guide
Ship every PR with confidence
Follow this tutorial to connect Asana and GitHub, run AI-assisted reviews, and share AI time estimates.
Setup
Get your workspace ready
Start here to configure access, invite your team, and map projects to repositories.
Create your workspace
Sign up or log in, then create a dedicated workspace to keep your teams, repos, and projects organized.
Invite collaborators
Add teammates so they can connect their accounts, share mappings, and receive review updates together.
Align projects and repos
Map Asana projects to GitHub repositories so new PRs can auto-match to the right task first.
Tutorial
Run an end-to-end review
Use this flow to connect integrations, launch a review, and share outcomes.
1) Connect GitHub and Asana
TipLink both integrations from the Connections page. The app will pull project metadata and repo permissions to keep reviews scoped to your work.
Use service accounts for shared repos to keep notifications reliable across rotations.
2) Open or paste a PR link
TipOpen a PR with an Asana task URL or ID in the title or branch, or add the PR link to the task. We ingest the diff, labels, and attachments to prep the review.
Low-confidence matches wait for a PR link on the task, so add it early to keep the review moving.
3) Enable AI time estimation
TipToggle AI time estimation in Connections. Once a task has a description, assignee, and repo context, we post an effort range to the task.
If the repo is not linked, reply with owner/repo to unblock the estimate.
4) Run the AI review
TipStart the review to generate severity-tagged findings, cross-check requirements, and add contextual code pointers.
Use the retry option after pushing new commits; we keep the history so you can compare deltas.
5) Share results
TipSync outcomes back to GitHub comments, Asana task updates, or both. Owners receive links to findings and suggestions.
Enable dual-delivery when multiple teams own the same PR to reduce handoffs.
Working style
Best practices
Keep reviews focused, reproducible, and actionable for every collaborator.
Keep specs close to code
Attach mockups and checklists to Asana tasks so review prompts stay grounded in the expected UX and acceptance criteria.
Assign tasks early
AI time estimates only run once tasks have a description and assignee, so set both as soon as work begins.
Label PRs by intent
Use feature, bugfix, or chore labels so the reviewer adjusts rigor and skips irrelevant checks.
Keep task IDs visible
Include the Asana task ID or URL in PR titles or branch names to maximize auto-matching accuracy.
Monitor findings over time
Track recurring issues in the dashboard to spot areas that need linters, tests, or playbook updates.
Troubleshooting
Unblock common issues
Use these quick fixes when integrations or reviews are not behaving as expected.
Missing repositories
Re-authenticate GitHub from Connections and confirm the repo is granted in the installation settings.
Asana tasks not appearing
Refresh your workspace sync and verify you have access to the project in Asana with the same account.
Reviews feel stale
Trigger a re-run after pushing commits and include updated screenshots to tighten UI verification.
PR was not auto-matched
Add the PR link to the Asana task or open the Connections page to confirm or override the match.
Time estimate missing
Confirm the task has a description and assignee, and reply with the GitHub repo if it is not linked.