Tabs and workspaces¶
This page explains the visible top-level product surfaces for end users. The Settings tab is intentionally left out. Use it when you want to understand what each main tab is for before you start clicking through the product. It is most useful for new users who can already sign in but do not yet know where to go next. A quick read usually takes three to five minutes.
Note
Some tabs are visible only for certain roles or feature configurations.
How to use this guide¶
Each guide page answers a different kind of question:
- Purpose and working model for core concepts and artifact roles
- Analyst flow, Planning flow, and Builder flow for recommended working sequence
- Page reference for page-by-page actions, page purpose, and pop-up modals
Top-level tabs¶
Projects¶
Use Projects to create a project, choose the project language, and set its access mode. From a project page you get the high-level system map:
- the Specification (What) side shows specifications, Epics, Use Cases, and Requirements
- when enabled, the Planning (Ready) card shows spec-scoped Plans, Scopes, Estimates, Risks, and Effort drivers
- the Implementation (How) side shows implementations, features, architecture, builds, delivery packages, Targets, and instruction sets
The project detail page is also where you open project-scoped lists of specifications, implementations, and Plans. In practice, this is often the first tab people open when they are orienting themselves in a new tenant or checking which project they should work in.
Specifications¶
Use Specifications to browse specification items across the accessible project scope. For most analyst work, open Workspace on a specification row first; it gives a guided preparation path before sending you into detailed Epics, Requirements, Use Cases, Test Cases, Ubiquitous Language, and Gap analysis tools. In the cross-project view, specifications are grouped by project and show their key and description to make selection easier. Search filters the accessible result set before paging, and Load more continues through additional matches.
Implementations¶
Use Implementations to browse or create implementation containers. From an implementation you manage features and, when enabled, build jobs. Builder-side work normally starts here unless you already entered through a project page. In the cross-project view, implementations are grouped by project and show their key, linked specification, and description when available. Search filters the accessible result set before paging, and Load more continues through additional matches.
Plans¶
Use Plans to browse planning containers. New Plans are scoped to a
Specification and contain one Planning Scope for each selected Epic. Each Scope
owns the AI-backed Assessments for that planned part and has its own detail
page for generation, review, overrides, and baseline acceptance. Plans are
available only when Planning is enabled and your role allows it. Assessments
run in the background and produce separate Full and Active Scope analyses plus
a canonical per-item effort split. Accepted Scope estimates and immutable
Minimum Baseline revisions expose freshness and explicit reconciliation. They
record the estimation profile version used and remain auditable when failed or
superseded. Follow the Planning flow when you need the
step-by-step path from specification scope to an accepted planning baseline and
optional effort allocation. Plans require CAP_PLANNING and are visible to
Admin and Planner roles.
AI Usage¶
Use AI Usage when you need a quick operational view of how AI is being used across the tenant. This is the place to answer practical questions such as: "Did usage spike today?", "Which feature or model caused it?", or "Have we already exhausted the included monthly budget?" You do not need any setup beyond access to the page, and a quick review usually takes one or two minutes.
From this tab you can:
- see estimated cost over time
- check input and output tokens together with estimated cost
- compare usage by feature and by model
- review tenant AI billing for the selected UTC billing month
- move between UTC billing months with previous, next, and current month controls
- see how included budget usage is tracking against the monthly budget
- check the remaining included budget or the additional amount charged for premium requests in the selected month
- review premium request count, premium charge, and billable spend
- download the monthly usage report with project key and project name columns
- see whether premium brokerage is already active or will only apply after the included budget is exhausted
- review recent AI events
This tab is for operational visibility, not artifact editing.
About¶
Use About to confirm the deployed version, edition, and active feature flags. This is useful when behavior differs between environments and you need to confirm whether you are looking at the same capabilities as another team or deployment.
Tenant¶
Use Tenant to see the active tenant context. For authorized users it also shows:
- tenant users
- current tenant roles, active or inactive status, and last active time for each listed user, with a user-name filter and Load more control when more than 20 users match
- for Manager users, a create-user flow with validation for username, email, first name, last name, temporary password, and assigned roles
- for Manager users, a deactivate action for active tenant users
- tenant format presets that define output standards for future AI generations; duplicate a preset to create another one and keep preset names within 16 characters; delete persists after confirmation unless a project still uses that preset
This tab is mainly administrative, so most end users visit it only when they need to manage users, format presets, or shared tenant-level configuration.
Profile¶
Use Profile to review your user details, language preference, current claims derived from your access token, and saved AI quick phrases. Saved phrases are grouped under Architecture workspace phrases by action and Architecture workspace tab, and under Specification workspace phrases by Requirements, Use cases, and Test cases. This is also where you mark phrases as favorites or delete them. It is a short page to review, but it becomes useful over time if you repeat the same AI prompts and want to reuse them instead of rewriting them.