TDD QA Harness
jatinpaspaceo/tdd-qa-harness
Automação TDD e QA gates config-driven para Claude Code
Ver no GitHubPlugin 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-harness1 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
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
| Component | Trigger | Behavior |
|---|---|---|
| remind hook | every prompt (UserPromptSubmit) | Injects TDD discipline + "right skill at the right moment" nudges + your project's remind.notes. |
| verify hook | turn end (Stop) | If a watched file changed, runs your gates[] and blocks the turn if any are red. Loop-guarded. |
| tdd skill | on demand | Bundled RED/GREEN/REFACTOR discipline. |
/qa-init | command | Detects the stack and scaffolds qa-harness.json + an optional git pre-commit hook + CI. |
/qa-gates | command | Runs 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>)$. Omitwatch.pathsto 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.fixHintis 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/, bumpversion, push. - Add a command → drop a
.mdunderplugins/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
jqon PATH (hooks + templates parseqa-harness.jsonwith it).git(the Stop hook detects changes viagit diff/git ls-files).