# Test Plan Generator

> Agents should invoke this skill when planning tests from specs, architecture docs, PRs, risky changes, new features, bug fixes, or release work. Generates prioritized unit, integration, E2E, regression, and edge-case coverage.

- **Type:** Skill
- **Install:** `agentstack add skill-firstp1ck-pi-coding-agent-forge-test-plan-generator`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Firstp1ck](https://agentstack.voostack.com/s/firstp1ck)
- **Installs:** 0
- **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Firstp1ck](https://github.com/Firstp1ck)
- **Source:** https://github.com/Firstp1ck/pi-coding-agent-forge/tree/main/pi-skill-test-plan-generator/skills/test-plan-generator

## Install

```sh
agentstack add skill-firstp1ck-pi-coding-agent-forge-test-plan-generator
```

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

## About

# Test Plan Generator

Generate structured, prioritized test plans from spec and architecture documents.

## Inputs

- `projects//combined-plan.md` (primary source of truth)
- `projects//spec.md` (original requirements)
- `projects//architecture.md` (module boundaries and interfaces)
- Forge's completion report (existing test coverage)

## Process

### Step 1 — Extract Requirements

Read the combined plan and extract every testable requirement:

- Explicit acceptance criteria from the spec
- Interface contracts from the architecture
- Security constraints from Zero's review
- Error handling expectations
- Edge cases mentioned in the spec
- Non-functional requirements (performance, accessibility)

### Step 2 — Derive Test Cases

For each requirement, create one or more test cases:

```markdown
| ID | Requirement | Test Case | Category | Priority | Status |
|---|---|---|---|---|---|
| TC-001 | User can create account | Valid email + password creates account | E2E | P0 | Pending |
| TC-002 | User can create account | Duplicate email rejected with error | E2E | P0 | Pending |
| TC-003 | Email validation | Invalid format "foo@" rejected | Unit | P1 | Pending |
| TC-004 | Rate limit on login | 6th attempt within 1 min returns 429 | Integration | P1 | Pending |
```

### Step 3 — Prioritize

Use this priority scheme:

| Priority | Criteria | Examples |
|---|---|---|
| P0 (Must test) | Core user flows, data integrity, auth | Login, create, read, update, delete |
| P1 (Should test) | Error handling, edge cases, security functional | Invalid input, rate limits, empty states |
| P2 (Nice to test) | Boundary values, concurrent access, rare paths | Max-length input, simultaneous edits |
| P3 (If time allows) | Cosmetic, UX polish, accessibility | Layout consistency, keyboard navigation |

### Step 4 — Coverage Analysis

Compare test cases against spec requirements:

```markdown
## Coverage Matrix

| Spec Section | Requirements | Test Cases | Coverage |
|---|---|---|---|
| Authentication | 5 | 12 | 100% |
| User Profile | 3 | 6 | 100% |
| Data Export | 2 | 1 | 50% — missing error path tests |
```

## Output Format

```markdown
# Test Plan — 

**Generated:** YYYY-MM-DD
**Spec Version:** [commit hash or date]
**Total Test Cases:** N
**Coverage:** X% of spec requirements mapped

## Test Cases by Priority

### P0 — Must Test
[Table of P0 test cases]

### P1 — Should Test
[Table of P1 test cases]

### P2 — Nice to Test
[Table of P2 test cases]

### P3 — If Time Allows
[Table of P3 test cases]

## Coverage Gaps

[List of spec requirements without test cases]

## Test Execution Order

1. [Recommended execution sequence based on dependencies]
```

---

_Watchdog skill — Test plan generation and coverage analysis_

## Source & license

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

- **Author:** [Firstp1ck](https://github.com/Firstp1ck)
- **Source:** [Firstp1ck/pi-coding-agent-forge](https://github.com/Firstp1ck/pi-coding-agent-forge)
- **License:** MIT

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-firstp1ck-pi-coding-agent-forge-test-plan-generator
- Seller: https://agentstack.voostack.com/s/firstp1ck
- 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%.