testing-guidelines

Document integration test best practices for TinyBots repositories using deep.include and Arrange-Act-Assert.

Updated Nov 1, 2025
One-click install
npx skills add https://github.com/vjcspy/devdocs --skill testing-guidelines-vjcspy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: testing-guidelines
Source: https://github.com/vjcspy/devdocs/tree/main/agent/skills/tinybots/testing-guidelines
Command: npx skills add https://github.com/vjcspy/devdocs --skill testing-guidelines-vjcspy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides clear guidelines and best practices for writing effective and maintainable integration tests for TinyBots projects, ensuring consistency and reducing test fragility.

Core Features & Use Cases

  • Assertion Strategies: Recommends deep.include for flexible object assertions and outlines when individual checks are necessary.
  • Test Structure: Promotes the Arrange-Act-Assert pattern and emphasizes descriptive test names.
  • Execution Guidance: Directs users to the correct just commands for running tests within Docker.
  • Use Case: A new developer joins a TinyBots project and needs to write their first integration test. This Skill guides them on how to structure their test, what assertions to use, and how to run it.

Quick Start

Follow the testing guidelines to write an integration test for the user service.

Frequently Asked Questions about testing-guidelines

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write robust integration tests for TinyBots without them breaking on minor API changes?

To write robust integration tests for TinyBots, use the Arrange-Act-Assert structure and apply the deep.include assertion pattern. This approach checks only the essential properties of an object, reducing test fragility and maintainability issues caused by minor API changes.

What is the best way to structure an integration test for a TinyBots repository?

The best way to structure a TinyBots integration test is using the Arrange-Act-Assert pattern. This structure separates test setup from execution and verification, requiring descriptive test names to ensure clarity and maintainability across the repository.

How do I execute integration tests for TinyBots using Docker?

You execute TinyBots integration tests by running specific just commands within your Docker containers. This ensures the testing environment remains consistent and properly isolated during the verification process.

When should I use deep.include assertions versus individual checks in my integration tests?

Use deep.include assertions for flexible object validation to prevent test fragility against minor API changes. You should use individual property checks when your integration test requires strict validation of specific values or exact object matching.

Can I run TinyBots tests without setting up a Docker container environment?

TinyBots integration tests are designed to be executed using just commands within Docker containers. Running them outside of Docker is not recommended as it bypasses the isolated environment needed for robust and consistent testing results.