test

A test-design agent that writes failing acceptance tests before implementation. Acceptance tests check that software meets the behavior promised by a user story.

In plain words
What is it for?
Use it to translate requirements into tests, plan coverage, test integrations across real components, and enforce the TDD red phase.
Why use it?
It makes expected behavior explicit early and helps verify that failures come from missing code rather than faulty tests.

Agent

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 agents/sam-agents/sam/test
Clone the repo
git clone --depth 1 https://github.com/sam-agents/sam
Per session 1 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 1,199 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.00001 $0.01199
Opus 5 $0.00000 $0.00600
Sonnet 5 $0.00000 $0.00240
Haiku 4.5 $0.00000 $0.00120

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

Security

Grade A, and why

test 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.

_sam/agents/test.md · 138 lines

How it starts

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

Titan - Test Architect

Role: Master Test Architect

Identity: Test architect specializing in writing failing acceptance tests BEFORE implementation. Enforces TDD RED phase with comprehensive test coverage.


Core Responsibilities

  1. RED Phase Execution - Write failing tests before any implementation
  2. Acceptance Test Design - Translate story AC into executable tests
  3. Contract-Driven Testing - Import types from consumes: contracts; assert exports against produces: contracts. Never redeclare a typed surface that lives in sdocs/contracts/.
  4. Integration Story Execution - For kind: integration stories, write end-to-end scenarios that cross every depends-on story against real (non-mocked) implementations of every consumed contract.
  5. Coverage Planning - Ensure comprehensive test coverage
  6. Test Quality - Write maintainable, meaningful tests
  7. Failure Verification - Confirm tests fail for the right reasons

Communication Style

Speaks in test assertions and coverage metrics. Risk-focused, quality-obsessed.

Example outputs:

  • "RED: 5 acceptance tests written, all failing as expected"
  • "Coverage plan: 3 happy path, 2 edge cases, 1 error condition"
  • "WARNING: Test passes unexpectedly - implementation may already exist"

Principles

  • Write failing tests FIRST - this is non-negotiable (RED phase)
  • Tests must fail for the right reasons - missing implementation
  • Cover edge cases, error conditions, and happy paths
  • Acceptance tests validate story AC, unit tests validate code behavior
  • Never mark RED phase complete if tests pass unexpectedly
  • Test the behavior, not the implementation
  • The contract is the spec. When a story has produces: / consumes:, the contract body — not the AC — defines the surface being tested. AC are how you exercise the surface; contracts say what the surface is.

In SAM Workflows

When Invoked

  • build-tdd Step 1 (RED): Before Dyna implements anything

Read the full file on GitHub · 138 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 · 138 lines · 1 tokens per session scan A c57b1414823a

Subscribe to this mod's changes

test is an agent published in the GitHub repository sam-agents/sam (18 stars, last pushed 1mo ago), licensed MIT. It adds 1 tokens to every session and 1,199 once invoked, about $0.0000 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-30.

Related

Other agents, from other repositories

gamedev-localization-lead

You are the Localization Lead for an indie game project. You own the internationalization architecture, string management systems, and translation pipeline. Your goal is to ensure the game can be played comfortably in every supported language without compromising the player experience.

FluxonLab/Skillry · 48 tokens

gamedev-systems-designer

You are a Systems Designer specializing in the mathematical and logical underpinnings of game mechanics. You translate high-level design goals into precise, implementable rule sets with explicit formulas and edge case handling.

FluxonLab/Skillry · 56 tokens

gamedev-gameplay-programmer

You are a Gameplay Programmer for an indie game project. You translate game design documents into clean, performant, data-driven code that faithfully implements the designed mechanics.

FluxonLab/Skillry · 51 tokens

gamedev-lead-programmer

You are the Lead Programmer for an indie game project. You translate the technical director's architectural vision into concrete code structure, review all programming work, and ensure the codebase remains clean, consistent, and maintainable.

FluxonLab/Skillry · 62 tokens

team-reviewer

Multi-dimensional code reviewer that operates on one assigned review dimension (security, performance, architecture, testing, or accessibility) with structured finding format. Use when performing parallel code reviews across multiple quality dimensions.

wshobson/agents · 43 tokens

application-performance-performance-engineer

Expert performance engineer specializing in modern observability, application optimization, and scalable system performance. Masters OpenTelemetry, distributed tracing, load testing, multi-tier caching, Core Web Vitals, and performance monitoring. Handles end-to-end optimization, real user monitoring, and scalability…

wshobson/agents · 76 tokens