Claude Skill

integration-e2e-testing

Integration and E2E test design principles, ROI calculation, test skeleton specification, and review criteria. Use when designing integration tests, E2E tests, or reviewing test quality.

LLM Mart · 0 points · 11 views 0 listing impressions 0 install-command copies
Download shinpr-claude-code-workflows-dev-workflows-frontend_skills_integration-e2e-testing-e9118a0.zip · 1 KB

Install

skills CLI npx skills add https://github.com/shinpr/claude-code-workflows/tree/main/dev-workflows-frontend/skills/integration-e2e-testing
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install shinpr-claude-code-workflows@llmmart
Git git clone https://github.com/shinpr/claude-code-workflows.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole shinpr/claude-code-workflows collection as a plugin from our marketplace. Git is the plain clone.

Skill manifest

Integration and E2E Skeleton Contracts

Test Lanes

Lane Observable boundary Dependencies
integration Interactions within a process, including framework-rendered UI and module/API handlers Real participating components; mock only outside the claimed boundary
fixture-e2e Actual UI behavior in a real browser with deterministic fixtures Fixtures may replace dependencies outside the claimed boundary
service-integration-e2e Outcome depends on actual cross-service interaction or persistence Required local services and stores are real; stubs only outside that proof boundary

Test Skeleton Specification

Required Comment Patterns

Each test MUST include the following annotations:

AC: [Original acceptance criteria text]
Behavior: [Trigger] → [Process] → [Observable Result]
@lane: integration | fixture-e2e | service-integration-e2e
@dependency: none | [component names] | full-system
Selection evidence: [required claim, uncovered failure, and why cheaper existing proof is insufficient]

Use the project's comment syntax to wrap these annotations (e.g., // for C-family, # for Python/Ruby/Shell).

Selection evidence serves test selection and planning, so the implementing task removes it when it makes the test executable.

Verification Items (Optional)

When verification points need explicit enumeration:

Verification items:
- [Item 1]
- [Item 2]

Test File Naming Convention

  • Integration tests: *.int.test.* or *.integration.test.*
  • fixture-e2e tests: *.fixture.e2e.test.* (or organize under tests/e2e/fixture/)
  • service-integration-e2e tests: *.service.e2e.test.* (or organize under tests/e2e/service/)

The test runner or framework in the project determines the appropriate file extension. Repos that already use a single *.e2e.test.* convention may keep it as long as each file declares @lane: in its header — the lane annotation is the source of truth for routing.

Route Parity for Shared Mutations

When multiple routes reach the same mutation, compare validation, classification, resource bounds, and read/parse/mutation/reporting order. A difference becomes a proof obligation when it can violate an authoritative contract or expose a material bypass in the changed boundary. Reuse existing proof or add the smallest test that detects that failure.

Files (claude-code-workflows)
  • SKILL.md 2.6 KB
    ---
    name: integration-e2e-testing
    description: Defines integration/E2E skeleton annotations, lane and file contracts, and route-parity review criteria. Use when generating or consuming test skeletons or reviewing shared mutation routes.
    ---
    
    # Integration and E2E Skeleton Contracts
    
    ## Test Lanes
    
    | Lane | Observable boundary | Dependencies |
    |------|---------------------|--------------|
    | `integration` | Interactions within a process, including framework-rendered UI and module/API handlers | Real participating components; mock only outside the claimed boundary |
    | `fixture-e2e` | Actual UI behavior in a real browser with deterministic fixtures | Fixtures may replace dependencies outside the claimed boundary |
    | `service-integration-e2e` | Outcome depends on actual cross-service interaction or persistence | Required local services and stores are real; stubs only outside that proof boundary |
    
    ## Test Skeleton Specification
    
    ### Required Comment Patterns
    
    Each test MUST include the following annotations:
    
    ```
    AC: [Original acceptance criteria text]
    Behavior: [Trigger] → [Process] → [Observable Result]
    @lane: integration | fixture-e2e | service-integration-e2e
    @dependency: none | [component names] | full-system
    Selection evidence: [required claim, uncovered failure, and why cheaper existing proof is insufficient]
    ```
    
    Use the project's comment syntax to wrap these annotations (e.g., `//` for C-family, `#` for Python/Ruby/Shell).
    
    `Selection evidence` serves test selection and planning, so the implementing task removes it when it makes the test executable.
    
    ### Verification Items (Optional)
    
    When verification points need explicit enumeration:
    ```
    Verification items:
    - [Item 1]
    - [Item 2]
    ```
    
    ## Test File Naming Convention
    
    - Integration tests: `*.int.test.*` or `*.integration.test.*`
    - fixture-e2e tests: `*.fixture.e2e.test.*` (or organize under `tests/e2e/fixture/`)
    - service-integration-e2e tests: `*.service.e2e.test.*` (or organize under `tests/e2e/service/`)
    
    The test runner or framework in the project determines the appropriate file extension. Repos that already use a single `*.e2e.test.*` convention may keep it as long as each file declares `@lane:` in its header — the lane annotation is the source of truth for routing.
    
    ## Route Parity for Shared Mutations
    
    When multiple routes reach the same mutation, compare validation, classification, resource bounds, and read/parse/mutation/reporting order. A difference becomes a proof obligation when it can violate an authoritative contract or expose a material bypass in the changed boundary. Reuse existing proof or add the smallest test that detects that failure.
    

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.