ke2e

Designs and executes end-to-end tests against Docker sandbox containers with pre-flight checks and failure categorization.

2|1|Updated Feb 5, 2026
One-click install
npx skills add https://github.com/kpiteira/devops-ai --skill ke2e-kpiteira
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ke2e
Source: https://github.com/kpiteira/devops-ai/tree/main/skills/ke2e
Command: npx skills add https://github.com/kpiteira/devops-ai --skill ke2e-kpiteira

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Validating that a feature actually works end-to-end requires real API calls against a running service, not mocked integration tests, and teams lack a structured way to design, catalog, execute, and diagnose these tests. ## Core Features & Use Cases - Test Catalog and Design: A scout agent looks up existing test recipes by category and keyword, and a designer agent writes new reusable recipes from a template when no match exists. - Sandbox-Safe Execution: Pre-flight checks verify the Docker container is running, the API health endpoint responds, and the port variable points at a kinfra sandbox slot rather than production. - Failure Diagnosis: Every failure is categorized as ENVIRONMENT, CONFIGURATION, CODE_BUG, or TEST_ISSUE with a decision tree, symptom-to-cure mappings, and retry limits. - Use Case: After implementing a milestone, run the test runner against your sandbox to execute real curl-based API calls, assert on observable state via docker exec, and receive a categorized failure report instead of a raw stack trace. ## Quick Start Ask the agent to run the E2E test for a given capability against your kinfra sandbox, making sure the port variable from .devops-ai/infra.toml is set to your sandbox port first.

Frequently Asked Questions about ke2e

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run E2E tests against a Docker sandbox?

Set the port variable from .devops-ai/infra.toml to your sandbox port (find it with kinfra status), then invoke the test runner with the test name. Pre-flight checks verify the container is running and the health endpoint returns HTTP 200 before any test steps execute.

How do I write a new end-to-end test recipe?

Use the provided TEMPLATE.md structure: define pre-flight checks, test data, curl-based execution steps, success criteria, and sanity checks that catch false positives. The designer agent writes recipes to .claude/skills/ke2e/tests/{category}/{name}.md when no catalog match exists.

What is the difference between E2E tests and integration tests with mocks?

E2E tests make real API calls to a running container, observe real state changes via docker exec or API responses, and assert on real data. Integration tests with mocked externals are explicitly not E2E and should never be labeled as such.

Why does my E2E test fail with connection refused or wrong port?

Connection refused usually means the sandbox container is not running, fixable with kinfra sandbox start. Testing against the production default port instead of the sandbox port (base plus slot id) is a common configuration error caught by pre-flight checks.

How are E2E test failures categorized and diagnosed?

Failures are classified as ENVIRONMENT, CONFIGURATION, CODE_BUG, or TEST_ISSUE using a decision tree. Each category has a report format with diagnosis and suggested action, plus symptom-to-cure mappings with retry limits for infrastructure issues.

Can E2E tests handle services with LLM cold starts?

Yes, but cold starts on LLM-backed services can take 200-400 seconds, so set timeouts accordingly (e.g., 600s) or use a session warmup preflight module. For non-deterministic LLM output, assert on structure like fields and status codes rather than exact content.