vocare

Verify tests exercise public interfaces from the caller's perspective.

Updated May 20, 2026
One-click install
npx skills add https://github.com/watmin/datamancy.dev --skill vocare
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vocare
Source: https://github.com/watmin/datamancy.dev/tree/main/vocare
Command: npx skills add https://github.com/watmin/datamancy.dev --skill vocare

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Tests that verify the public interface from the caller's perspective, preventing leakage into internal details and ensuring that the surface presented to users is correct.

Core Features & Use Cases

  • Verify test vantage: ensure tests exercise the API as a consumer would use it.
  • Guard interfaces: prevent tests from reaching past the interface into internals or state.
  • Use Case: when refactoring or designing new APIs, ensure tests stay aligned with the public contract and user-facing behavior.

Quick Start

Write and run a consumer-facing test that calls the public API and asserts outcomes at the interface boundary.

Frequently Asked Questions about vocare

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

FAQPage Schema
How do I verify tests exercise the public API from the caller's perspective?

To verify tests from the caller's perspective, you write and run consumer-facing tests that call the public API and assert outcomes strictly at the interface boundary, preventing leakage into internal implementation details.

What is tester vantage in API quality assurance?

Tester vantage in API quality assurance is the practice of applying tests across consumer, substrate-primitive reference, and internal-caller scopes. It ensures proper testing vantage by enforcing boundary respect and guarding against tests reaching into state or internals.

How do I prevent tests from leaking into implementation details during API design?

You prevent tests from leaking into implementation details by validating that they exercise the public interface as a consumer would use it. This guards the interface and stops tests from reaching past the boundary into internal state.

When do I need to validate test vantage for interface governance?

You need to validate test vantage for interface governance when refactoring or designing new APIs. It ensures your tests stay aligned with the public contract and user-facing behavior rather than internal implementation.

Can I use caller-perspective testing to check substrate-primitive reference scopes?

Yes, caller-perspective testing applies across consumer, substrate-primitive reference, and internal-caller test scopes. It ensures proper vantage by verifying that tests exercise the public interface correctly across all these layers.

What are the limitations of boundary-respecting interface tests?

Boundary-respecting interface tests focus strictly on the public contract and user-facing behavior. They do not verify internal implementation details or private state, meaning internal regressions might go undetected if they do not surface through the public API.