# Projetos

Leve fatos, decisões e notas de passagem de contexto do projeto entre clientes autorizados sem copiá-los entre conversas.

- Canonical: https://docs.xmemo.dev/pt-br/docs/concepts/projects
- Locale: pt-BR
- Content-Locale: pt-BR
- Canonical-Content-Digest: e82c162591e96921f73cb208323c4238c42240cf414ab2fbfcb253a4c872a206
- Edition-Digest: 80cb96f4f37423b4b57c6bcdbd4959360fd153c6c98f2e0b7ccd49c80b5b0dfd
- Source-Revision: sha256:d8d00f958675bca9a3263744deaa85017c659638f29847b5dc3b83ba37f78fc5

## Espaços de trabalho de projeto no Memory Console

Os Project Workspaces fornecem limites contextuais estruturados para agrupar memórias, rastrear decisões operacionais e gerenciar tarefas ativas entre sessões de clientes. No Memory Console em https://xmemo.dev/me#projects, a seção de navegação de espaços de trabalho hospeda o painel Projects, projetado para "Browse project workspaces, context, and project memories."

- Métricas de espaço de trabalho: O console exibe estatísticas de nível superior em todos os seus espaços de trabalho, incluindo Total Projects, Active, Attention Needed e Archived.
- Provisionamento de espaço de trabalho: Selecionar Create New Project abre um modal guiado exigindo um Project Name ("Required, 1-128 characters."). A interface renderiza uma prévia em tempo real do identificador de projeto ("Non-authoritative preview. The backend server assigns the authoritative project key.") e aceita uma Description opcional de até 2000 caracteres.
- Limite pessoal: Os projetos são apenas pessoais hoje. O serviço de backend rejeita a criação de espaços de trabalho com team_id (HTTP 400). A documentação não faz promessas de projetos para equipes.
- Sem limites numéricos: Os espaços de trabalho de projeto não possuem cotas de plano numéricas nem limites artificiais de criação. As contas provisionam espaços de trabalho com base nas necessidades do fluxo de trabalho, e não em cotas de plano.

## Associações de memória, estados de ciclo de vida e remoção não destrutiva

As memórias são atribuídas a um projeto para fornecer contexto delimitado para agentes conectados e revisão do painel. A visualização de detalhes do projeto agrega métricas de integridade do projeto e fornece inspeção granular dos registros vinculados:

- Estatísticas principais do projeto: A barra de destaque de cada espaço de trabalho exibe agregados em tempo real para Memories:, Open TODOs: e Decisions:.
- Filtragem por ciclo de vida da memória: O explorador de memória categoriza registros por status de ciclo de vida: Active, Superseded, Expired e Archived.
- Desassociação não destrutiva: Remover um registro de memória de um espaço de trabalho de projeto desvincula a associação sem destruir a memória subjacente. A caixa de diálogo de confirmação afirma: "This memory will be disassociated from this project workspace. The memory content remains in your personal memory archive, but will no longer appear in this project context."
- Isolamento diagnóstico: Itens com referências canônicas ausentes ou conflitos de namespace são colocados em quarentena sob Diagnostic Isolated Items com o selo Unindexed - Troubleshooting Only, evitando que contexto corrompido vaze para o recall do agente.

## Partições de Knowledge vs Working e exibição Attention Needed

Os espaços de trabalho de projeto suportam particionamento contextual de memória se habilitado para sua conta (o modo de avaliação de convergência fica desativado por padrão):

- Partição Knowledge: Mantém fatos de referência duradouros, decisões arquitetônicas de longo prazo e convenções de projeto destinadas a recall persistente.
- Partição de Working memory: Contém estado de tarefa transitório, sessões de trabalho em andamento e contexto de rascunho que podem ser descartados após a conclusão de marcos.
- Visualização Attention Needed: Destaca candidatos não atribuídos, duplicatas suspeitas ou registros com atribuição pendente quando a curadoria particionada estiver ativa para sua conta.
- Distinção das Knowledge Bases: Uma partição Knowledge de projeto categoriza a memória conversacional episódica dentro do limite de um projeto. Em contraste, uma Knowledge Base fornece documentos de referência com curadoria e múltiplas revisões gerenciados por meio de armazenamento independente. Para obter documentação com curadoria, consulte o guia de conceitos das Knowledge Bases em /docs/concepts/knowledge-bases.

## Um projeto é um escopo mais uma convenção de caminhos

Para a delimitação básica da memória, o XMemo não requer um objeto de projeto separado: um projeto é expresso pelo escopo sob o qual uma memória é gravada e pelo namespace do caminho lógico dentro dele, de modo que a mesma conta pode comportar muitos projetos sem contaminação mútua. Sobre esse limite de memória, o Project Workspaces adiciona um estado estruturado do projeto (API do projeto, rastreamento de TODO e decisões registradas) para colaboração entre clientes.

