convez.ai
HookDevOps & InfraestruturaIntermediário
jatinpaspaceo

TDD QA Harness

jatinpaspaceo/tdd-qa-harness

Automação TDD e QA gates config-driven para Claude Code

Ver no GitHub
InicialPluginScore · de 0 a 100

Plugin para Claude Code que automatiza Test-Driven Development e quality gates reutilizáveis entre projetos. Funciona por configuração JSON no raiz do repositório, injetando lembretes de disciplina TDD, validando mudanças de arquivos e bloqueando turns se gates falharem.

Instalação

$npx convez-ai jatinpaspaceo/tdd-qa-harness

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Enforçar padrões de código e testes automaticamente em projetos
  • Lembretes contextuais de disciplina TDD a cada prompt
  • Bloquear mudanças que não passam nos gates de qualidade
  • Compartilhar configuração de QA entre time e CI/CD

Veredito

Ferramenta sólida para times que querem TDD enforçado no fluxo Claude Code. Requer jq e git, bem documentada, com extensibilidade clara via JSON. Particularmente útil em pipelines Laravel/PHP.

README

A tradução para o português deste README ainda está na fila.

tdd-qa-harness

A config-driven Claude Code plugin that makes Test-Driven Development and QA gates automatic and reusable across projects. Any repo opts in by dropping a single qa-harness.json at its root — no per-project plugin code.

What it does

ComponentTriggerBehavior
remind hookevery prompt (UserPromptSubmit)Injects TDD discipline + "right skill at the right moment" nudges + your project's remind.notes.
verify hookturn end (Stop)If a watched file changed, runs your gates[] and blocks the turn if any are red. Loop-guarded.
tdd skillon demandBundled RED/GREEN/REFACTOR discipline.
/qa-initcommandDetects the stack and scaffolds qa-harness.json + an optional git pre-commit hook + CI.
/qa-gatescommandRuns all gates on demand (handy before pushing).

No qa-harness.json → every hook no-ops. Harmless in repos that haven't opted in.

Install

/plugin marketplace add jatinpaspaceo/tdd-qa-harness
/plugin install tdd-qa-harness

Enable it globally; each repo opts in per-project with its own qa-harness.json.

Configure — qa-harness.json

{
  "watch": { "paths": ["app", "tests"], "ext": ["php"] },
  "gates": [
    { "name": "Style",  "command": "vendor/bin/pint --test", "fixHint": "vendor/bin/pint" },
    { "name": "Static", "command": "vendor/bin/phpstan analyse --no-progress" },
    { "name": "Tests",  "command": "php artisan test" }
  ],
  "remind": { "framework": "laravel", "notes": "landlord_id scoping; validate via FormRequest" }
}
  • watch.paths / watch.ext — the Stop hook only runs gates when a changed file matches ^(<paths>)/.*\.(<ext>)$. Omit watch.paths to run on any change.
  • gates[] — an ordered list. Each gate is just a shell command run from the repo root; a non-zero exit is a failure. fixHint is shown when the gate fails.
  • remind.notes — free-text project guardrails appended to every TDD reminder.

qa-harness.json is a QA config (not a Claude file) — commit it so your team and CI share it.

Extending

  • Add a gate → add an entry to gates[]. No plugin change.
  • Add a skill → drop a folder under plugins/tdd-qa-harness/skills/, bump version, push.
  • Add a command → drop a .md under plugins/tdd-qa-harness/commands/.

Layout

.claude-plugin/marketplace.json      lists the plugin
plugins/tdd-qa-harness/
  .claude-plugin/plugin.json         manifest (name, version, author)
  hooks/{hooks.json,scripts/*}       remind + verify
  scripts/{lib.sh,run-gates.sh}      shared gate runner
  commands/{qa-init,qa-gates}.md
  skills/tdd/SKILL.md
  templates/{pre-commit,ci.yml}      scaffolded by /qa-init
tests/                               POSIX-sh test suite (run: bash tests/run.sh)

Develop & test

bash tests/run.sh                                  # shell test suite (needs bash + jq)
claude --plugin-dir ./plugins/tdd-qa-harness       # load locally
claude plugin validate ./plugins/tdd-qa-harness    # validate the manifest

Requirements: bash, jq.

Requirements

  • jq on PATH (hooks + templates parse qa-harness.json with it).
  • git (the Stop hook detects changes via git diff/git ls-files).
Ver o original no GitHub

Bom para

Relacionados