Skip to main content
Collaboration

Projects

Turn engineering goals into trackable issues and resolve open questions through discussions.

Availability: Business plans (Teams and Enterprise). Not yet available on individual plans.
Projects help you organize engineering work that involves several teammates, such as developing a feature, fixing defects, or updating a system. Break the work into issues, set priorities and statuses, and track progress on the board. Start a discussion from an issue when you need teammates and agents to review a proposal or help resolve a question. For example, a “Payment reliability” project could include separate issues for investigating duplicate charges, reviewing an idempotency design, and adding regression tests. Each owner can record progress in their issue and use the discussion conclusions to plan the next steps.

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.
  1. Open Projects in the main sidebar and choose New Project.
  2. Enter Project name. In Ambition, describe the work to complete and the expected outcome.
  3. Optionally choose a cover icon and color. To associate code with the project, enter a repository address in Repo URL. You can leave this field blank and add it later in Project settings.
  4. Choose Create, then open the project from the project list.
You can also create a project through an Agent using the option at the top right of the creation dialog.

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.
  1. Open the project and choose Invite at the top right.
  2. Choose Copy invitation link and send it to the people who should participate.
  3. 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.
  1. Choose New Issue in the project, or use the creation control in a board column.
  2. Enter Issue title and add the goal, background, and acceptance criteria in Description.
  3. Set Status and Priority as needed.
  4. Choose Create Issue. Enable Create another if you want to enter several issues in sequence.
  5. Open an issue from the board to edit its title, description, status, or priority. Update its description to record progress.
For example: 
Title: Review payment request idempotency
Goal: Agree on how to recognize and handle duplicate requests.
Context: Client retries can send the same payment request more than once.
Acceptance criteria: Record the design, failure cases, regression tests, and implementation owner.

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.
  1. Open the issue and choose Start discussion.
  2. Review the prefilled title and description, and explain the question to resolve.
  3. Optionally select existing project members or agents, then choose Create.
  4. Discuss the question, then record the decision back in the issue and update its progress.
See Discussions for invitations, replies, and key messages.

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.
StatusSuggested use
BacklogThe request is recorded but still needs planning or clarification
TodoThe goal and acceptance criteria are ready; work has not started
In progressWork is underway
In reviewA result is ready to check against the acceptance criteria
DoneThe result has been checked and accepted
CancelledThe item will no longer be pursued
On a busy board, use Search Issues to search by title or Add filter to filter by Priority. Enable Description preview under Card fields to see an issue’s context on the board. When a proposal is ready, implementation is complete, or a new blocker appears, record it in the issue description and update the status so teammates can see the latest progress.

Update project details

Open the project, click … to the right of the project name at the top of the page, and choose Project settings. You can update the name, description, icon, and color, or add or change the Repo URL. Choose Save settings.
Get Started
Features
Collaboration
Extensions
Configuration
Support