Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 16 additions & 0 deletions apps/docs/client/src/content/deco-studio/en/studio/task-board.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,15 @@ Every task card's activity feed supports threaded comments: post a comment, and

When a task is assigned to a **Super Agent**, it runs inside a sandbox that needs a checked-out repository to work in. If your organization has exactly one importable repository, the task run starts already checked out into it. If it has more than one, the run starts with an empty working directory and the Super Agent picks the right repository itself before reading files or running git — no manual repo selection step is required from you.

## Auto-fix

Any card in **Triage** or **To Do** that isn't already assigned to the Super Agent shows an **Auto-fix** button (lightning-bolt icon) — both on the card itself and inside the task dialog. Clicking it hands the task straight to the Super Agent, the same as assigning it manually from the assignee picker, and draws from the same auto-task quota (see [Billing and auto-task quota](#billing-and-auto-task-quota)).

<Callout type="tip">
Inside the task dialog, the **Save** button only appears once you've actually
changed something — Auto-fix and New chat don't need a dirty form to work.
</Callout>

## Automated review before shipping

Once a task's pull request is **In Review** (its checks are passing, or it has none), Studio can run automated reviewers on it before a human ships the change. Configure this under **Settings → Organization → Reviewers & merge**:
Expand All @@ -46,6 +55,13 @@ Each reviewer that runs shows up as its own session on the task card, and its ve
QA Agent and Code Reviewer are both off by default. Enable the ones you want
under **Settings → Organization → Reviewers & merge** — you can turn on
either one independently, or both.

**Exception:** the first time an organization switches to reports-only mode,
both reviewers default on automatically — reports-only orgs hide the agent
navigation the review flow would otherwise rely on, so the task-board PR
review needs them on to keep working. This only fires once, when
`reports_only` itself is first defaulted on, and never overrides a flag you
already set explicitly.
</Callout>

## Shipping to production
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,16 @@ O feed de atividade de todo card de task suporta comentários em thread: publiqu

Quando uma task é atribuída a um **Super Agent**, ele roda dentro de um sandbox que precisa de um repositório já clonado para trabalhar. Se sua organização tiver exatamente um repositório importável, a execução da task já começa com esse repositório clonado. Se houver mais de um, a execução começa com o diretório de trabalho vazio, e o próprio Super Agent escolhe o repositório correto antes de ler arquivos ou executar comandos git — nenhuma seleção manual de repositório é necessária.

## Auto-fix

Qualquer card em **Triage** ou **To Do** que ainda não esteja atribuído ao Super Agent mostra um botão **Auto-fix** (ícone de raio) — tanto no próprio card quanto dentro do diálogo da task. Clicar nele entrega a task diretamente ao Super Agent, do mesmo jeito que atribuí-la manualmente pelo seletor de responsável, e consome a mesma cota de auto-task (veja [Billing and auto-task quota](#billing-and-auto-task-quota)).

<Callout type="tip">
Dentro do diálogo da task, o botão **Save** só aparece depois que você
realmente muda algo — Auto-fix e New chat não precisam de um formulário
alterado para funcionar.
</Callout>

## Revisão automatizada antes de ir para produção

Quando o pull request de uma task fica **In Review** (seus checks estão passando, ou não há nenhum), o Studio pode executar revisores automatizados nele antes que um humano coloque a mudança em produção. Configure isso em **Settings → Organization → Reviewers & merge**:
Expand All @@ -47,6 +57,14 @@ Cada revisor que roda aparece como sua própria sessão no card da task, e o ver
QA Agent e Code Reviewer vêm desabilitados por padrão. Habilite os que você
quiser em **Settings → Organization → Reviewers & merge** — você pode ativar
um independentemente do outro, ou os dois.

**Exceção:** na primeira vez que uma organização passa para o modo
reports-only, os dois revisores são habilitados automaticamente — orgs
reports-only escondem a navegação de agents da qual o fluxo de revisão
dependeria, então a revisão de PR do task-board precisa deles ativos para
continuar funcionando. Isso só acontece uma vez, quando `reports_only` em
si é definido por padrão pela primeira vez, e nunca sobrescreve uma flag
que você já tenha definido explicitamente.
</Callout>

## Enviando para produção
Expand Down