test-cases

A command for generating structured software test cases, which are specific checks describing an input or situation and the result the software should produce.

In plain words
What is it for?
Use it to write tests for a feature or code path, add missing coverage, or generate a full-project test set; formal mode can include test-management details.
Why use it?
It scans the project and considers multiple testing conditions, helping reveal gaps that simple happy-path tests may miss.

Command

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add commands/tercel/spec-forge/test-cases
Clone the repo
git clone --depth 1 https://github.com/tercel/spec-forge
Per session 32 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 2,440 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00032 $0.02440
Opus 5 $0.00016 $0.01220
Sonnet 5 $0.00006 $0.00488
Haiku 4.5 $0.00003 $0.00244

Measured yesterday against content hash 86854b18bcf4, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

test-cases scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

commands/test-cases.md · 229 lines

How it starts

The opening of the file, as written. The whole thing — 229 lines — stays where its author put it; the contents beside it link to each section on GitHub.

You are a senior QA engineer with deep expertise in test case design, coverage analysis, and multi-dimensional testing methodology.

Your task is to generate a structured test case set for: $ARGUMENTS

Step 0: Parse Arguments

Parse $ARGUMENTS to determine:

  1. --formal flag: If present, include formal management sections (environment, roles, schedule, defect management)
  2. Target: The remaining argument after removing --formal (if any)
Argument Pattern Formal Mode Target
--formal user-auth Yes user-auth
user-auth No user-auth
--formal @src/services/pay.ts Yes @src/services/pay.ts
@src/services/pay.ts No @src/services/pay.ts
--formal (no target) Yes Full scan
(empty) No Full scan

Step 1: Project Context Scanning

1.1 Basic Project Scan

  1. Use Glob to scan the project directory tree
  2. Read the project README.md if it exists
  3. Scan docs/ for existing documents
  4. Detect (do NOT read) matching upstream documents: check if docs/*/srs.md and docs/*/tech-design.md related to the target exist
  5. Use Grep to identify:
    • Project frameworks: Express, FastAPI, Spring Boot, Gin, NestJS, Click, Cobra, Commander, React, Vue, Svelte, Angular, LangChain, etc.
    • Testing frameworks: Jest, pytest, JUnit, Go test, Vitest, etc.
    • Database/ORM: Prisma, TypeORM, SQLAlchemy, GORM, Mongoose, etc.
    • Auth patterns: JWT, OAuth, passport, auth middleware/decorators
    • Test configuration files, CI/CD pipelines

1.2 Determine Input Mode

Condition Mode
Target starts with @ and points to a .md spec file Spec Mode
Target starts with @ and points to source code Code Mode
Target is a feature name or empty Scan Mode

1.3 Extract Testable Units

Scan Mode (full project):

  1. Scan ALL source files to extract testable units:
    • Routes/endpoints: HTTP method, path, parameters, response patterns
    • Functions/methods: name, parameters, return type, branch logic
    • Components: props, events, state, lifecycle
    • Commands: name, subcommands, flags, handler
    • Tool definitions: name, trigger condition, parameters
    • Models: schema, relationships, constraints
  2. Record for each unit: name, type, file path, line number, dependencies
  3. Scan existing test files to identify which units already have tests
  4. Build the Functional Inventory

Read the full file on GitHub · 229 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 229 lines · 32 tokens per session scan A 86854b18bcf4

Subscribe to this mod's changes

test-cases is a command published in the GitHub repository tercel/spec-forge (5 stars, last pushed 1mo ago), licensed MIT. It adds 32 tokens to every session and 2,440 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.