En Claude Code-plugin som hindrer en AI-agent i å avslutte på en utdatert grønn test, og i å gjenta eller stable sideeffekter den aldri så resultatet av. Hva den får gjøre, kommer fra en policy-fil du skriver, aldri fra prompten.
sum.mjs, du trenger ikke kjøre testene på nyttnode --test består på filene a1f3sum.mjs, filene er nå 9c07test besto sist på a1f3; filene er endret siden.node --test på nytt: 1 feil, fikser den, består på b2e8git push får tidsavbrudd etter at pushen har kommet framgit push på nyttgit-push har allerede lyktes på denne commiten.SENT BACKCore stoppet agenten to ganger: én gang fra å avslutte på et gammelt bestått resultat, én gang fra å pushe igjen. Begge gangene ble den sendt tilbake med begrunnelsen.
Forkortet fra stale-green-demoen i repositoriet; tree-ID-ene er illustrative. Kjør hele demoen selv på noen sekunder, uten Claude.
01PrinsipperPRINCIPLES
En sterkere agent skriver mer kode per sesjon og kjører flere kommandoer på egen hånd. Disse reglene er ikke avhengige av at agenten er forsiktig; de gjelder uansett hva den sier.
RULE 01
Om agenten får pushe, merge, release eller publisere, bestemmes av en policy-fil den ikke kan redigere. Å be pent i prompten endrer ingenting.
RULE 02
En bestått test teller bare for nøyaktig de filene den kjørte på. Endre én linje, og den beståtte kjøringen teller ikke lenger.
RULE 03
En sideeffekt med ukjent resultat blokkerer alle videre sideeffekter til den er sjekket mot leverandøren eller avklart av et menneske.
| Situasjon | Bare agenten | Med Core |
|---|---|---|
| Testene besto, så ble en fil endret | «Testene består.» | Sendt tilbake for å kjøre på nytt på dagens filer. |
npm test | tail | Regnet som grønn; exit-koden tilhører tail. | Teller aldri; Stop sier hvorfor. |
| Én spec-fil i stedet for hele suiten | Regnet som «testene består». | Med exact teller bare hele kommandoen. |
| Push får tidsavbrudd etter at den kom fram | Pusher igjen. | Samme push på samme commit avvises. |
| Prompten sier «du kan publisere» | Publiserer. | Policyen avgjør: allow, ask eller deny. |
Skrevet og endret av et menneske. Core avviser agentens direkte endringer i den.
Gjelder fortsatt. allow i policyen gir aldri mer enn Claude Code ville gitt.
Håndhever policyen ved hver kommando, redigering og stopp.
Beskriver målet. Har ingen autoritet.
02Slik fungerer detHOW IT WORKS
Core kjører i Claude Codes egne hooks. Ingenting å starte, ingen server, ingen konto; tilstanden ligger i .git/better-workflows/ i hvert repositorium.
gh trengs, men ikke kan brukes.bevis knyttet til filene
En test, lint, typecheck eller build teller bare hvis den besto, dens egen exit-kode avgjorde resultatet, ingen fil ble endret mens den kjørte, og filene fortsatt er nøyaktig de den kjørte på.
Valgfritt
exact: bare hele kommandoen teller, og cwd angir hvor den må kjøres.scope (med exact): en endring utenfor de navngitte katalogene holder resultatet ferskt.ignore (hele policyen): utdata en sjekk skriver, som coverage, regnes ikke som en endring.høyst én gang, ukjent stopper
Pusher, opprettelse og merging av PR-er, releaser, pakkepublisering og dine egne typer trenger hver for seg allow fra policyen. Bare exit-kode 0 er et kjent resultat.
Skrivebeskyttede sjekker brukt til å avklare et ukjent resultat
git ls-remotegh pr list / viewgh release viewnpm viewEn ugyldig policy avviser alle sideeffekter i stedet for å falle tilbake til standardverdier.
En utløpt tillatelse faller tilbake til ask. Bare et menneske forlenger den, ved å redigere policyen.
Kommandoer Core ikke kan lese, som eval eller sh -c, behandles som ugjennomsiktige, og du blir spurt.
Loggen er append-only og hash-kjedet; bw verify oppdager endrede eller fjernede oppføringer og en halvskrevet siste linje, men ikke hele oppføringer som er kuttet bort fra slutten.
03VerterHOSTS
Core er vertsnøytral; hver vert trenger en liten adapter. Claude Code er den første og den eneste som støttes i dag.
| Vert | macOS | Linux | Windows |
|---|---|---|---|
| Claude CodeFørste vert | Støttet, testet i CI | Støttet, testet i CI | Ikke testet |
| CodexBare V5, fryst | Planlagt | Planlagt | Planlagt |
| Gemini CLIBare V5, fryst | Planlagt | Planlagt | Planlagt |
| Qwen CodeBare V5, fryst | Planlagt | Planlagt | Planlagt |
CI kjører Core på hver pull request.macOS 15 og Ubuntu 24.04, Node 22.23.3 og 24.21.0.
04Kom i gangGET STARTED
Krever Node.js 22.14 eller nyere, Git og Claude Code med plugin-støtte.
Én gang per maskin. Hvis du har kjørt V5 her, flytt først ~/.better-workflows til ~/.better-workflows-V5 og pek SBW_STATE_ROOT dit.
Installer den per repositorium med --scope local, så ingenting skrives i filer du committer.
bw init skriver .better-workflows/policy.json. Commit den så alle får de samme reglene.
Den fullstendige gjennomgangen dekker dine egne sjekker, sideeffekter og ukjente resultater. Kom i gang
git clone https://github.com/stephen-taipei/better-workflows ~/.better-workflowsclaude plugin marketplace add ~/.better-workflows/packages/bw-coreclaude plugin install better-workflows-core@better-workflows --scope localnode ~/.better-workflows/packages/bw-core/bin/bw.mjs initValgfritt: kjør begge scenarioene uten Claude, på noen sekunder.
node ~/.better-workflows/packages/bw-core/examples/stale-green/demo.mjsPrøv det så
Endre én linje i dette repositoriet, og ikke kjør testene.Når Claude Code prøver å avslutte, sendes den tilbake og får vite hvilken sjekk som mangler.
05GrenserLIMITS
En port er bare nyttig hvis du kjenner kantene dens.
Stopper
exact|| true som skjuler en feilGjør ikke
scope må navngi alt en sjekk er avhengig avOverlater til deg
expiresAtscope dekkerCore blokkerer feilene over. Det er ikke målt om den reduserer omarbeid eller feil beslutninger i lange oppgaver; det er det den nåværende perioden med egenbruk er til for.
eval eller sh -c, teller aldri som bevis.gh; uten den forblir de ukjente til du avklarer dem.06StatusSTATUS
V6 erstatter arbeidsflytmotoren i V5 med en liten kjerne. Datoer kommer når kriteriene er oppfylt.
DONE Fryst
tag V5.0.rc1
Arbeidsflytmotor for flere verter. Fryst på grenen frozen/v5; ikke noe nytt arbeid.
NOW Pågår
packages/bw-core
Claude Code-hooks, bevis-scope, egenbruk på to repositorier.
NEXT Etter egenbruk
første taggede release
Publiseres når egenbruksperioden viser reelle fangster og få falske blokkeringer. Flere verter følger som små adaptere.
PRE-ALPHA
Core kan brukes i dag og kjører på vedlikeholderens egne repositorier. Policy-formatet kan fortsatt endres før alpha.
Alt her er gratis og åpen kildekode. Det finnes ingen betalt plan, konto eller telemetri.
| Del | Lisens | Tilstand |
|---|---|---|
V6 Core (packages/bw-core) | Apache-2.0 | aktiv |
| Nettstedet og resten av repositoriet | AGPL-3.0-only | aktiv |
| V5-plugin | AGPL-3.0-onlypå frozen/v5 | fryst |
07DokumentasjonDOCS
Veiledningene er skrevet på engelsk og tradisjonell kinesisk. Hvert språk på dette nettstedet har en kort README på GitHub.
08FAQFAQ
Noe annet? Opprett en issue på GitHub. GitHub Issues
Hooker som håndterer en sjekk eller en sideeffekt, hasher arbeidstreet med Git, noe som tar millisekunder i et vanlig repositorium. Svært store repositorier betaler mer per slikt kall.
Den sender agenten tilbake med begrunnelsen og hvordan sesjonen har gått så langt: kjøringer, feil på rad, hvor mange ganger den allerede er sendt tilbake. Agenten kan da stoppe og fortelle deg tydelig hvilken sjekk som fortsetter å feile.
Ikke direkte. Core avviser agentens endringer i policyen og loggen, og avviser bw init og manuell avklaring av en handling. Å avinstallere pluginen, eller å endre disse filene via omveier, styres av Claude Codes egne tillatelsesregler, så la de spørsmålene være slått på.
Det finnes ingen server og ingen telemetri. De eneste nettverkskallene er skrivebeskyttede sjekker med din egen git, gh og npm, for å bekrefte om en sideeffekt har skjedd. Loggen blir i .git/better-workflows/.
De kjørte V5, som er fryst. Core er vertsnøytral, og adaptere for dem er planlagt etter alpha.
09SponseSPONSOR
Engangssponsing i USDT (TRC20)
Sponsing betaler for vedlikehold av åpen kildekode, dokumentasjonen på engelsk og tradisjonell kinesisk, og hosting. Den kjøper ikke medlemskap, prioritet i veikartet eller support.
USDT · TRON (TRC20)
TGuMUi1d8MoBQcuFrGJZnu4JrbaeP3wy9aPrøv det på noen sekunder
Kjør demoen uten Claude, installer den deretter i ett repositorium og be om en endring.
