# Failure Path Testing

> Build failure-first integration tests for workflow gates and recovery paths. Use when regressions appear after happy-path changes, when reviews flag missing negative tests, or when downstream workflows should remain blocked until specific approvals or quality checks pass.

- **Type:** Skill
- **Install:** `agentstack add skill-nnennandukwe-skills-failure-path-testing`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [nnennandukwe](https://agentstack.voostack.com/s/nnennandukwe)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [nnennandukwe](https://github.com/nnennandukwe)
- **Source:** https://github.com/nnennandukwe/skills/tree/main/skills/failure-path-testing

## Install

```sh
agentstack add skill-nnennandukwe-skills-failure-path-testing
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Failure Path Testing

Prioritize tests that prove the system refuses unsafe progression.

## Test Design Workflow

1. Identify critical gates where progression must stop.
2. Define blocked state fixtures and expected recovery actions.
3. Write integration tests that execute realistic command flows.
4. Assert both state transitions and user-facing recovery text.
5. Add one test per historical regression.
6. When a bug spans parsing, persistence, and operator output, cover all three layers in one regression path.

## High-Value Negative Paths

1. Quality gate fails and blocks social/prep.
2. Approval pending and downstream command is rejected.
3. Invalid date/week input does not create runs.
4. Failed strategy/draft run is not selected as active guidance.
5. Malformed input returns file/line or other actionable diagnostics instead of a generic crash.
6. Startup/readiness construction failures fail closed before state mutation or service exposure.
7. Artifact write failures do not leave partial output behind or replace the good index.

## Assertions To Include

- No forbidden artifact written (for example, no final draft).
- Blocking state persisted with diagnostic metadata.
- Recovery command hints are explicit and executable.
- Downstream commands fail deterministically.
- Error text should tell the operator what to fix next, not just what went wrong.

## Coverage Heuristic

For each new workflow feature:

1. Add at least one happy-path test.
2. Add at least one blocked-path test.
3. Add one message-clarity assertion for operator recovery.
4. If the feature writes files or swaps state, add a regression for the failure point before the swap.

## Output Format

When reporting work, include:

- Negative paths added
- Regression cases covered
- Blocking guarantees verified
- Remaining untested gate conditions

## High-Signal Patterns

These are the failure paths most often left untested. Reach for this skill when the change touches any of them.

- Malformed or missing configuration, readiness probes, startup guards, and artifact staging.
- Anywhere a pipeline must *not* advance: after a failed ingest, a failed readiness check, or an unmet gate. The valuable test asserts the non-advance, not the happy path.
- An empty or absent setting value that could silently resolve to a wrong default rather than failing loudly.
- Startup or background-process failures that currently surface as a silent exit rather than a non-zero status.
- Anything a review has already caught once. When a review asks for a fix, write the test around the exact failure mode before the fix — one regression test per exposed mode: an unhandled exception type, a missing CLI option, an unsafe generated filename, a test-environment leak into a live path.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [nnennandukwe](https://github.com/nnennandukwe)
- **Source:** [nnennandukwe/skills](https://github.com/nnennandukwe/skills)
- **License:** Apache-2.0

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-nnennandukwe-skills-failure-path-testing
- Seller: https://agentstack.voostack.com/s/nnennandukwe
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.