Eujenz/collaborative-agent-harness

O que collaborative-agent-harness faz?

Habilidade e scaffold de workflow para Codex para desenvolvimento assistido por agentes, checkpoints, higiene do Git e transferência de sessão.

Visão Geral

Este repositório fornece uma estrutura (scaffold) e uma habilidade para o Codex (e agentes similares) que permite:

• Checkpoints: Salvar o estado atual do progresso do código, permitindo retornar a pontos anteriores.
• Higiene do Git: Garantir que todos os commits sigam boas práticas (mensagens descritivas, commits atômicos).
• Transferência de Sessão: Passar o contexto de uma sessão de agente para outra de forma fluida, incluindo histórico de decisões e pendências.

Como Funciona

O scaffold organiza o projeto em diretórios e arquivos de configuração que o agente (Codex) reconhece e utiliza automaticamente. A habilidade adiciona comandos e comportamentos ao agente para:

1. Criar checkpoints em intervalos definidos ou manualmente.
2. Manter um log de decisões (CHANGELOG.md ou DECISIONS.md).
3. Executar git add, git commit e git push com mensagens padronizadas.
4. Gerar um resumo de sessão ao final de cada interação para facilitar a transferência.

Plataformas Suportadas

• Codex (Microsoft)
• Potencialmente adaptável para outros agentes de terminal (como Claude Code, Cursor, etc.)

Estrutura do Scaffold

projeto/
├── .agent/               # Configurações do agente
│   ├── config.yaml       # Configurações da habilidade
│   └── session.log       # Log da sessão atual
├── CHANGELOG.md          # Histórico de mudanças
├── DECISIONS.md          # Registro de decisões arquiteturais
├── .gitignore
├── README.md
└── ... (código do projeto)

Uso

1. Copie o scaffold para seu projeto.
2. Inicie uma sessão com o Codex.
3. A habilidade será carregada automaticamente (se configurada no perfil do Codex).
4. Use comandos como:
   • checkpoint - Salva o estado atual.
   • commit - Faz um commit com mensagem descritiva.
   • handoff - Gera um resumo para transferência.

Exemplo de Sessão

$ codex --skill Eujenz/collaborative-agent-harness
> checkpoint
Checkpoint criado: .agent/checkpoints/2025-04-07_14-30-00
> commit
Mensagem do commit: Adiciona validação de entrada do usuário
Commit realizado (abc1234).
> handoff
Resumo de sessão gerado: .agent/handoff_summary.md

Contribuição

Sinta-se à vontade para abrir issues ou pull requests para melhorar este scaffold e habilidade.