@fullchico/harness 0.1.3 → 0.1.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,6 +1,15 @@
1
+ <img src="site/trem.svg" alt="" width="72" align="right">
2
+
1
3
  # FullChico Harness
2
4
 
3
- Página do projeto: https://fullchico.github.io/fullchico-harness/
5
+ [![npm](https://img.shields.io/npm/v/@fullchico/harness?label=npm&color=1d1b16)](https://www.npmjs.com/package/@fullchico/harness)
6
+ [![ci](https://github.com/fullchico/fullchico-harness/actions/workflows/ci.yml/badge.svg)](https://github.com/fullchico/fullchico-harness/actions/workflows/ci.yml)
7
+
8
+ [Página do projeto](https://fullchico.github.io/fullchico-harness/) · [Pacote no npm](https://www.npmjs.com/package/@fullchico/harness)
9
+
10
+ ```bash
11
+ npx @fullchico/harness install .
12
+ ```
4
13
 
5
14
  Ambiente de desenvolvimento com agentes, para o Claude Code. Um plugin que padroniza, em
6
15
  todo projeto que o adota, o fluxo de uma mudança, os guardrails e o ambiente de
@@ -45,52 +54,47 @@ com sandbox disponível. O remoto do projeto precisa ser HTTPS. Recomendado: `rt
45
54
 
46
55
  ## Instalar num projeto
47
56
 
48
- Antes: o projeto precisa ser um repositório git. O remoto, que tem de ser HTTPS, pode vir
49
- depois: sem ele a entrega roda até o fim e termina aprovada e pronta, e só o envio e o pull
50
- request ficam esperando.
51
-
52
- Um comando, **no seu terminal, fora de uma sessão do Claude Code**, na pasta do projeto:
57
+ Um comando, no seu terminal, na pasta do projeto (um repositório git):
53
58
 
54
59
  ```bash
55
60
  npx @fullchico/harness install .
56
61
  ```
57
62
 
58
- De dentro de uma sessão o sandbox bloqueia o GitHub: os arquivos são gravados, mas o registro
59
- do marketplace falha. Se foi o seu caso, complete no terminal, **na pasta do projeto** (o
60
- segundo comando liga o plugin na pasta em que é rodado):
63
+ É só isso. Ele grava os arquivos do harness, registra o marketplace, instala o plugin e as
64
+ skills. Depois abra o Claude Code na pasta e faça o pedido:
61
65
 
62
- ```bash
63
- cd /caminho/do/projeto
64
- claude plugin marketplace add FullChico/fullchico-harness
65
- claude plugin install harness@fullchico --scope project
66
+ ```text
67
+ /harness:entregar quero um sistema de agendamento para uma barbearia
66
68
  ```
67
69
 
68
- Se o primeiro responder que a origem não bate com uma entrada já registrada, há um marketplace
69
- `fullchico` antigo nas suas configurações: `claude plugin marketplace remove fullchico` e repita.
70
-
71
- Depois de instalar, abra o Claude Code na pasta uma vez, em modo interativo, e aceite o
72
- diálogo de confiança: sem isso ele ignora as permissões do projeto.
70
+ Na primeira vez o Claude Code pergunta se você confia na pasta: aceite. O remoto pode vir
71
+ depois: sem ele a entrega roda até o fim, e só o envio e o pull request ficam esperando.
73
72
 
74
73
  ### Deixar o Claude instalar
75
74
 
76
- Cole este pedido numa sessão do Claude Code aberta na pasta do projeto:
75
+ Se preferir, cole este pedido numa sessão do Claude Code aberta na pasta do projeto:
77
76
 
78
77
  ```text
79
- Instale o FullChico Harness neste projeto e deixe-o pronto para a primeira entrega. Siga esta ordem e pare se algo falhar, mostrando o erro exato.
78
+ Instale o FullChico Harness neste projeto e deixe-o pronto para a primeira entrega. Pare se algo falhar, mostrando o erro exato.
80
79
 
81
80
  1. Confira os pré-requisitos: esta pasta é um repositório git (se não for, pergunte antes de criar um), e existem `python3`, `node`, `docker compose` e `claude`. Diga o que falta.
82
- 2. Rode `npx @fullchico/harness install .`. O perfil padrão é o fullstack TypeScript; se eu quiser outro, eu digo.
83
- 3. Se o instalador avisar que o marketplace ou o plugin não foram registrados (acontece dentro de uma sessão, por causa do sandbox), não tente contornar. Passe-me os comandos para eu rodar no meu terminal, na pasta do projeto, e espere eu confirmar:
84
- claude plugin marketplace add FullChico/fullchico-harness
85
- claude plugin install harness@fullchico --scope project
86
- 4. Confira o que foi gravado: `.harness/`, `.claude/settings.json`, `.claude/skills/`, `AGENTS.md`, `CLAUDE.md` e `harness.conf`. Não edite arquivo gerenciado pelo harness.
87
- 5. Peça-me para reiniciar o Claude Code nesta pasta, para o plugin e os hooks carregarem, e para aceitar o diálogo de confiança. Depois de reiniciar, rode `/harness:setup`.
88
- 6. Faça o commit do que foi gerado, numa branch, e explique o primeiro envio: com remoto, ele é meu, no terminal; sem remoto, o projeto segue local.
89
-
90
- No fim, relate em poucas linhas o que foi instalado, o que eu preciso fazer à mão e o comando para começar a primeira entrega.
81
+ 2. Rode `npx @fullchico/harness install .` fora do sandbox do Bash, pedindo a minha permissão: o instalador precisa alcançar o GitHub para registrar o plugin, e dentro do sandbox isso é bloqueado. Um comando só faz tudo: grava os arquivos, registra o marketplace e instala o plugin e as skills.
82
+ 3. Confira o que foi gravado: `.harness/`, `.claude/settings.json`, `.claude/skills/`, `AGENTS.md`, `CLAUDE.md` e `harness.conf`. Não edite arquivo gerenciado pelo harness.
83
+ 4. Faça o commit do que foi gerado, numa branch.
84
+ 5. Peça-me para reiniciar o Claude Code nesta pasta, para o plugin e os hooks carregarem.
85
+
86
+ No fim, relate em poucas linhas o que foi instalado e o comando para começar a primeira entrega: `/harness:entregar <o que eu quero construir>`, num worktree de feature.
91
87
  ```
92
88
 
93
- Com o repositório clonado, `/caminho/do/fullchico-harness/install /caminho/do/projeto` faz o mesmo.
89
+ ### Se algo não funcionar
90
+
91
+ - **Rodei o comando de dentro de uma sessão do Claude Code e o plugin não apareceu.** O
92
+ sandbox da sessão bloqueia o GitHub. Rode de novo no seu terminal, fora da sessão; o comando
93
+ pode ser repetido sem dano.
94
+ - **"A origem não bate com uma entrada já registrada".** Há um marketplace `fullchico` antigo
95
+ nas suas configurações: `claude plugin marketplace remove fullchico` e rode o instalador de novo.
96
+ - **Projeto que já tinha código.** Depois de instalar, rode `/harness:setup` numa sessão: ele
97
+ propõe o `harness.conf` a partir do que encontra.
94
98
 
95
99
  Ele grava `.harness/`, `.claude/settings.json`, `AGENTS.md`, `CLAUDE.md`, `docs/agents/` e
96
100
  `orca.yaml`, registra os marketplaces, e instala no escopo do projeto o plugin do harness e os
@@ -98,15 +102,6 @@ de terceiros (`mattpocock-skills`, `ponytail`). Se o `harness.conf` já estiver
98
102
  também grava as portas no `.env` e instala as dependências. Pode ser rodado de novo. Arquivo
99
103
  gerenciado alterado à mão trava a instalação; `--force` substitui.
100
104
 
101
- Num projeto novo falta um passo, numa sessão do Claude Code aberta nele:
102
-
103
- ```
104
- /harness:setup
105
- ```
106
-
107
- Ele propõe o `harness.conf` a partir do que encontra no projeto. Faça o commit do que foi
108
- gerado e reinicie a sessão.
109
-
110
105
  ### Perfis
111
106
 
112
107
  O instalador aceita `--profile`, e a escolha fica no `harness.conf`:
package/install CHANGED
@@ -79,7 +79,7 @@ for s in json.load(open(sys.argv[1])).get("project_skills", []):
79
79
  fi
80
80
 
81
81
  # Com o harness.conf já preenchido, deixa o worktree pronto: portas no .env e dependências.
82
- NEXT="Falta, numa sessão do Claude Code aberta no projeto: /harness:setup, que propõe o harness.conf."
82
+ NEXT="O harness.conf é preenchido na primeira entrega. Se o projeto já tem código, rode antes /harness:setup, que o propõe a partir do que encontra."
83
83
  if grep -Eq '^PROJECT="?[^"[:space:]]' "$ROOT/harness.conf" 2>/dev/null; then
84
84
  HARNESS_SKIP_PLUGIN=1 "$ROOT/.harness/setup-worktree" || exit $?
85
85
  NEXT="O harness.conf já estava preenchido: portas gravadas no .env e dependências instaladas."
@@ -88,12 +88,10 @@ fi
88
88
  if [ -n "${CLAUDECODE:-}" ]; then
89
89
  cat >&2 <<'EOT'
90
90
 
91
- install: você está dentro de uma sessão do Claude Code. O sandbox dela bloqueia o acesso ao
92
- GitHub, e o registro do marketplace e a instalação dos plugins podem ter falhado. Os arquivos
93
- do projeto foram gravados. Para completar, rode no seu terminal, fora da sessão:
94
- cd <pasta do projeto>
95
- claude plugin marketplace add FullChico/fullchico-harness
96
- claude plugin install harness@fullchico --scope project
91
+ install: você está dentro de uma sessão do Claude Code, e o sandbox dela bloqueia o GitHub: o
92
+ plugin pode não ter sido instalado. Os arquivos do projeto foram gravados. Para completar, rode
93
+ este mesmo comando no seu terminal, fora da sessão; ele pode ser repetido sem dano:
94
+ npx @fullchico/harness install <pasta do projeto>
97
95
  EOT
98
96
  fi
99
97
 
@@ -101,8 +99,6 @@ cat <<EOT
101
99
 
102
100
  Harness $VERSION instalado em $ROOT, no perfil $PROFILE.
103
101
  $NEXT
104
- Abra o Claude Code uma vez nessa pasta, em modo interativo, e aceite o diálogo de confiança:
105
- sem isso ele ignora as permissões do projeto (.claude/settings.json), inclusive em sessões por linha de comando.
106
- Depois faça o commit do que foi gerado e envie a branch padrão ao remoto. Esse primeiro envio é
107
- seu, no terminal: os portões valem para ele também (.harness/approve em cada um).
102
+ Pronto. Abra o Claude Code nessa pasta (na primeira vez, aceite a confiança da pasta) e peça:
103
+ /harness:entregar <o que você quer construir>
108
104
  EOT
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@fullchico/harness",
3
- "version": "0.1.3",
3
+ "version": "0.1.4",
4
4
  "description": "Trilhos e portões para projetos desenvolvidos com agentes no Claude Code: orquestração por ticket, revisão independente presa ao commit, ambiente por feature.",
5
5
  "license": "MIT",
6
6
  "author": "FullChico",
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "harness",
3
- "version": "0.1.3",
3
+ "version": "0.1.4",
4
4
  "description": "Orquestração, guardrails e memória para projetos desenvolvidos com agentes.",
5
5
  "license": "MIT",
6
6
  "author": {