testing

A repository-specific guide to choosing and running automated tests and quality checks.

In plain words
What is it for?
Use it while editing, before pushing code, or during broad refactors to select focused, affected, or full test gates and identify coverage or integration-test requirements.
Why use it?
It helps developers run the checks relevant to their changes and understand which results only continuous integration, the shared build system, can confirm.

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/callstack/agent-device/testing
Clone the repo
git clone --depth 1 https://github.com/callstack/agent-device
Per session 0 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,145 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.00000 $0.02145
Opus 5 $0.00000 $0.01073
Sonnet 5 $0.00000 $0.00429
Haiku 4.5 $0.00000 $0.00215

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

Security

Grade A, and why

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

docs/agents/testing.md · 187 lines

How it starts

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

Testing Notes

Repository-specific testing traps you cannot learn from the test runner alone. Executable gate ownership lives in scripts/check-affected/ and scripts/gate/.

Which gates a change needs

Three tiers:

  1. While editing: a focused test or pnpm check:quick.
  2. Before pushing: pnpm check:affected --run. It derives the relevant local gates and lists the checks that CI or a native toolchain owns.
  3. For a broad refactor, or when the full deterministic gate is requested: pnpm check.

GitHub stays authoritative for provider integration, full coverage, native builds, device lanes, and history-backed compatibility. To inspect the gate catalog or a plan:

pnpm check:affected
pnpm check:affected --json
pnpm gate --help

check:affected --run reports coverage obligations but never turns coverage instrumentation on. It runs one capped vitest related command. Run the dedicated coverage scripts only to diagnose a red CI result.

Two selection traps recur:

  • A response that emits platform or appleOs needs provider integration and coverage evidence. Unit tests do not run the provider project, which is what catches internal apple leaking onto the wire.
  • A workspace package manifest or TypeScript config can rewire all consumers, so the affected selector fails open to the full gate set on purpose.

Docs-only changes with no behavior impact need no runtime tests. Structural guidance gates still need a planted violation that shows their failure direction.

Platform and live-device policy

HarmonyOS has no provisioned CI emulator, physical device, DevEco image, or HDC installation. Unit, provider, and coverage tests mock the typed HDC seam. Real validation is local hardware evidence per docs/agents/device-verification.md. Do not add a CI lane that assumes a developer host.

Apple runner changes run pnpm check:xctest-selection and build the affected target. The source #if guard is the XCTest lane classification — never maintain a second test-name list. Pure runner decisions use the macOS host lane; iOS/XCTest semantics need a simulator lane.

Read the full file on GitHub · 187 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 · 187 lines · 0 tokens per session scan A 7e1ba6c3b762

Subscribe to this mod's changes

testing is an agent published in the GitHub repository callstack/agent-device (4,300 stars, last pushed today), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 2,145 tokens. 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

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

backend-api-security-backend-security-coder

Expert in secure backend coding practices specializing in input validation, authentication, and API security. Use PROACTIVELY for backend security implementations or security code reviews.

wshobson/agents · 40 tokens

agent-orchestration-context-manager

Elite AI context engineering specialist mastering dynamic context management, vector databases, knowledge graphs, and intelligent memory systems. Orchestrates context across multi-agent workflows, enterprise AI systems, and long-running projects with 2024/2025 best practices. Use PROACTIVELY for complex AI…

wshobson/agents · 66 tokens

basic-agents

A basic agent uses a predefined strategy with a simple execution flow that works for most common use cases. It accepts a string input (a question, request, or task description) and sends this input to the configured LLM. The LLM may decide to call provided tools. The agent will execute the tools and send the results…

JetBrains/koog · 0 tokens

explainer

Code explanation and architecture walkthroughs. Helps developers understand complex code and systems.

AgentWorkforce/relay · 18 tokens

fixer

Use for quick fixes, hotfixes, urgent patches, and time-sensitive bug repairs.

AgentWorkforce/relay · 21 tokens