carmenjiang19028-ai/higiene-de-handoff-de-projeto

O que higiene-de-handoff-de-projeto faz?

Uma habilidade Codex para handoff de projeto leve, recuperação de contexto e prevenção de inchaço de backup.

Visão Geral

Esta habilidade fornece um mecanismo leve para garantir a continuidade do trabalho entre sessões de um agente de IA ou entre diferentes desenvolvedores. Ela resolve os seguintes problemas:

• Perda de contexto: Quando um agente ou desenvolvedor retorna após uma pausa, muitas vezes precisa revisar grande parte do trabalho anterior para entender o estado atual.
• Handoff ineficiente: Transferir o trabalho para outro agente ou pessoa geralmente envolve explicações verbais ou documentação extensa.
• Inchaço de backup: O arquivo de histórico de conversa pode crescer descontroladamente, dificultando a localização de informações relevantes.

Como Funciona

A habilidade mantém um arquivo de resumo de contexto (CONTEXT.md) no diretório raiz do projeto. Este arquivo contém:

• Estado atual do projeto: Resumo do progresso, arquivos modificados e tarefas concluídas.
• Decisões importantes: Registro de decisões arquiteturais ou de design tomadas.
• Tarefas pendentes: Lista de próximos passos e problemas conhecidos.
• Dependências externas: Bibliotecas, APIs ou serviços utilizados.

Uso

Inicializar contexto

Ao iniciar uma nova sessão, execute:

# Carrega o contexto do projeto
codex context load

Se o arquivo CONTEXT.md existir, ele será carregado e o agente terá acesso ao histórico resumido.

Atualizar contexto

Ao finalizar uma sessão, execute:

# Atualiza o contexto com o trabalho realizado
codex context update

Isso regenera o CONTEXT.md com as informações mais recentes.

Handoff para outro agente

Para transferir o trabalho para outro agente, compartilhe o arquivo CONTEXT.md juntamente com os arquivos do projeto. O novo agente pode então carregar o contexto usando codex context load.

Prevenção de Inchaço de Backup

Para evitar que o histórico de backup cresça demais, a habilidade recomenda:

• Limpar o arquivo de histórico antigo periodicamente.
• Usar CONTEXT.md como a única fonte de verdade para o estado do projeto.
• Não depender do histórico de conversa como documentação permanente.

Configuração

Nenhuma configuração adicional é necessária. A habilidade detecta automaticamente o diretório do projeto e gerencia o arquivo CONTEXT.md.

Compatibilidade

• Plataforma: Codex
• Linguagens: Todas (agnóstica)
• Tamanho do projeto: Pequeno a médio (recomendado)