product directionDesenhado para o agente pilotar
O modelo de produto coloca hooks e skills do harness na entrada, para o próprio agente acionar o protocolo, acompanhar o run e retomar com contexto.
Orquestração durável pilotada pelo agente
Pajé foi desenhado para ser pilotado pelo próprio agente via hooks e skills. Ele transforma cada mudança em um fluxo verificável, independente da linguagem: contexto certo, execução isolada, aprovação humana e publicação idempotente.
sha256:8d7a4e...bf31O agente pilota. Pajé sustenta.
O harness preserva a autonomia do agente; Pajé oferece o contrato previsível para os efeitos. Hooks e skills são a superfície de integração pretendida. Cada ação deixa uma prova e cada retry sabe de onde continuar.
product directionO modelo de produto coloca hooks e skills do harness na entrada, para o próprio agente acionar o protocolo, acompanhar o run e retomar com contexto.
any stackO profile generic executa checks estruturados para qualquer stack disponível na imagem do worker. Go é a implementação e um profile opcional, não um requisito do repositório.
restart-safeCada fase persiste seu estado. Retries retomam o trabalho certo, sem relançar o agente ou duplicar efeitos.
Mem0 adapterO agente recebe contexto relevante por usuário e aplicação. Credenciais do worker ficam fora da execução.
content-addressedPatch, saída, verificações e preflight viram um bundle imutável, autenticado por SHA-256.
artifact-boundA decisão humana vale para um run e um digest exatos. Mudou o artefato? A aprovação deixa de valer.
idempotentBranch, commit e pull request são reutilizados apenas quando todos os vínculos conferem. Sem force-push.
Codex firstCodex é o primeiro harness suportado. A fronteira de execução existe para receber outros harnesses sem mudar o protocolo durável.
code-change@v1
O agente inicia e acompanha o trabalho pela integração do harness. Hatchet cuida da fila, retries e sinais; Pajé cuida do contrato: estado, contexto, artefatos, política e publicação.
Resolve
Valida a entrada, reserva a chave idempotente e resolve o ref para um commit imutável.
Execute
Prepara um worktree isolado, recupera memória, roda o agente e verifica cada módulo selecionado.
Approval
Pausa de forma durável e espera uma aprovação ligada ao digest exato do artefato.
Publish
Reaplica e reverifica o bundle antes de criar ou reutilizar um draft PR determinístico.
Finalize
Grava um único resultado na memória e retorna referências duráveis para auditoria.
Guia rápido
O beta é um worker self-hosted. Codex é o primeiro harness; o protocolo foi desenhado para receber outros.
Pré-requisitos
Go 1.26+ é necessário apenas para desenvolver o Pajé, que é implementado em Go. O repositório atendido pode usar qualquer linguagem; inclua o toolchain correspondente na imagem do worker. No beta, prepare Docker, Helm 3, Hatchet e autenticação do Codex.
Instalação
Construa a imagem com uma revisão auditável e aplique o chart depois de configurar Secrets separados.
bashgit clone https://github.com/araihu/paje.git
cd paje
PAJE_COMMIT="$(git rev-parse --verify 'HEAD^{commit}')"
docker build \
--build-arg CODEX_VERSION=0.144.5 \
--build-arg PAJE_COMMIT="$PAJE_COMMIT" \
-t ghcr.io/your-org/paje:beta .
helm upgrade --install paje ./charts/paje \
--namespace paje --create-namespace \
--values values.production.yamlPrimeira execução
Hoje, inicie paje-code-change-v1 no Hatchet. A integração pretendida levará esse trigger para hooks e skills do harness. Use profile: generic com checks explícitos e o toolchain presente na imagem. O profile go é só uma conveniência para descoberta de módulos e defaults de teste.
json{
"run_id": "73f659b2-eaee-4c37-8784-48fab274b3e8",
"input": {
"idempotency_key": "client-timeout-20260725",
"task_description": "Aumente o timeout do cliente e atualize os testes.",
"repository_uri": "https://github.com/example/service.git",
"base_ref": "main",
"memory_query": "convenções do cliente HTTP",
"memory_limit": 5,
"tags": {
"user_id": "operator@example.com",
"app_id": "service"
},
"profile": "generic",
"checks": [
{
"name": "test",
"executable": "npm",
"args": [
"test"
],
"timeout": "10m",
"required": true
}
],
"publication": {
"mode": "artifact"
}
}
}Publicação
Para criar um draft PR, use publication.mode: pull_request. A fase de aprovação aguarda o evento paje:approval:<run-id> com o mesmo run e digest. Se algo mudar, a decisão não é reaproveitada.
Segurança por fronteiras
Credenciais de Hatchet, Mem0 e GitHub não entram no ambiente do agente. Publicação acontece em um repositório bare novo e confiável, depois da verificação do código controlado pelo repositório.
Ler garantias e conflitosservice credentialsDocumentação
01 / Use
02 / Operate
03 / Deploy
04 / Understand
Hoje, Pajé oferece o template tipado code-change@v1, o runner do Codex como primeiro harness, disparo pelo Hatchet, modo artifact ou draft PR no GitHub e uma única réplica. Hooks e skills agent-side e outros harnesses serão suportados no futuro. Merge automático, YAML arbitrário, releases e múltiplas réplicas ficam fora deste beta.
O agente pilota via hooks e skills.
Pajé torna o percurso durável.