Your First Workspace
This walkthrough takes you from a repository to a verified infrastructure change.
Create a workspace
From your enterprise dashboard, choose New Workspace. Select a repository from a connected GitHub, GitLab, Bitbucket, or Azure DevOps account. You can also create a new repository, start from a template, or create a local workspace when you need the legacy code editor.
Repository-backed workspaces can use Work, Architecture, compliance checks, and provider review requests. Ask an enterprise administrator to configure version control if no provider is available.
Start Work
Open the workspace, select the Work tab, and describe the result you want.
"Create a basic Terraform configuration for an AWS VPC with public and private subnets"
The agent reads the repository, any attached Context, and the rulesets available to the workspace. It works in an isolated checkout and saves useful checkpoints to a dedicated branch.
Try a few things
- Ask for changes like "Add a NAT gateway to the private subnet"
- Ask questions like "Explain what this security group does"
- Request reviews like "Review my main.tf for security best practices"
The conversation keeps its messages, plan, branch, and results, so you can iterate naturally.
What's happening behind the scenes
The agent follows your enterprise and workspace rulesets, connector policies, and model settings. After changing infrastructure code, Work verifies the saved commit and links the full compliance evaluation. When the result is ready, open a draft review request from the Work result.
Manage your files
Use the result diff to review changed files, then continue the conversation if you want another pass. Open Architecture when you want to inspect or edit the diagram on the same branch.
Next steps
- Enterprise Overview to configure governance for your organization
- Work for conversations, verification, sharing, and review requests
- Architecture for branch-aware diagrams and code synchronization
- Using the Agent for prompting and collaboration tips