https://github.com/jc1122/test-quality-assurance
Audit test suites against TDD and behavior-first best practices. Produces severity-ordered findings and a prioritized improvement plan.
https://github.com/jc1122/test-quality-assurance
best-practices claude-code code-quality leaf-skill skill tdd testing
Last synced: 16 days ago
JSON representation
Audit test suites against TDD and behavior-first best practices. Produces severity-ordered findings and a prioritized improvement plan.
- Host: GitHub
- URL: https://github.com/jc1122/test-quality-assurance
- Owner: jc1122
- License: mit
- Created: 2026-03-02T21:58:40.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-06-08T22:23:20.000Z (16 days ago)
- Last Synced: 2026-06-08T22:24:37.514Z (16 days ago)
- Topics: best-practices, claude-code, code-quality, leaf-skill, skill, tdd, testing
- Language: Python
- Size: 354 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# test-quality-assurance
Test suite quality assessment with 8-dimension TDD rubric scoring and delta tracking.
Delta reports compare two audit runs to show score trends, evidence-tier
upgrades, and finding changes. See `SKILL.md` Step 5a for the full delta
workflow: baseline selection, compatibility checks, path normalization, and
interpretation rules.
## Install
The installer refuses to overwrite an existing installation unless `--force` is
supplied (fail-closed). Use `--dry-run` to preview without mutating state.
From a pinned GitHub release:
```bash
npx github:jc1122/test-quality-assurance#v0.1.14 --dest ~/.agents/skills --force
```
From a local checkout:
```bash
node bin/install-test-quality-assurance.js --dest ~/.agents/skills --force
```
## Usage
**Important**: `audit_test_quality.py` is a **static heuristic inventory** — it
does not execute tests, run mutation analysis, or produce a final grade. Its
output is evidence for expert review. Final scoring requires the full
`SKILL.md` workflow: runtime baseline, contract map, process/gate inventory,
evidence-tiered rubric scoring, and expert confirmation.
### Installed-Skill Invocation
From any target repository, once this skill is installed:
```bash
# Resolve the script relative to the loaded SKILL.md directory.
# Common default (assumes install dest ~/.agents/skills):
python3 $HOME/.agents/skills/test-quality-assurance/scripts/audit_test_quality.py \
--root /path/to/target/repo \
--json-out /tmp/test_quality.json \
--md-out /tmp/test_quality.md
# Robust fallback when SKILL_DIR or CODEX_HOME is set, otherwise use ~/.agents:
SKILL_DIR="${SKILL_DIR:-${CODEX_HOME:+$CODEX_HOME/skills/test-quality-assurance}}"
SKILL_DIR="${SKILL_DIR:-$HOME/.agents/skills/test-quality-assurance}"
python3 "$SKILL_DIR/scripts/audit_test_quality.py" --root /path/to/target/repo ...
```
Note: `--root` must point at the target repository under audit, never at the
skill installation directory itself.
### Local-Checkout Invocation
From within a local checkout of this skill:
```bash
python3 scripts/audit_test_quality.py --root /path/to/repo --json-out report.json --md-out report.md
```
For the full workflow, see `SKILL.md`.
## Local Checks
```bash
npm run check # run fixture + reproducibility + release checks
npm run check:fixtures # fixture-only checks
npm run check:repro # reproducibility checks
npm run check:release # release-metadata checks
npm run check:release:clean
npm run pack:dry-run # verify npm package contents
```
## Release Flow
1. Run `npm run check` and `npm run pack:dry-run`.
2. Commit, push `main`.
3. Ensure clean tree before tagging:
```bash
npm run check:release:clean
```
4. Tag and push:
```bash
git tag vX.Y.Z && git push origin vX.Y.Z
```
5. Wait for tag CI to pass:
```bash
gh run watch $(gh run list -b vX.Y.Z --limit 1 --json databaseId --jq '.[0].databaseId')
```
6. Create GitHub release from the tag.
7. Reinstall pinned version:
```bash
npx github:jc1122/test-quality-assurance#vX.Y.Z --dest ~/.agents/skills --force
```
8. Verify installed payload parity:
```bash
python3 scripts/check_release.py --installed-skill-dir ~/.agents/skills/test-quality-assurance
```
## License
MIT