Deixe o agente correr — sem perder o controle

O histórico do projeto, sem ninguém digitar

Cada sessão de trabalho registra sozinha início, fim, escopo e resultado, e a autoria vem do git — não de um campo que alguém preencheu. Ler o histórico é ler o que de fato aconteceu, na ordem em que aconteceu.

no seu repodocs/history.md

O status é lido, não reportado

O andamento de cada feature é derivado da execução real e gravado em arquivo versionado. Nenhum quadro para arrastar cartão, nenhuma daily para descobrir onde as coisas pararam: o painel mostra o estado do repositório.

no seu repo.harness-state/

Cada feature com a sua trilha completa

Proposta, especificação, review, casos de uso e relatórios de validação ficam na pasta da feature que os originou. O que foi combinado, o que foi entregue e o que foi verificado ficam lado a lado — pronto para revisão, auditoria ou para quem chegar depois.

no seu repodocs/features/

A pendência não some

O que ficou de fora de um ciclo vira um item rastreado, com severidade, dono e status — em vez de virar um comentário perdido numa thread. O débito técnico deixa de ser sensação e vira lista.

no seu repodocs/followups/

Para quando falta contexto, em vez de inventar

Quando uma pré-condição não está atendida ou uma informação essencial falta, o fluxo interrompe e diz exatamente o que falta — sem escrever nada. É o oposto do agente que preenche o buraco com uma suposição plausível e você descobre três dias depois.

As verificações críticas não são opinião do modelo

Conformidade, regras de camada, verificação de segurança e rastreabilidade rodam em motores determinísticos: dão o mesmo resultado toda vez, para qualquer modelo. O que o agente "acha" nunca é a última palavra sobre se algo passou.

Ninguém escreve no seu código sem a sua aprovação

Antes de qualquer ação de risco, um humano aprova — com níveis configuráveis por tipo de operação, aprovação em quatro olhos quando você quiser, e registro de quem liberou o quê. Você escolhe o quanto de autonomia dar, por operação.

Trabalho interrompido não vira trabalho perdido

Se uma execução trava no meio, o Spaccy a reconcilia e retoma a fila do ponto certo. E quando uma escrita foge do padrão esperado, ela é revertida e a reversão é provada por checksum — nada fica duplicado nem apagado por acidente.

Permissão explícita, identidade real

Cada operação exige uma permissão declarada, e cada papel do time recebe só o que precisa. A identidade de quem escreveu vem do git — a trilha aponta para uma pessoa, não para "o agente".