> ## Documentation Index
> Fetch the complete documentation index at: https://agent-harness101.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Contributing

> Help improve the questions, explanations, diagrams, and evidence.

The guide is designed to be easy to read, verify, and extend. Each topic is an MDX file; `docs.json` controls its place in the navigation.

## Improve a topic

1. Start with a concrete question or limitation.
2. Explain why the simpler design breaks.
3. Show the component or decision that addresses it.
4. Include costs, limitations, and source links.

<Warning>
  Do not present illustrative examples as measured benchmarks or infer confirmed product internals from a design exercise. Keep source-specific caveats beside the claim.
</Warning>

## Preview locally

```bash theme={null}
npm install
npm run dev
```

Open `http://localhost:3001`. Changes to MDX pages update in the preview.

## Validate changes

```bash theme={null}
npm run validate
npm run check:links
```

Add new pages to `docs.json`. Keep the [learning path](/learning-path) and next-topic links consistent with the intended reading order.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.