Skip to content

datit309/supergraph / plugins/supergraph/skills/integration

integration

Unverified

Run integration and e2e tests after unit tests pass. Use after /supergraph:fix when unit tests are green.

/supergraph:integration

Integration + e2e tests. Validates modules work together. Run AFTER unit tests pass.

Usage

/supergraph:integration | plan auth-login | plan auth-login task 3

Prerequisites

  • Unit tests passing ($TEST_CMD green)
  • /supergraph:fix completed

Steps

0. Announce

"πŸ”— /supergraph:integration β€” running integration and e2e tests..."

1. Get Commands

Read from plan ## Environment Context or .supergraph-env. Missing β†’ STOP, run /supergraph:scan first.

2. Verify Unit Tests Pass

$TEST_CMD

If unit tests FAIL β†’ STOP: "Unit tests must pass before integration. Run /supergraph:fix first."

3. Detect Integration Setup

Check for integration configuration:

ConfigCommand
jest.integration.config.jsnpx jest --config jest.integration.config.js
vitest.integration.config.tsnpx vitest --config vitest.integration.config.ts
pytest.ini with [integration] or -m integrationpytest -m integration
cypress.config.js / cypress.config.tsnpx cypress run
docker-compose.test.ymldocker compose -f docker-compose.test.yml up --abort-on-container-exit
*.integration.test.ts / *.integration.spec.ts patternnpx jest --testPathPattern="integration"

If none found β†’ skip: "No integration/e2e config found β€” skipping."

4. Run Integration Tests

Max 3 retries. On failure:

4b. Serena (optional): See serena/SKILL.md:Setup β€” find_referencing_symbols/get_diagnostics_for_file per failing module to surface mismatches. Skip if unavailable.

Trace failure to source module, fix, re-run.

5. Run E2E & Full-Stack QA Automation

  • QA Matrix Generation: Generate or verify ISTQB QA matrix coverage (docs/qa/test-matrix-<feature>.md) covering Happy path, Sad path, Boundary, Network 500 error injection, Auth/RBAC, and IDOR (scaffold via bash plugins/supergraph/skills/browser-agent/scripts/init-qa.sh matrix <feature> [ui|api|fullstack]).
  • Web/Frontend Projects: ALWAYS automatically invoke /supergraph:browser-agent to run autonomous user-flow tests via native Rust CDP (anti-bot bypass, zero Playwright).
  • Backend / API Services: Verify API endpoint schemas, response codes, DB state integrity, and error sanitization.
  • Execution: Run automated test cases via agent-browser or project e2e test script. Max 2 retries (e2e is inherently flaky). Annotate flaky tests β€” do not block merge on known-flaky external network tests.

6. Graph Validation

For CBM_PROJECT via codebase-memory-mcp (see references/codebase-memory-contract.md) β€” search_graph/trace_path + recipes dependencies/cross-boundary/test-gaps; fall back to Serena/filesystem if empty.

7. Update Plan Status

Pass β†’ mark in-progress tasks Status: completed. Fail after 3 retries β†’ mark stuck, append failure log.

8. Report

βœ… /supergraph:integration complete
- Unit: PASS | Integration: PASS|FAIL|SKIP | E2E: PASS|FAIL|SKIP
- Cross-module flows: N/M covered | Surprising connections: [list/none]
- Plan status: updated|none
- Next: /supergraph:verify β†’ /supergraph:review

Rules

  • Unit tests MUST pass BEFORE running integration
  • Integration failures take priority over e2e (fix foundation first)
  • Max 3 retries integration, 2 retries e2e
  • Never block merge on @flaky-annotated e2e tests
  • Always update plan status after completion
  • After integration pass β†’ /supergraph:verify β†’ /supergraph:review
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 318kUpdated Claude CodeCodexUnverifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 318kUpdated Claude CodeCodexUnverifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 318kUpdated Claude CodeCodexUnverifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 196kUpdated Claude CodeCodexVerifiedInstall