origem 0.1.0 → 0.2.0

package/README.md

@@ -1,42 +1,48 @@
 # origem
 
-O last-mile do [Origem](https://origem-ai.web.app): conecta um repositório ao seu
-harness e mantém os dois em dia.
+The last mile of [Origem](https://origem-ai.web.app): connects a repository to your
+harness and keeps the two in sync.
 
 ```bash
 npx origem connect
 ```
 
-Autoriza no navegador (OAuth + PKCE — nenhum token passa pelo clipboard), escreve
-`CLAUDE.md`, `.claude/*` e `.mcp.json`, instala a skill do Origem e os hooks de
-sessão. Rodar de novo é como se sincroniza.
+Authorises in your browser (OAuth 2.1 + PKCE — no token ever touches your clipboard),
+writes `CLAUDE.md`, `.claude/*` and `.mcp.json`, and installs the Origem skill plus the
+session hooks. Running it again is how you sync.
 
-## Comandos
+## Commands
 
-| Comando | O que faz |
+| Command | What it does |
 |---|---|
-| `origem connect` | Conecta e sincroniza. É o único comando necessário no começo. |
-| `origem status` | O que mudaria, e se você editou um bloco gerenciado. |
-| `origem remove` | Reverte tudo que o Origem escreveu, usando o lock. |
-| `origem spec` | Specs abertos e em que estágio cada um está. |
-| `origem doctor` | Compara o harness com este repositório e aponta o drift. |
-| `origem bootstrap` | Lê o repositório e propõe um harness inteiro. |
-| `origem propose` | Sugere uma mudança — fica pendente até alguém aceitar. |
-| `origem apply` | Reaplica com a credencial gravada, sem navegador. |
-| `origem watch` | Executa comandos da fila mesmo sem sessão aberta. |
+| `origem connect` | Connect and sync. The only command you need to start. |
+| `origem status` | What would change, and whether you edited a managed block. |
+| `origem remove` | Reverts everything Origem wrote, using the lock. |
+| `origem spec` | Open specs and the stage each one is in. |
+| `origem doctor` | Compares the harness against this repository and reports drift. |
+| `origem bootstrap` | Reads the repository and proposes a whole harness. |
+| `origem propose` | Suggests one change — stays pending until someone accepts it. |
+| `origem apply` | Re-applies with the stored credential, without the browser. |
+| `origem watch` | Runs queued commands even with no session open. |
 
-`origem help` lista todas as opções.
+`origem help` lists every option.
 
-## Privacidade
+## What a harness is
 
-`doctor` e `bootstrap` leem o repositório **na sua máquina**. O que sobe é o
-resumo — nunca os arquivos. O Origem nunca alcança o seu computador: quem puxa é
-sempre o CLI.
+A complete Claude Code setup: instructions, rules, boundaries, memory, skills,
+subagents, commands, runtime settings and MCP servers. Its shape is fixed, because
+Claude Code dictates it — so each compartment maps to a known file on disk.
 
-## Confiança
+## Privacy
 
-Arquivos privilegiados (`settings.json` com hooks/env, `.mcp.json` com `command`)
-exigem confirmação antes de serem escritos. Defina `ORIGEM_SIGNING_SECRET` para
-exigir payload assinado.
+`doctor` and `bootstrap` read the repository **on your machine**. What goes up is the
+summary — never the files. Origem never reaches into your computer: the CLI always
+pulls, nothing is pushed to you.
+
+## Trust
+
+Privileged files (`settings.json` with hooks or env, `.mcp.json` with `command`) require
+confirmation before being written. Set `ORIGEM_SIGNING_SECRET` to require a signed
+payload.
 
 MIT.