O que é o AWR

O AWR é uma plataforma open source de entrega de projetos para pessoas e IA. Ele conecta objetivos, workstreams, dependências, contexto e aceitação em um único fluxo de trabalho de entrega, para que um projeto possa ir de um objetivo acordado até uma entrega verificada — mesmo quando o trabalho está dividido entre vários agentes, sessões e colaboradores.

O AWR foi criado para duas situações que compartilham o mesmo problema de base:

Uma pessoa coordenando vários agentes em um projeto complexo.
Uma equipe entregando um projeto compartilhado, começando por projetos de software complexos.

Nos dois casos, as pessoas definem a direção e revisam os resultados; os agentes fazem o trabalho. O AWR conecta o trabalho deles ao mesmo estado de projeto por meio da sua CLI e do seu serviço MCP.

O problema que o AWR resolve

Quando você trabalha com agentes de codificação de IA, o conhecimento do projeto normalmente fica na conversa privada do agente. Quando a sessão termina, o modelo muda ou outra pessoa ou agente assume o trabalho, esse contexto se perde. Esforços paralelos divergem, e "pronto" significa o que quer que o último agente tenha dito que significava.

O AWR foi desenhado em torno do que deveria ser verdade:

Trocar de sessão, modelo ou colaborador preserva o projeto. Objetivos, restrições e progresso verificado sobrevivem ao handoff. O sucessor recebe o contexto necessário da tarefa atual e o seu checkpoint, para que o projeto possa continuar entre sessões e agentes.
O trabalho paralelo tem responsabilidade e handoffs claros. Workstreams independentes (por exemplo frontend, backend e testes) mantêm suas próprias tarefas, contexto e responsabilidade, compartilhando as restrições do projeto.
"Pronto" é verificável. As declarações de conclusão se conectam a evidências vinculadas a uma versão. Implementação, verificação, merge e release são registrados como fatos separados, não fundidos em uma única declaração.
O esforço é visível. Em cada etapa você consegue dizer o que está pronto, o que está esperando, o que foi verificado e para onde foi o esforço.

Em resumo: o AWR preserva a continuidade do projeto entre janelas de contexto finitas. A janela de contexto de um agente é limitada, e a compactação (quando o host encurta a conversa para caber) é responsabilidade do host — os checkpoints do AWR carregam os fatos registrados do projeto para a frente.

Como funciona: seus arquivos continuam sendo a fonte da verdade

A arquitetura do AWR tem três partes:

Seus arquivos guardam a intenção. Arquivos Markdown e YAML no seu projeto descrevem objetivos, planos, trabalho, restrições e decisões. O AWR indexa essas fontes sem substituí-las silenciosamente.
O AWR mantém a continuidade. Um estado local (um projeto SQLite) guarda projeções dessas fontes, além de sessões, claims, checkpoints e evidências. A compilação de contexto — reunir os objetivos, regras, dependências e evidências relevantes para a tarefa atual — roda localmente e não faz chamadas a modelos. Verificações de revisão protegem as escritas contra estado desatualizado.
Pessoas e agentes fazem o trabalho. A CLI e o serviço MCP conectam os fatos do projeto ao host que você usar. Os agentes trazem seus próprios modelos, ferramentas e conversas; as mudanças revisadas e o progresso retornam às fontes do projeto.

Como os checkpoints registrados carregam apenas fatos registrados, eles não reconstroem o histórico de conversa não registrado de um agente — isso continua sendo responsabilidade do host.

As peças e como elas se encaixam

Você interage com o AWR por dois pontos de entrada, ambos instalados a partir do mesmo pacote:

A CLI awr — inicializa um projeto, inspeciona o status e conduz o fluxo explícito de sessões: fazer o claim de uma parte do trabalho, obter o seu contexto focado e salvar um checkpoint antes de parar. Qualquer agente capaz de executar comandos de shell pode usá-la.
O serviço MCP awr-mcp — expõe o mesmo estado de projeto como ferramentas MCP (MCP, o Model Context Protocol, é como clientes de IA chamam ferramentas externas). Um cliente se conecta a um único projeto via stdio ou a um serviço MCP HTTP compartilhado que atende vários clientes e projetos.

Sobre essas bases, o AWR dá suporte ao agente com o qual você já trabalha. As integrações vêm em camadas:

