# Projects

## Projects

A Project is the primary unit of planned work in DuploCloud. It brings together everything needed to take a goal from idea to completion — a spec, an implementation plan, and a series of tickets that the AI Engineer executes.

#### Structure of a Project

Every Project consists of three building blocks:

**Spec** — A detailed description of what needs to be accomplished. The spec is drafted collaboratively with the AI Engineer and approved before any implementation begins. It captures requirements across areas such as infrastructure, CI/CD, workloads, observability, compliance, security, and cost.

**Plan** — A step-by-step implementation plan derived from the approved spec. The plan is broken down into discrete tasks, organized into stages, and approved before execution starts.

**Tickets** — The individual units of work that the AI Engineer executes. Each ticket corresponds to a task in the plan and tracks everything that happens during execution — commands run, decisions made, context carried forward.

#### Stages and Parallel Execution

Tasks in a plan are grouped into stages. Each stage contains tickets that are independent of one another — they have no dependencies on other tickets within the same stage, which means all tickets in a stage can be executed in parallel. Stages are completed in sequence: the next stage begins once all tickets in the current stage are done.

This structure gives you both predictability (stages enforce order where it matters) and speed (parallelism within each stage).

#### Scope

Projects can optionally define their own Scope as a subset of the assigned Engineer's Scope. If no custom Scope is set, the Project defaults to the Engineer's full Scope — controlling exactly which cloud environments, clusters, and resources the AI Engineer can access when executing work for that Project.

#### Creating a Project

Projects are created from the DuploCloud platform UI. Once a project exists, you can take all subsequent actions — drafting the spec, writing the plan, and executing tickets — directly from your IDE or terminal using the DuploCloud plugin.

## Projects Tutorial

Projects in AI DevOps help you organize multi-stage engineering work. Each project contains an AI-generated specification, a phased plan, and a set of executable tasks — all managed through an AI Planner conversation and tracked across an Execution view.

***

### Step 1 — Navigate to Projects

In the left sidebar, click **Projects** under the **AI DevOps** section.

![Projects list](https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2F1cdgh8xYhlXfmEmq22dC%2Fprojects-step-01-projects-list.png?alt=media\&token=efa04478-ff11-43e9-ae69-448ddf576b8a)

The Projects page displays all existing projects in a table. Each row shows the project's name, description, priority, progress percentage, accumulated cost, assigned scopes, start date, creator, and last modified date.

![Projects table columns](https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2F2G9Sr4AQOXHXrZriRk6o%2Fprojects-step-03-table-columns.png?alt=media\&token=e3bdd395-1ab1-43e0-a9c6-309cede58832)

***

### Step 2 — Create a Project

Click the **Add** button in the top right corner of the table.

![Add button](https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2FKTd45u4s1NYM2Q5xNZQP%2Fprojects-step-04-add-button.png?alt=media\&token=af6cc6b0-1af6-4af7-9c06-4d3ef1dfde7d)

The **Add Project** panel slides open.

![Add Project form](https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2FHRLEZDBGAWyL99B7bOQy%2Fprojects-step-05-add-form-overview.png?alt=media\&token=eff24129-3ef0-4628-b3d2-c79118c15e29)

Fill in the project details:

**Name** — give the project a clear, descriptive name.

![Name field](https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2FN9Tkj341FJ3kXNLthHev%2Fprojects-step-06-form-name.png?alt=media\&token=a7b7165f-20ca-438e-8c0b-536d0fba0e4e)

**Description** *(optional)* — briefly describe the project goal.

![Description field](https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2F11B0hU26EZe3j0KBEdrJ%2Fprojects-step-07-form-description.png?alt=media\&token=5ac8f2a6-0e69-48f2-a5a6-a36d97582188)

**Scopes** — select one or more scopes to grant the AI agents the cloud access they need.

![Scopes field](https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2FP8yaFYJlwFTHJJ4bxiSj%2Fprojects-step-08-form-scopes.png?alt=media\&token=28e8fd16-1e80-432b-9c1c-1ab7461dd6aa)

**Priority** *(optional)* — set a priority level: Low, Medium, High, or Critical.

![Priority field](https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2FW5csDfLsuXR6i5BRUYIP%2Fprojects-step-09-form-priority.png?alt=media\&token=e590e72f-b912-4156-8a31-d3346ca1fe7c)

**Start Date / End Date** *(optional)* — set the intended project timeline.

