Integration test writer
Skill dayvisonassis/sdd-skills/skills/integration-test-writer
Spec-driven development skills for Claude Code: PRD → spec/contract → implement → contract-based evaluation with auto-fix
npx -y skills add dayvisonassis/sdd-skills --skill integration-test-writerAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Plans and implements comprehensive integration tests for the PABX backend (apps/backend/__tests__/integration/) using Jest + supertest against a real test database. Runs interactively (3 phases with an approval checkpoint) when a user calls directly, or autonomously (no pause) when dispatched by implement-feature/evaluator. Also runs in correction mode to fix a specific failing integration test flagged by the evaluator. Enforces PABX rules (setupTestDatabase, try-finally cleanup, foreign-key order, English-only, NODE_ENV=testing, batches). Never modifies production code.
SKILL.md
5.1 KB, as published. Nobody here has run it
Integration Test Writer (PABX)
Plan and implement high-quality integration tests that validate real API behavior against a real test database (full request→response lifecycle: middleware, controller, model, DB). Never modifies production code — if a test fails, only the test is adjusted.
Project scope: PABX backend. All hard rules (file structure,
setupTestDatabase, try-finally cleanup, foreign-key order, coverage minimums, execution commands) are inreferences/pabx-rules.md— read it before writing. Generic SDD flow docs:https://github.com/dayvisonassis/sdd-skills/blob/main/docs/GUIA_DO_WORKFLOW.md.
Scope: apps/backend/__tests__/integration/.
INPUT
target_file_or_endpoint(required) — controller, route, or endpoint (e.g.POST /v2/calltype).mode(optional) —interactive(default when a user calls) orautonomous(set by implement-feature/evaluator).test_file_path/focus_areas/batch_size(optional).test_catalog_path(optional) — Test Catalog entry to accelerate Phase 1.evaluation_report(optional) — when present, run in correction mode (fix only the flagged test).
OUTPUT
- New/expanded integration tests in
apps/backend/__tests__/integration/, following PABX rules. - A
.test.mdchecklist (planning may be Portuguese; all test code is English). - Per-batch execution confirmation and a final coverage summary. Production code untouched.
Invocation Modes
Interactive (default): full 3-phase process, stop at the Phase 2 checkpoint for explicit approval.
Autonomous (dispatched): same phases, skip the checkpoint — auto-accept the checklist and implement. Never pause.
Correction mode (evaluator, kind:test): an evaluation_report is provided. Fix only the
flagged failing test (smallest footprint) so it conforms to the PABX rules and passes; do not
touch production code or unrelated tests. Return control to the evaluator.
EXECUTION STEPS (3 Phases)
Phase 1 — Analysis & Planning
- If
test_catalog_pathgiven, read the entry and validate against source. - Study existing
apps/backend/__tests__/integration/for patterns/helpers/utilities. - Read the target controller/model/route fully; map code paths.
- Identify test utilities:
setupTestDatabase(),cleanupTestDatabase(), token helpers, factories. Consult DB schema (MCP MySQL) for FK constraints if needed. - Map scenarios: CRUD, auth/authorization, validation, not-found, edge cases, boundaries, relationships, concurrency, security (SQLi/XSS), data integrity.
Phase 2 — Checklist Creation
Create a .test.md checklist (name, objective, input, expected status + response). Cover the
minimum categories from references/pabx-rules.md.
- Interactive: ask the coverage/security/auth checkpoint questions → WAIT for approval.
- Autonomous / correction: skip the checkpoint; proceed.
Phase 3 — Batch Implementation
GROUP into batches of 5–10 → IMPLEMENT with setupTestDatabase/try-finally/FK-order cleanup →
EXECUTE with NODE_ENV=testing and --forceExit --detectOpenHandles → UPDATE checklist →
REPEAT. In correction mode, implement only the corrected test(s).
RULES
Always:
- Follow
references/pabx-rules.md(file structure, cleanup, coverage, execution). - Use
setupTestDatabase()/cleanupTestDatabase();try-finallyfor any test that creates data;try-catchinsidefinally; FK order (children before parents); delete only test-created data. - Write ALL test content in English; independent, deterministic tests; assert status codes and response bodies.
- Set
NODE_ENV=testing; run with--forceExit --detectOpenHandles. - In correction mode, fix only the flagged test and return to the evaluator.
Never:
- Modify production code (
*.model.js,*.controller.js, routes). Fix only tests. - Leave test data in the DB or remove pre-existing data. Rely solely on
afterEach/afterAllfor created data. - Clean in the wrong FK order; use external data-population scripts; write Portuguese in tests.
- Pause for approval in autonomous/correction mode.
Edge Cases
- Data created inside
it():try-finallyis mandatory (not justafterAll). - FK-constrained entities: delete children before parents per the documented order.
- > ~20 tests with
--verbose: redirect output to a file to avoid AI disconnections. - Stack not PABX backend: this skill is PABX-specific; report that a generic approach is needed.