A pausa publica o contrato, o app se registra, e o refine ajusta fora do pipeline

README.md

@@ -148,6 +148,17 @@ bash scripts/doctor.sh                      # diagnóstico
 
 Com mais de uma empresa no recorte, o `report` não imprime total consolidado: sai um resumo por org. Somar empresas distintas num número só produz um valor que não serve a nenhuma delas. Para consolidar de propósito, `--all-orgs`.
 
+Apps do Workbench (Crystal Ball e outros manifestos de `templates/apps/`):
+
+```bash
+studiolocal workflow install                        # registra todo o catálogo de apps no root
+studiolocal workflow install crystal-ball --force   # reinstala um, sobrescrevendo edição manual
+studiolocal runs show 42 --json                     # registro completo de uma run, com o contrato da pausa
+studiolocal refine 42 --alvo prompt_video --queixa "o gancho está fraco"   # ajusta fora do pipeline
+```
+
+`workflow install` roda sozinho no fim de `studiolocal install`, sem `--force`: uma máquina nova já nasce com o catálogo, e um YAML editado à mão no root nunca é sobrescrito em silêncio. `refine` nunca toca `status`/`finished_at` da run — só marca a nota como desatualizada.
+
 ## Documentação
 
 - [docs/DESIGN.md](docs/DESIGN.md): plano de arquitetura V1 completo