![Date fields](https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2FJ2LAGJj6EW2HiBV0I5w8%2Fprojects-step-10-form-dates.png?alt=media\&token=508a74fe-9b64-40df-93b8-dc5ce0f4fffd)

> **AI-Powered Workflow** — after creating the project, you can use the AI Planner to generate a specification, a phased plan, and a full set of actionable execution tasks through a conversation with the AI.

![AI workflow callout](https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2Fvj70L93Ou20v4njEbMcR%2Fprojects-step-11-ai-workflow.png?alt=media\&token=5409ef61-6bbd-42b3-8b38-43e6144f870f)

When ready, click **Create**.

![Create button](https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2F9Q93m7AvUJlIYyVhOLAM%2Fprojects-step-12-form-create-button.png?alt=media\&token=21646835-883a-4dc2-b29f-7fa168c8ad15)

The new project appears in the list. You can now open it to begin the AI planning workflow.

***

### Step 3 — Open a Project

Click a project name in the list to open it.

![Project in list](https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2FaUAAisQ97Balw9Aiw87t%2Fprojects-step-13-project-in-list.png?alt=media\&token=627a8db8-de6e-4ec4-8b8b-d0fec27027bc)

The project detail page opens. It has two tabs — **Project Overview** and **Execution** — along with an **Open AI Planner** button and a right sidebar showing project metadata.

![Project detail overview](https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2F0c4QXhoeJwZU5wn3Q2c8%2Fprojects-step-14-project-detail-overview.png?alt=media\&token=2d727590-8c19-4d04-8a32-80e30f6dbc39)

The **Project Overview** tab shows the full task board across all phases.

![Project Overview tab](https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2FVZVvzFOQ24661R8PFH55%2Fprojects-step-15-project-overview-tab.png?alt=media\&token=2850cad5-5778-49b1-af5d-dc7cc4a2807d)

The **Execution** tab shows the same phases and tasks, filterable by status: All, Open, In Progress, or Closed.

![Execution tab](https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2FKnyhqIfCSYdoPEQjI0Nz%2Fprojects-step-16-execution-tab.png?alt=media\&token=2afe3bd2-d59d-4e1c-9c7c-ed30b68f7e31)

Use **Generate Summary** to get a plain-language status update from the AI across all tasks.

![Generate Summary](https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2FBZ43LZQNES6BT1iogdoo%2Fprojects-step-17-generate-summary.png?alt=media\&token=2fabb036-4606-4c17-9574-9def627d1440)

The right sidebar shows metadata (scopes, total cost, priority, dates) and links to the project's **Specs**, **Plan**, and **Execution** artifacts.

![Specs section in sidebar](https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2FETR7kj9qdcc8BFvvI3bF%2Fprojects-step-19-specs-section.png?alt=media\&token=75d085ab-0460-44aa-9645-d70a1502d069)

***

### Step 4 — Open the AI Planner

Click **Open AI Planner** to launch the AI planning conversation for the project.

![Open AI Planner button](https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2F5F4IDVCBRmbJGfLGuUpM%2Fprojects-step-18-open-ai-planner-btn.png?alt=media\&token=85340e3b-e357-4912-b915-7a5ea4fd2d1b)

The AI Planner opens as a conversation interface. During initial setup, the AI ran discovery against your environment and generated a specification, a phased plan, and an execution task set. All three are accessible as artifact blocks in the conversation.

![AI Planner overview](https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2FQXcXwCknQG4XT5VqwXrF%2Fprojects-step-22-ai-planner-overview.png?alt=media\&token=074223de-b495-431b-bb10-b5c53ef04fbd)

***

### Step 5 — Review and Save the Spec

Scroll up in the AI Planner conversation to find the **spec.md** artifact block — the project specification the AI generated from your initial prompt.

![spec.md artifact in chat](https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2FJI7tN7JTtfMKGb9nJO9B%2Fprojects-step-24-spec-artifact.png?alt=media\&token=7f254ce5-4b0c-4a92-ad89-7756d1fd1457)

Click the **spec.md** block to open the specification. The spec documents your environment's current state, goals, and constraints that the plan and tasks are built against.

![Spec view](https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2FySMCKkdkmNvVQ3T4Tt3M%2Fprojects-step-25-spec-view.png?alt=media\&token=64601bd6-f0b9-4d2d-a2c8-5bcc1d6b46dd)

Click **Save Spec** to persist this version of the specification to the project.

