ChenJinCloud/codex-closeout-archive

Codex Closeout Archive

Use esta habilidade quando o usuário solicitar explicitamente fechar, arquivar, encerrar, colher ou preservar uma conversa do Codex. Ela transforma a conversa em um ativo de processo leve e, em seguida, arquiva a conversa.

A solicitação explícita de encerramento do usuário é a decisão de transformar em ativo. Não reabra o debate sobre se o tópico merece preservação depois que esta habilidade for invocada; todo encerramento cria um ativo de processo conciso.

Por Que Esta Habilidade Existe

As threads do Codex frequentemente contêm o trabalho real: mudanças de intenção, correções do usuário, caminhos de evidência, alterações em arquivos, verificações em fontes externas e decisões finais. Se a thread for apenas arquivada no aplicativo, a próxima conversa pode perder o motivo pelo qual as decisões mudaram.

Esta habilidade preserva o rastro reutilizável sem copiar a transcrição completa. Ela protege:

• Rastreabilidade: Trabalhos futuros podem encontrar a sessão, arquivos e evidências originais.
• Continuidade de decisões: Principais turnos e correções sobrevivem entre threads.
• Encerramento de baixo atrito: Cada final produz um artefato útil, não um sistema de arquivamento grande.

Não use esta habilidade apenas porque uma conversa ficou silenciosa ou porque um agente deseja um fechamento organizado. Use-a quando fechar, arquivar, colher ou preservar for o próximo estado solicitado pelo usuário.

Inegociáveis

• Crie um ativo de processo toda vez que esta habilidade for usada.
• Use a pasta do projeto relacionado por padrão.
• Mantenha a linha do tempo concisa: geralmente de 5 a 12 turnos principais.
• Preserve os principais turnos, correções do usuário, decisões, arquivos de saída e caminhos de evidência.
• Não cole uma transcrição bruta completa, conteúdo completo de Slack ou DM, credenciais ou exportações confidenciais no ativo.
• Não exclua, mova ou reescreva os arquivos originais da sessão do Codex.
• Após o ativo ser escrito e verificado, arquive a conversa atual, a menos que o usuário peça para preparar o ativo sem encerrar a thread.

Fluxo de Trabalho

1. Resolver o Destino

Escolha a menor pasta existente que representa o projeto atual.

Prefira, nesta ordem:

1. Uma pasta de projeto explicitamente nomeada pelo usuário.
2. A raiz do repositório ou espaço de trabalho se a thread for específica do repositório.
3. Uma pasta de projeto, área ou operações duráveis exigida pelo AGENTS.md local, instruções do espaço de trabalho ou sistema operacional do usuário.
4. O diretório de trabalho atual quando nenhuma pasta de projeto mais restrita for óbvia.

Faça apenas uma pergunta concisa se houver várias pastas de projeto plausíveis e escrever na errada criaria trabalho de limpeza.

Se o ambiente do usuário tiver um sistema de registro durável, siga as instruções do AGENTS.md mais próximo ou instruções equivalentes do projeto antes de escrever.

Use um nome de arquivo como:

<slug-do-topico>__codex-process-asset__YYYY-MM-DD.md

Se nenhum slug de tópico for óbvio, use:

codex-closeout__YYYY-MM-DD.md

2. Localizar Evidências

Registre os caminhos das evidências antes de escrever o ativo.

Procure por:

• Caminho do espaço de trabalho atual.
• Caminho da sessão JSONL do Codex atual ou arquivada.
• ID da thread do payload session_meta do JSONL, quando disponível.
• Arquivos criados, editados, movidos ou verificados durante a conversa.
• Sistemas externos lidos ou gravados, com links ou nomes de consultas quando seguro preservar.

O arquivo de sessão geralmente está em:

~/.codex/sessions/YYYY/MM/DD/rollout-*.jsonl
~/.codex/archived_sessions/rollout-*.jsonl

No Windows, ~ geralmente resolve para o diretório de perfil do usuário.

Se a sessão ativa atual ainda não estiver visível no disco, escreva isso explicitamente:

Codex session evidence: current live thread; JSONL not located at closeout time.

Ajudante opcional:

python scripts/extract_session_events.py --latest
python scripts/extract_session_events.py --session "/path/to/rollout.jsonl"

Use o ajudante apenas para obter um inventário bruto de eventos. Crie a linha do tempo final você mesmo.

3. Escrever o Ativo de Processo

Use esta estrutura:

# <Título> Codex Process Asset

Data arquivada: AAAA-MM-DD
Hora do arquivamento: AAAA-MM-DD HH:mm+TZ
Espaço de trabalho: `<caminho absoluto>`
Projeto local: `<caminho absoluto>`
Evidência da sessão Codex: `<caminho absoluto ou nota de thread ativa>`
ID da thread: `<id ou desconhecido>`

## 1. Tipo de Ativo

Este arquivo é um ativo de processo. Ele preserva a evolução principal da conversa do Codex, não a transcrição bruta completa.

## 2. Por Que Isso Foi Preservado

* <por que o encerramento é importante>
* <o que o leitor futuro deve recuperar deste ativo>

## 3. Linha do Tempo Concisa

| Hora | Evento | Significado |
| --- | --- | --- |
| <hora> | <turno principal> | <por que foi importante> |

## 4. Saídas e Evidências

| Tipo | Caminho / Link | Notas |
| --- | --- | --- |

## 5. Decisões e Correções

* <decisão final>
* <correção importante do usuário>
* <limite esclarecido>

## 6. Acompanhamentos em Aberto

* <item ou "Nenhum registrado">

## 7. Limites

* Mensagens privadas brutas, credenciais e conteúdo completo do JSONL do Codex não foram copiados.
* Os arquivos de sessão originais foram mantidos no lugar.

## 8. Tags de Recuperação

* <tag>

Mantenha a prosa compacta. O ativo deve ser útil para reler em um ou dois minutos.

4. Atualizar Índices Próximos

Atualize a menor superfície de descoberta próxima quando ela existir:

• README.md ou index.md na pasta do projeto, se tiver uma tabela de artefatos ou mapa de origem.
• CHANGELOG.md na pasta do projeto, se existir.
• Qualquer registro de execução local ou índice de projeto exigido pelo AGENTS.md ou política de espaço de trabalho equivalente.

Não crie uma nova pasta apenas para encerramentos, a menos que nenhuma pasta de projeto razoável exista.

5. Verificar

Antes de finalizar:

• Confirme que o ativo de processo existe no caminho pretendido.
• Pesquise no ativo pelo caminho da evidência da sessão ou nota de thread ativa.
• Confirme que qualquer atualização de índice ou changelog menciona o novo ativo.
• Liste os arquivos alterados.

6. Resposta Final e Arquivo

Responda brevemente com:

• Caminho do ativo de processo.
• Quaisquer arquivos de índice ou changelog atualizados.
• Status do caminho da evidência.
• Qualquer acompanhamento que permaneça em aberto.

Em seguida, arquive a conversa atual. No Codex Desktop, emita a diretiva de arquivamento como a linha final:

::archive{reason="Ativo de processo de encerramento criado e conversa arquivada"}

Pule a diretiva de arquivamento apenas se o usuário pedir para preparar um encerramento sem encerrar a thread.

Exemplos

Use esta habilidade para comandos como:

• "Encerre esta thread do Codex e crie um ativo de processo rastreável."
• "Arquive esta conversa, preservando as principais decisões e caminhos de evidência."
• "Feche esta thread com um ativo de processo conciso."
• "Execute o encerramento e deixe o caminho de saída e as evidências da sessão na pasta do projeto."