@fullchico/harness 0.1.0 → 0.1.3
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 +42 -1
- package/install +12 -0
- package/package.json +4 -4
- package/plugin/.claude-plugin/plugin.json +1 -1
- package/plugin/payload/entrega/fechamento.md +4 -0
- package/plugin/payload/gate-check +5 -1
- package/plugin/payload/hooks/__pycache__/common.cpython-313.pyc +0 -0
- package/plugin/payload/hooks/__pycache__/gate_stamp.cpython-313.pyc +0 -0
- package/plugin/payload/push +10 -1
- package/plugin/skills/entregar/SKILL.md +2 -2
package/README.md
CHANGED
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
# FullChico Harness
|
|
2
2
|
|
|
3
|
+
Página do projeto: https://fullchico.github.io/fullchico-harness/
|
|
4
|
+
|
|
3
5
|
Ambiente de desenvolvimento com agentes, para o Claude Code. Um plugin que padroniza, em
|
|
4
6
|
todo projeto que o adota, o fluxo de uma mudança, os guardrails e o ambiente de
|
|
5
7
|
desenvolvimento por feature.
|
|
@@ -43,12 +45,51 @@ com sandbox disponível. O remoto do projeto precisa ser HTTPS. Recomendado: `rt
|
|
|
43
45
|
|
|
44
46
|
## Instalar num projeto
|
|
45
47
|
|
|
46
|
-
|
|
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:
|
|
47
53
|
|
|
48
54
|
```bash
|
|
49
55
|
npx @fullchico/harness install .
|
|
50
56
|
```
|
|
51
57
|
|
|
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):
|
|
61
|
+
|
|
62
|
+
```bash
|
|
63
|
+
cd /caminho/do/projeto
|
|
64
|
+
claude plugin marketplace add FullChico/fullchico-harness
|
|
65
|
+
claude plugin install harness@fullchico --scope project
|
|
66
|
+
```
|
|
67
|
+
|
|
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.
|
|
73
|
+
|
|
74
|
+
### Deixar o Claude instalar
|
|
75
|
+
|
|
76
|
+
Cole este pedido numa sessão do Claude Code aberta na pasta do projeto:
|
|
77
|
+
|
|
78
|
+
```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.
|
|
80
|
+
|
|
81
|
+
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.
|
|
91
|
+
```
|
|
92
|
+
|
|
52
93
|
Com o repositório clonado, `/caminho/do/fullchico-harness/install /caminho/do/projeto` faz o mesmo.
|
|
53
94
|
|
|
54
95
|
Ele grava `.harness/`, `.claude/settings.json`, `AGENTS.md`, `CLAUDE.md`, `docs/agents/` e
|
package/install
CHANGED
|
@@ -85,6 +85,18 @@ if grep -Eq '^PROJECT="?[^"[:space:]]' "$ROOT/harness.conf" 2>/dev/null; then
|
|
|
85
85
|
NEXT="O harness.conf já estava preenchido: portas gravadas no .env e dependências instaladas."
|
|
86
86
|
fi
|
|
87
87
|
|
|
88
|
+
if [ -n "${CLAUDECODE:-}" ]; then
|
|
89
|
+
cat >&2 <<'EOT'
|
|
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
|
|
97
|
+
EOT
|
|
98
|
+
fi
|
|
99
|
+
|
|
88
100
|
cat <<EOT
|
|
89
101
|
|
|
90
102
|
Harness $VERSION instalado em $ROOT, no perfil $PROFILE.
|
package/package.json
CHANGED
|
@@ -1,16 +1,16 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@fullchico/harness",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.3",
|
|
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",
|
|
7
7
|
"repository": {
|
|
8
8
|
"type": "git",
|
|
9
|
-
"url": "git+https://github.com/
|
|
9
|
+
"url": "git+https://github.com/fullchico/fullchico-harness.git"
|
|
10
10
|
},
|
|
11
|
-
"homepage": "https://github.com/
|
|
11
|
+
"homepage": "https://github.com/fullchico/fullchico-harness#readme",
|
|
12
12
|
"bugs": {
|
|
13
|
-
"url": "https://github.com/
|
|
13
|
+
"url": "https://github.com/fullchico/fullchico-harness/issues"
|
|
14
14
|
},
|
|
15
15
|
"keywords": ["claude-code", "agents", "harness", "guardrails", "hooks"],
|
|
16
16
|
"bin": {
|
|
@@ -104,6 +104,10 @@ gravada por um hook a partir dessa resposta. Você não grava aprovação e não
|
|
|
104
104
|
.harness/push
|
|
105
105
|
```
|
|
106
106
|
|
|
107
|
+
**Projeto sem remoto.** O comando confere os quatro portões do mesmo jeito e termina dizendo
|
|
108
|
+
que a branch está aprovada e que nada foi enviado. É um fim válido: pule o passo 6 (não há
|
|
109
|
+
pull request), faça o passo 7 e diga ao dono, no relato, o que falta para publicar.
|
|
110
|
+
|
|
107
111
|
É o único caminho até o remoto. Se ele negar, leia o motivo: aprovação faltando para o
|
|
108
112
|
commit atual quer dizer que houve commit depois da revisão, ou que um revisor não fechou
|
|
109
113
|
a resposta no formato: dispare de novo o que faltou. Se o motivo for a branch padrão
|
|
@@ -19,7 +19,11 @@ ZERO=0000000000000000000000000000000000000000
|
|
|
19
19
|
SPEC_GLOB='docs/specs/*/spec.md'
|
|
20
20
|
[ -f "$H/map.env" ] && . "$H/map.env"
|
|
21
21
|
|
|
22
|
-
if
|
|
22
|
+
if [ -z "$REMOTE_URL" ]; then
|
|
23
|
+
# Projeto sem remoto: a base é a branch padrão local, a mesma que os revisores usaram.
|
|
24
|
+
LOCAL_BASE="$(python3 -I "$H/hooks/common.py" branch-base "$(git rev-parse HEAD)" 2>/dev/null)" || LOCAL_BASE=""
|
|
25
|
+
LS="${LOCAL_BASE:+$LOCAL_BASE HEAD}"
|
|
26
|
+
elif ! LS="$(git ls-remote --symref "$REMOTE_URL" HEAD 'refs/heads/*' 2>/dev/null)"; then
|
|
23
27
|
echo "push negado: não consegui consultar o remoto ($REMOTE_URL) para medir o que a branch acrescenta." >&2
|
|
24
28
|
exit 1
|
|
25
29
|
fi
|
|
Binary file
|
|
Binary file
|
package/plugin/payload/push
CHANGED
|
@@ -22,8 +22,17 @@ cd "$ROOT" || exit 1
|
|
|
22
22
|
# Worktree de agente já integrado não sobra para depois da entrega.
|
|
23
23
|
"$HERE/agents-clean" >/dev/null 2>&1 || true
|
|
24
24
|
BRANCH="$(git symbolic-ref --short -q HEAD)" || die "o push é sempre de uma branch; este checkout não está em nenhuma."
|
|
25
|
-
URL="$(git remote get-url origin 2>/dev/null)" || die "este repositório não tem o remoto origin."
|
|
26
25
|
SHA="$(git rev-parse HEAD)"
|
|
26
|
+
if ! URL="$(git remote get-url origin 2>/dev/null)"; then
|
|
27
|
+
# Sem remoto não há para onde enviar, mas a entrega se confere igual: os mesmos portões,
|
|
28
|
+
# medidos contra a branch padrão local. Passou, está pronta; publicar é um passo do dono.
|
|
29
|
+
printf 'refs/heads/%s %s refs/heads/%s 0000000000000000000000000000000000000000\n' "$BRANCH" "$SHA" "$BRANCH" \
|
|
30
|
+
| "$HERE/gate-check" "" || exit 1
|
|
31
|
+
echo "Branch $BRANCH aprovada nos portões ($SHA). Projeto sem remoto: nada foi enviado."
|
|
32
|
+
echo "Para publicar: crie o repositório, ligue com \`git remote add origin <url https>\`, envie a branch"
|
|
33
|
+
echo "padrão (esse primeiro envio é do dono) e rode .harness/push de novo."
|
|
34
|
+
exit 0
|
|
35
|
+
fi
|
|
27
36
|
|
|
28
37
|
printf 'refs/heads/%s %s refs/heads/%s 0000000000000000000000000000000000000000\n' "$BRANCH" "$SHA" "$BRANCH" \
|
|
29
38
|
| "$HERE/gate-check" "$URL" || exit 1
|
|
@@ -44,8 +44,8 @@ perguntar.
|
|
|
44
44
|
estiver na branch padrão, pare e peça ao dono para abrir o worktree da feature.
|
|
45
45
|
- Confira que há remoto: `git remote get-url origin`, e que a branch padrão já está nele
|
|
46
46
|
(`git ls-remote origin`). Sem remoto não existe push nem pull request; sem a branch padrão
|
|
47
|
-
lá, o pull request não tem base, e o primeiro envio dela é do dono, no terminal. Avise o dono já agora, numa linha, e siga: a entrega vai até
|
|
48
|
-
|
|
47
|
+
lá, o pull request não tem base, e o primeiro envio dela é do dono, no terminal. Avise o dono já agora, numa linha, e siga: sem remoto a entrega vai até o fim
|
|
48
|
+
(portões conferidos, aplicativo de pé) e só o envio e o pull request ficam para depois.
|
|
49
49
|
- Rode `.harness/fetch`. Se a branch padrão do remoto andou, traga-a para dentro da feature
|
|
50
50
|
com `git merge origin/<branch padrão>`, antes de qualquer outra coisa.
|
|
51
51
|
- Leia `GLOSSARY.md` e os ADRs em `docs/adr/`, se existirem.
|