Pular para o conteúdo principal

Primeira sessão

Este guia mostra como usar o runtime OpenCode com o harness pela primeira vez.

1. Auditar o projeto​

Dentro do OpenCode, execute:

/harness-init

Esse comando inspeciona o projeto sem modificar nada. Ele procura por:

  • Instruções do projeto (AGENTS.md, CLAUDE.md).
  • Estado de progresso e features.
  • Comandos de verificação e startup.
  • Skills, plugins e segurança.

O resultado é um relatório de gaps — o que existe, o que falta e o que seria criado.

2. Instalar o pacote completo (opcional)​

Se o projeto é novo ou você quer padronizá-lo:

/harness-bootstrap

O bootstrap propõe um pacote completo com confirmação explícita. Ele detecta a stack do projeto e mostra cada arquivo como create, merge ou skip antes de escrever.

3. Começar a sessão​

Toda sessão produtiva começa com:

/harness-session-start

Ele lê o estado, a lista de features, o handoff anterior e o comando de verificação. Ao final, declara a task ativa:

Active task: feat-001 — Health endpoint. AC: curl /health returns 200.

4. Executar trabalho com PREVC​

Para trabalho significativo:

/prevc prepare Adicionar endpoint de health check

PREVC agrupa sete etapas em quatro fases: Prepare (prepare + plan), Execute (execute), Validate (validate + judge) e Confirm (refine + confirm). Cada fase mantém o escopo aprovado.

5. Encerrar a sessão​

Ao final, sempre execute:

/harness-clean-handoff

Ele registra o que foi feito, o que quebrou e a próxima ação. A próxima sessão lê esses arquivos e sabe exatamente onde continuar.

Próximo passo​

Leia Por que um harness? para entender o problema que o harness resolve.