Contrato genérico (padrão, totalmente suportado). Qualquer host capaz de executar uma CLI ou falar MCP usa o mesmo estado de projeto por meio do fluxo de sessões compartilhado. Isso inclui Claude Code, Cursor, Windsurf e hosts semelhantes — nenhum instalador especial é necessário.
Notas por host. Para alguns hosts (Cursor, Kimi Code, Grok Build), o AWR documenta os caminhos exatos de mesclagem de configuração e as flags de sessão nativas, verificados contra uma versão datada do host. Essas notas não adicionam recursos de runtime.
Adaptador de ciclo de vida opcional. Onde os hooks nativos de ciclo de vida de um host são estáveis, um adaptador pode acionar checkpoints do AWR a partir de eventos do host. Hoje isso existe para o Codex. Um adaptador nunca transforma o AWR no runtime daquele host.

Para uma pessoa coordenando vários agentes, vale a mesma disciplina de dependências, revisão e prestação de contas de uma equipe maior — é um único modelo de projeto, não dois produtos.

O que o AWR NÃO é

O AWR tem escopo deliberado. É um runtime de trabalho agnóstico de host, e seu limite de produto é o contrato compartilhado de CLI/MCP — não um editor ou agente específico.

O AWR não é um agente de IA. Ele não seleciona, inicia nem configura um agente de codificação. Os agentes trazem seus próprios modelos, ferramentas e conversas; as strings de provedor e modelo armazenadas pelo AWR são apenas rótulos de exibição.
O AWR não é um editor, uma interface de chat nem um provedor de modelos. A interface do agente, os IDs de conversa nativos e a compactação pertencem ao host.
O AWR não substitui os arquivos do seu projeto. As fontes Markdown/YAML continuam sendo autoridade; o estado local do AWR é um índice mais registros de continuidade, e ele não deve substituir silenciosamente as suas fontes.
O AWR não está preso a um único transporte. Se o MCP roda via stdio, HTTP ou está ausente é uma escolha do host; se um host não tem hooks nativos, você faz checkpoints manualmente pela CLI.
O AWR não isola fisicamente os workstreams. O isolamento de workstreams cobre o estado do projeto e as operações suportadas; o isolamento físico de processos depende do host de execução.

Escopo atual: release publicado vs. desenvolvimento

O AWR é honesto sobre o que está entregue versus o que está sendo construído. Os pacotes CLI/MCP 0.5.1 publicados oferecem:

Objetivos e tarefas respaldados por fontes, com navegação de dependências
Compilação de contexto focado para a tarefa atual
Claims de sessão e checkpoints
Evidências vinculadas a versão
Um serviço MCP HTTP compartilhado para vários clientes e projetos
Troca de arquivos do Personal Workspace
Uma base de workstream pessoal: posse explícita de fontes, atribuição de sessão e contexto delimitado em um projeto SQLite local

Este release não oferece um serviço de Equipe autenticado nem isolamento completo entre clientes. Ainda em desenvolvimento na main:

Adoção versionada de entregas entre workstreams (vincular trabalho downstream a um artefato aceito e a uma versão de contrato; reverificar os consumidores quando isso mudar)
Colaboração em equipe e revisão de entregas (registros explícitos de revisor e aprovação)
Contabilização de uso, tempo e ETA por workstream

As notas de release de cada versão publicada definem o limite real do pacote.

O que isso significa para você

Se você está avaliando o AWR: você mantém o seu agente atual e os seus arquivos atuais. Você inicializa o AWR no seu projeto, dá ao seu agente um acordo de trabalho e, a partir daí, cada sessão começa a partir de objetivos, regras, dependências e checkpoints registrados, em vez de começar do zero. Você pode inspecionar o progresso a qualquer momento.

Se você está adotando em uma equipe: a mesma base de CLI/MCP se estende rumo à entrega e à revisão compartilhadas conforme essas capacidades forem lançadas — o release publicado já entrega o núcleo para um usuário e vários agentes.

Para onde ir a seguir

Quickstart — instale o AWR, conecte um projeto e rode sua primeira sessão.
Conceitos — o modelo de projeto em detalhe: objetivos, workstreams, sessões, claims, checkpoints e evidências.
CLI e serviço MCP — os dois pontos de entrada em profundidade.
Integrações com agentes — conecte o agente que você já usa.