---
title: "Built for humans and agents"
description: "Write agent-qa tests in plain language or let your coding agent author them through CLI and MCP. Keep one reviewable YAML format for your team and its agents."
canonical_url: "https://vostride.com/docs/agent-qa/humans-and-agents"
md_url: "https://vostride.com/docs/agent-qa/humans-and-agents.md"
last_updated: "2026-10-07T14:33:27+05:30"
---

> [Documentation index](https://vostride.com/docs.md) · [Site index](https://vostride.com/llms.txt)
> Follow the Markdown links to read individual pages; the indexes list the available documentation.

# Built for humans and agents

> Write agent-qa tests in plain language or let your coding agent author them through CLI and MCP. Keep one reviewable YAML format for your team and its agents.

People and coding agents work with the same test files. A test describes the expected behavior in natural-language steps inside YAML, so anyone reviewing a change can read what it verifies.

The illustration below shows both authoring paths. People contribute their product knowledge; agents use repository context, rules, skills, and MCP to produce the same kind of reviewable test.

## For humans
Describe a user journey and the outcome that matters. Each test has a stable ID, a name, a configured target, and a list of steps. Add context when the agent needs to understand a product term or the initial state of the app.

You can edit these files directly or use the [dashboard](https://vostride.com/docs/agent-qa/dashboard.md). Both the dashboard and CLI read the same file-backed definitions. Start with [your first test](https://vostride.com/docs/agent-qa/guides/first-test.md), then review the steps alongside the code they cover.

## For agents
Give your coding agent the requirements and repository context. The [agent quickstart](https://vostride.com/docs/agent-qa/agent-quickstart.md) connects it to a local agent-qa installation, while the packaged [skills](https://vostride.com/docs/agent-qa/skills.md) guide authoring, execution, and result triage.

Through the CLI or [local MCP server](https://vostride.com/docs/agent-qa/mcp.md), the agent can discover the workspace, author and validate tests, execute them, and inspect the resulting evidence. The public vostride.com MCP supplies documentation and setup guidance; execution happens through your local installation.

Follow the [coding-agent verification loop](https://vostride.com/docs/agent-qa/guides/coding-agent-workflow.md) to turn a code change into a focused test, an evidence-backed diagnosis, and a rerun.

## One review process
Tests stay in your repository regardless of who writes them. Review the expected outcome against the requirement, validate the definition, and inspect the actual run result. Successful clicks alone do not establish that the behavior is correct.

Keep tests, configuration, and useful memory under the same [version-control workflow](https://vostride.com/docs/agent-qa/configuration.md) as the rest of your project.

## Documentation navigation

- [All documentation](https://vostride.com/docs.md)
- Parent: [What is agent-qa](https://vostride.com/docs/agent-qa.md)
- Previous: [Quickstart](https://vostride.com/docs/agent-qa/quickstart.md)
- Next: [Self-healing execution](https://vostride.com/docs/agent-qa/self-healing.md)