- Escreva fatos do projeto em um caminho estável como projects/<name>/decisions.
- Transmita o escopo do projeto tanto na gravação quanto na leitura para manter a recuperação delimitada.
- O Project Workspaces adiciona uma camada de estado estruturado de projeto — incluindo APIs de projeto, TODOs duradouros e decisões registradas — sobre o limite de memória subjacente.
- Os projetos permanecem exclusivamente pessoais atualmente; espaços de trabalho de projeto no escopo de equipe são rejeitados pela API.

## Grave uma decisão do projeto

Vincule o registro ao caminho e ao escopo do projeto no momento da gravação; nada mais precisa ser configurado antes.

```ts
await client.recordDecision(
  "Remote agents should use network MCP, not SSH stdio",
  { source: "codex", scope: "memory-os" },
);
```

## Continue um projeto em outro cliente

Um segundo cliente recupera o mesmo escopo e obtém o contexto do projeto de volta sem que o usuário precise explicá-lo novamente.

```ts
const context = await client.recallContext("recent agent integration progress", {
  scope: "memory-os",
  maxItems: 6,
  maxTokens: 1200,
});
```

## Ferramentas de agente e acesso a perfis de cliente

Agentes autorizados interagem com projetos por meio de ferramentas definidas em config/mcp-documentation-contract.json em perfis de cliente específicos:

- chatgpt-public, generic-public e public-only: Expõem project, get_project_summary e open_project_workspace.
- claude-plugin: Expõe project e get_project_context.
- cursor-plugin e ordinary-full: Expõem get_project_context, update_project_todo e update_project_decision.
- Diferença do widget dentro do chat: O widget do ChatGPT Project Workspace aberto via open_project_workspace é uma interface de cartão interativa dentro do chat; ele é distinto do Memory Console completo baseado na web em https://xmemo.dev/me#projects.

## Usuário do ChatGPT

Dê ao ChatGPT acesso duradouro às suas preferências do XMemo, fatos do projeto, decisões e TODOs sem colar tokens bearer no chat.

Conecte o servidor MCP hospedado do XMemo pelo fluxo OAuth do app ChatGPT/OpenAI e aprove a concessão memory:read e memory:write para sua conta do XMemo.

Salve uma preferência de teste ou anotação de projeto, inicie um novo chat e peça ao ChatGPT para recuperá-la via XMemo antes de prosseguir.

Se o OAuth falhar ou as ferramentas não aparecerem, saia do servidor MCP no app host, reconecte a URL do servidor XMemo e tente novamente antes de criar tokens diretos.

## Desenvolvedor Copilot / Codex

Transfira decisões do repositório, convenções de código, notas de correção de bugs e histórico de tarefas entre agentes de IDE e CLI.

Use OAuth para VS Code / GitHub Copilot e Gemini CLI quando disponível. Para Copilot CLI, Codex, Cursor ou outros clientes MCP diretos, mantenha XMEMO_KEY no ambiente local ou cofre de segredos e defina um XMEMO_AGENT_INSTANCE_ID estável.

Registre uma decisão da base de código ou correção de bug e peça ao próximo agente de IDE ou CLI para recuperar o contexto relevante do XMemo antes de editar.

Se as recuperações estiverem vazias, verifique o caminho da configuração MCP selecionada, a variável de ambiente XMEMO_KEY para clientes diretos e eventuais credenciais OAuth desatualizadas no app host.

## Líder de piloto de equipe / corporativo

Avalie a memória compartilhada com controles de conta, atribuição de origem, fluxos de exportação/exclusão e evidências de configuração seguras para revisores.

Crie ou acesse o espaço de trabalho protegido do XMemo, convide usuários aprovados e conecte cada cliente via OAuth ou credencial direta com escopo de acordo com os selos de disponibilidade.

Peça para um membro do piloto salvar uma memória de equipe de teste, confirme a atribuição de origem no XMemo e revise os caminhos de exclusão/exportação e suporte.

Se um membro não conseguir se conectar, verifique as permissões de função, aprovação OAuth, status de prontidão do cliente e orientações de suporte antes de emitir um novo token.

## Operador de agentes autônomos

Permita que agentes headless ou agendados registrem progresso, recuperem decisões anteriores e mantenham uma identidade estável e não secreta de instância.

Obtenha /api/v1/mcp/config/autonomous-agent. Prefira auth_modes.oauth quando o executor suportar OAuth + cabeçalhos personalizados; use auth_modes.xmemo_key com XMEMO_KEY de um cofre de segredos apenas para executores totalmente headless.

Execute uma tarefa de teste que grave progresso no XMemo, reinicie o executor e confirme se ele recupera esse progresso usando o mesmo XMEMO_AGENT_INSTANCE_ID.

Se a atribuição mudar ou as recuperações se dividirem entre instâncias, persista XMEMO_AGENT_INSTANCE_ID fora do git e verifique se o executor não o está gerando a cada início.