![Save Spec](https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2FFSce0FVpZwcDY3qr9vYI%2Fprojects-step-25b-save-spec.png?alt=media\&token=a81e5de9-16f2-4b52-80c7-1d79ec7a2912)

***

### Step 6 — Review and Save the Plan

Navigate back to the AI Planner and click the **plan.md** artifact block to view the phased plan.

![plan.md artifact in chat](https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2FvI5vY1E2diPMd25vglbx%2Fprojects-step-26-plan-artifact.png?alt=media\&token=724c7faf-4554-4a55-b451-46da65e41e36)

The plan breaks the project into named phases, each with specific tasks, acceptance criteria, and an implementation approach.

![Plan view](https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2FSJW5ikhBXuShqB88Uq9D%2Fprojects-step-27-plan-view.png?alt=media\&token=230cc807-3214-4121-8df3-6541a25ac799)

Click **Save Plan** to save it to the project.

![Save Plan](https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2FtkvLurXxYHf0SAEmt4LA%2Fprojects-step-27b-save-plan.png?alt=media\&token=55eb95f4-2975-4dae-ae00-502607c06e6d)

***

### Step 7 — Review and Save the Execution Tasks

Navigate back to the AI Planner and click the **execution\_tasks.json** artifact block to view the full execution task set.

![Execution tasks artifact in chat](https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2FjMEewLjqi1jE8mcIFCGb%2Fprojects-step-28-execution-artifact.png?alt=media\&token=ea0d1212-8212-4d01-a62a-fded48892c47)

The execution tasks view shows all phases and their tasks in structured form. Each task includes a title, description, acceptance criteria, and phase assignment.

![Execution tasks view](https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2FawwrFtZVaDeszdBL8gBb%2Fprojects-step-29-execution-view.png?alt=media\&token=97505a2d-5c4e-4a33-940e-bd8b92eb7a72)

Click **Save Execution Tasks** to write these tasks to the project. Saving populates the Execution tab with the complete task breakdown, organised by phase.

![Save Execution Tasks](https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2FkjUaqTyIyNjEZzURWr02%2Fprojects-step-29b-save-execution.png?alt=media\&token=066d9ddd-76ed-4cbc-a1a9-038f9ad8f3bd)

***

### Step 8 — Track Execution

Navigate back to the project and click the **Execution** tab to see all tasks organised by phase.

![Execution tab active](https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2FTYIsl31S4apAUQWYGRIj%2Fprojects-step-31-execution-tab-active.png?alt=media\&token=1e1944ec-dec3-4c16-9fb0-78022f779d7c)

Each phase lists its tasks with their current status. The phase header shows the task count and a short summary of that phase's goal.

![Execution full view](https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2Fbcz3LhQRXiVlbWGkDqL1%2Fprojects-step-32-execution-full.png?alt=media\&token=c4ce345f-ec7e-4c08-a0e5-b352d470c603)

The phases progress sequentially — earlier phases typically cover observability or baseline work that must complete before later phases begin.

![Phase 1](https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2Fb6zXXHg0UrzFboMaAJbh%2Fprojects-step-33-phase1.png?alt=media\&token=f708062a-60c4-4de1-a102-4340da1e887a)

Tasks that have been linked to AI tickets show the ticket ID next to the task name.

![Task with ticket ID](https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2FOmIhQKpVh4WEUy1HLyCm%2Fprojects-step-34-task1-in-list.png?alt=media\&token=df2a81e3-300f-4fbb-bc11-160f01a465ad)

***

### Step 9 — Open a Task Ticket

Click a task's ticket ID to open the AI conversation that executed that task.

![Task ticket overview](https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2F810yFSzBeNdHBPXsS9yI%2Fprojects-step-35-task1-overview.png?alt=media\&token=78996524-02a5-4e7f-8263-31e429fa945d)

The ticket shows the full AI agent conversation for the task — including tool calls made, command output returned, and the agent's step-by-step reasoning. The right sidebar shows ticket metadata: status, scopes, skills, priority, total cost, and the ticket ID.

![Ticket ID in sidebar](https://2471407984-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F68cb0s9ce5UIUKWPuYs8%2Fuploads%2FIhMWOJ9XJhqCOfAtMo4p%2Fprojects-step-36-ticket-id.png?alt=media\&token=abdef4fd-85bf-4dbe-93fe-d4dfa1098080)

Each task ticket is a self-contained record of exactly what the AI did to complete that unit of work, making it auditable and resumable.