Skip to main content

Agent Consumption

The docs source is Markdown-first and the deployed docs expose a raw Markdown mirror.

Agents should start with:

https://docs.wendellai.com/llms.txt

Markdown files are available at:

https://docs.wendellai.com/markdown/

For repository-local consumption, read files directly from:

docs-site/docs/

Recommended read order:

  1. index.md
  2. quickstart.md
  3. cli.md
  4. configuration.md
  5. agent-adapter-contract.md
  6. troubleshooting.md

Contract for agent readers

The Markdown files avoid site-specific components and can be parsed without rendering Docusaurus.

Front matter is standard YAML:

---
title: Quickstart
description: Create and run your first Wendell Playbook-backed test suite.
---

Agents can ignore front matter if they only need procedural content.

Stable concepts

Use these terms consistently:

TermMeaning
PlaybookBusiness behavior source material.
Playbook draftHosted draft created from source material.
Playbook summaryExtracted and reviewable primitive summary.
Required questionBlocking review question that must be answered before approval.
Test suitePublished hosted scenario pack generated from an approved Playbook.
RunnerLocal CLI identity that runs the customer agent and uploads results.
Agent adapterCustomer-owned command invoked by Wendell with JSON stdin/stdout.