- created
- 2025-12-16T00:00:00.000Z
- modified
- 2026-09-05T00:00:00.000Z
- reviewed
- 2026-04-25T00:00:00.000Z
- allowed-tools
- Task, TodoWrite
- args
- [--coverage] [--parallel] [--report]
- argument-hint
- [--coverage] [--parallel] [--report]
- description
- Every tier in pyramid order โ unit, then integration, then E2E. Use when running all tests before a PR or commit, or generating a coverage report.
- name
- test-full
- agent
- general-purpose
- context
- fork
## When to Use This Skill
| Use this skill when... | Use test-quick instead when... |
|---|---|
| Running the complete pyramid (unit, integration, E2E) before a PR | You only need fast unit-test feedback |
| Generating coverage and HTML reports across all tiers | Iterating on a single failing file (use test-focus) |
| Forcing parallel pre-commit verification across the suite | Running tests for one specific framework run (use test-run) |
| Producing a CI-like full pass locally | Asking strategic questions about strategy (use test-consult) |
## Context
- Project files: !`find . -maxdepth 1 \( -name 'pyproject.toml' -o -name 'package.json' -o -name 'Cargo.toml' -o -name 'go.mod' \)`
- Test directories: !`find . -type d \( -name "test*" -o -name "__tests__" \)`
- E2E setup: !`find . -maxdepth 1 \( -name 'playwright.config.*' -o -name 'cypress.config.*' \)`
- CI environment: !`echo "CI=$CI GITHUB_ACTIONS=$GITHUB_ACTIONS"`
## Parameters
- `--coverage`: Generate coverage report
- `--parallel`: Force parallel execution
- `--report`: Generate detailed HTML report
## Your task
**Delegate this task to the `test-runner` agent.**
Use the Agent tool with `subagent_type: testing-plugin:test-runner` to run the complete test suite. Pass all the context gathered above and specify **All Tiers** execution.
The test-runner agent should:
1. **Run tests in pyramid order** (fail fast):
- **Tier 1 - Unit tests** first (fastest feedback)
- **Tier 2 - Integration tests** (component interactions)
- **Tier 3 - E2E tests** (full user flows)
2. **Apply options**:
- If `--coverage`: Enable coverage reporting for all tiers
- If `--parallel`: Run tests in parallel where safe
- If `--report`: Generate HTML report
3. **Stop on failure** at any tier (don't waste time on later tiers)
4. **Provide pyramid summary**:
```
## Full Test Suite: [PASSED|FAILED]
| Tier | Passed | Failed | Duration |
|-------------|--------|--------|----------|
| Unit | X | Y | Zs |
| Integration | X | Y | Zs |
| E2E | X | Y | Zs |
Coverage: XX% (target: 80%)
### Failures
[Grouped by tier with file:line references]
### Recommended Actions
- [Specific next steps]
```
5. **Post-action guidance**:
- All pass: Ready to commit/PR
- Unit failures: Fix immediately, use `/test:quick` for iteration
- Integration failures: Check service boundaries
- E2E failures: Check selectors/timing
- Coverage gaps: Use `/test:consult coverage`
Provide the agent with:
- All context from the section above
- The parsed parameters
- **Explicit instruction**: Run all tiers in order
The agent has expertise in:
- Full test pyramid execution
- Coverage analysis and reporting
- E2E test frameworks (Playwright, Cypress)
- CI/CD integration
## Agent Teams (Optional)
For large test suites, spawn teammates for parallel test execution:
| Teammate | Focus | Value |
|----------|-------|-------|
| Unit test runner | Fast unit tests | Quick feedback loop, fail-fast |
| Integration test runner | Component interactions | Service boundary validation |
| E2E test runner | Full user flows | End-to-end verification |
Each teammate runs its tier independently and reports results via the shared task list. This is optional โ the skill runs tiers sequentially without agent teams.
View on GitHub