# Testing

> Use when writing or debugging tests for memory-service. Covers Cucumber BDD patterns and failure reporting.

- Skill: `tomevault-io/testing-36` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/testing-36`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/testing-36/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/testing-36

---


# Testing Guidelines

## Prefer Cucumber for API Testing
For REST and gRPC tests, use the Go BDD suite under `internal/bdd/testdata/features*/` instead of unit tests with mocks.

Reserve unit tests with mocks for internal implementation details and infrastructure testing.

## Cucumber Failure Reporting
When tests fail:
```bash
go test ./internal/bdd -run TestFeatures... > test.log 2>&1
rg -n "FAIL|ERROR|panic|--- FAIL:" test.log
```

Prefer searching the redirected log for the failing scenario and stack trace context.

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/chirino) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->