Turn engineering goals into trackable issues and resolve open questions through discussions.
Availability: Business plans (Teams and Enterprise). Not yet available on individual plans.
Create a project
Describe the problem and expected outcome so teammates can connect their individual work to the project goal. You can start organizing issues before choosing a repository.
- Open Project in the main sidebar and choose New Project.
- Enter Project name. In Ambition, describe the work to complete and the expected outcome.
- Optionally choose a cover icon and color. Enter repository addresses under Repo URL and use Add repository for additional entries. Remove an entry with its remove button. You can also leave the list empty and add repositories later in project settings.
- Choose Create, then open the project from the project list.
Invite teammates
Send an invitation link to teammates responsible for requirements, development, or testing so they can join the project. New project members can currently join only through an invitation link; you cannot add arbitrary people directly from the organization directory.
- Open the project and choose Invite at the top right.
- If no link has been generated, choose Generate invitation link first. Copy the invitation link and send it to the people who should participate.
- Use the member list at the top of the project to view participants.
Organize work into issues
Split work where ownership or acceptance criteria differ. A design-review issue might deliver an agreed approach and failure cases; a regression-test issue delivers tests for those cases. Keeping them separate makes each result easier to hand over and review.
- Choose New Issue in the project, or use the creation control in a board column.
- Enter Issue title and add the goal, background, and acceptance criteria in the text area below the title.
- Choose a status from the menu showing the current status, such as Backlog, and set Priority as needed.
- Choose Create Issue. Enable Create another if you want to enter several issues in sequence.
- Open an issue from the board to edit its title, description, status, or priority. Add a comment to share progress; update the description when the background or goals change.
Collaborate and assign agents in an issue
Use comments, replies, and supported attachments in issue activity to share progress and reference material. To track work from a comment separately, open the comment's actions and create an issue draft from it. Use the comment and replies to prepare the draft, then review its title and description before creating the issue.
To add material from an existing task, select completed messages to share in the source conversation, or start sharing from an output fileâs menu. Choose Share to projects, select a project and Issues in it that you can comment on, add an optional note, and publish the comment. The material appears in the selected Issuesâ comments.
When an agent or Agent Team should handle the entire Issue, describe the goal, inputs, and acceptance criteria in the Issue body.
- Open the Issueâs agent assignment control and select an eligible agent or Agent Team. The project-member owner is set separately. If prompted to enable a collaboration scope or join the project, review and complete those steps, then confirm the assignment.
- Once the team claims the Issue, its lead delegates work to members and gathers their results. Follow the run in the Issue activity and open its execution record to inspect progress and the result.
- If a run needs human intervention, open the corresponding record to see what needs your attention. When the Issue allows reassignment, choose another eligible target from the assignment control. Review the combined result before updating the Issue status.
Discuss an issue
When reviewing the idempotency design requires input from backend and test teammates, start a discussion from that issue. Its title and description carry over, giving participants a specific question to investigate and resolve.
- Open the issue and choose Start discussion.
- Review the prefilled title and description, and explain the question to resolve.
- Optionally select existing project members or agents, then choose Create.
- Discuss the question, then record the decision back in the issue and update its progress.
Track project progress
Board status shows what is waiting, underway, or ready for review. Add findings and blockers to the issue as well, so teammates know what help or decision is needed next.
Open an issue and use its Status menu to update progress.
| Status | Suggested use |
|---|---|
| Backlog | The request is recorded but still needs planning or clarification |
| Todo | The goal and acceptance criteria are ready; work has not started |
| In progress | Work is underway |
| In review | A result is ready to check against the acceptance criteria |
| Done | The result has been checked and accepted |
| Cancelled | The item will no longer be pursued |