Restruct docs

Author: roxblnfk

.vitepress/config.mts

@@ -73,7 +73,7 @@ gtag('config', 'G-VYGDN3X0PR');`],
       ],
       themeConfig: {
         nav: [
-          { text: 'Docs', link: '/docs/getting-started.md' },
+          { text: 'Docs', link: '/docs/intro/getting-started.md' },
           { text: 'Blog', link: '/blog/' },
         ],
         editLink: {
@@ -85,10 +85,11 @@ gtag('config', 'G-VYGDN3X0PR');`],
             {
               text: 'Introduction',
               items: [
-                { text: 'Why Testo?', link: '/docs/why-testo.md' },
-                { text: 'Getting Started', link: '/docs/getting-started.md' },
-                { text: 'Configuration', link: '/docs/configuration.md' },
-                { text: 'Writing Tests', link: '/docs/writing-tests.md' },
+                { text: 'Why Testo?', link: '/docs/intro/why-testo.md' },
+                { text: 'AI Agents', link: '/docs/intro/ai-agents.md' },
+                { text: 'Getting Started', link: '/docs/intro/getting-started.md' },
+                { text: 'Configuration', link: '/docs/intro/configuration.md' },
+                { text: 'Writing Tests', link: '/docs/intro/writing-tests.md' },
               ],
             },
             {
@@ -122,15 +123,10 @@ gtag('config', 'G-VYGDN3X0PR');`],
             {
               text: 'Guide',
               items: [
-                { text: 'All Attributes', link: '/docs/attributes.md' },
-                { text: 'CLI Reference', link: '/docs/cli-reference.md' },
-                { text: 'AI Agents', link: '/docs/ai-agents.md' },
-              ],
-            },
-            {
-              text: 'Customization',
-              items: [
-                { text: 'Events', link: '/docs/events.md' },
+                { text: 'All Attributes', link: '/docs/guide/attributes.md' },
+                { text: 'CLI Reference', link: '/docs/guide/cli-reference.md' },
+                { text: 'Events', link: '/docs/guide/events.md' },
+                { text: 'Interceptors', link: '/docs/guide/interceptors.md' },
               ],
             },
             {
@@ -152,7 +148,7 @@ gtag('config', 'G-VYGDN3X0PR');`],
       ],
       themeConfig: {
         nav: [
-          { text: 'Документация', link: '/ru/docs/getting-started.md' },
+          { text: 'Документация', link: '/ru/docs/intro/getting-started.md' },
           { text: 'Блог', link: '/ru/blog/' },
         ],
         editLink: {
@@ -164,10 +160,11 @@ gtag('config', 'G-VYGDN3X0PR');`],
             {
               text: 'Введение',
               items: [
-                { text: 'Почему Testo?', link: '/ru/docs/why-testo.md' },
-                { text: 'Начало работы', link: '/ru/docs/getting-started.md' },
-                { text: 'Конфигурация', link: '/ru/docs/configuration.md' },
-                { text: 'Пишем тесты', link: '/ru/docs/writing-tests.md' },
+                { text: 'Почему Testo?', link: '/ru/docs/intro/why-testo.md' },
+                { text: 'AI-агенты', link: '/ru/docs/intro/ai-agents.md' },
+                { text: 'Начало работы', link: '/ru/docs/intro/getting-started.md' },
+                { text: 'Конфигурация', link: '/ru/docs/intro/configuration.md' },
+                { text: 'Пишем тесты', link: '/ru/docs/intro/writing-tests.md' },
               ],
             },
             {
@@ -201,15 +198,10 @@ gtag('config', 'G-VYGDN3X0PR');`],
             {
               text: 'Руководство',
               items: [
-                { text: 'Все атрибуты', link: '/ru/docs/attributes.md' },
-                { text: 'CLI справка', link: '/ru/docs/cli-reference.md' },
-                { text: 'AI-агенты', link: '/ru/docs/ai-agents.md' },
-              ],
-            },
-            {
-              text: 'Кастомизация',
-              items: [
-                { text: 'События', link: '/ru/docs/events.md' },
+                { text: 'Все атрибуты', link: '/ru/docs/guide/attributes.md' },
+                { text: 'CLI справка', link: '/ru/docs/guide/cli-reference.md' },
+                { text: 'События', link: '/ru/docs/guide/events.md' },
+                { text: 'Интерцепторы', link: '/ru/docs/guide/interceptors.md' },
               ],
             },
             {

blog/beta-testo.md

@@ -41,7 +41,7 @@ Yes. Testo is fully independent and doesn't conflict with other tools — it doe
 :::
 
 ::: question Does Testo work with AI agents?
-Yes. Testo provides `llms.txt` and `llms-full.txt` — special files for AI agents describing the framework's API. Feed them to your agent, and it will start writing Testo tests right away. Learn more in the [documentation](/docs/ai-agents.md).
+Yes. Testo provides `llms.txt` and `llms-full.txt` — special files for AI agents describing the framework's API. Feed them to your agent, and it will start writing Testo tests right away. Learn more in the [documentation](/docs/guide/ai-agents.md).
 :::
 
 ::: question Is there IDE support?

docs/ai-agents.md

@@ -0,0 +1,71 @@
+---
+llms: false
+---
+
+# AI Agents
+
+AI agents write Testo tests well — and just as well port existing tests to Testo from other frameworks.
+
+::: tip
+The fastest path to your first test: install the package (see [Getting Started](getting-started.md)) and ask an agent to write or migrate tests, pointing it at `llms-full.txt` (see below).
+:::
+
+## How agents read Testo's docs
+
+Testo publishes its documentation in the [llms.txt](https://llmstxt.org/) format — a single machine-readable file an AI fetches instead of crawling HTML pages.
+
+| File                                                          | Content                                                | When to use                                                |
+|---------------------------------------------------------------|--------------------------------------------------------|------------------------------------------------------------|
+| [`/llms.txt`](https://php-testo.github.io/llms.txt)           | Page list with short descriptions and best practices.  | Quick overview of available documentation.                 |
+| [`/llms-full.txt`](https://php-testo.github.io/llms-full.txt) | Full text of all documentation pages.                  | When the agent needs complete context for code generation. |
+
+## Typical workflow
+
+The same three steps work for new tests and for porting an existing suite:
+
+1. **Feed the context.** Point the agent at `llms-full.txt` or paste the relevant section.
+2. **Describe the task.** Provide the class or function you want to cover — or paste the old test you want to convert.
+3. **Review and run.** Check the result and run `vendor/bin/testo`.
+
+### Example prompts
+
+Writing tests from scratch:
+
+```
+Using the Testo PHP testing framework, write tests for the following class:
+
+{paste your class here}
+
+Documentation: https://php-testo.github.io/llms-full.txt
+```
+
+Migrating from PHPUnit, Pest, or Codeception:
+
+```
+Rewrite the following PHPUnit test to Testo. Keep the same assertions and data providers,
+do not invent extra scenarios.
+
+{paste your old test here}
+
+Documentation: https://php-testo.github.io/llms-full.txt
+```
+
+### Claude Code
+
+[Claude Code](https://docs.anthropic.com/en/docs/claude-code) can fetch URLs during a conversation. Add an instruction to your project's `CLAUDE.md`:
+
+```markdown
+When writing PHP tests, use the Testo framework.
+Fetch the documentation before writing tests: https://php-testo.github.io/llms-full.txt
+```
+
+Claude Code will read this instruction and pull the documentation whenever it generates or migrates tests.
+
+### Cursor, Windsurf, and others
+
+AI-powered code editors let you register external documentation as context. The typical approach is to add the documentation URL once and then reference it in chat.
+
+- **Cursor:** Add the URL via **Settings → Features → Docs → Add new doc**. After indexing, reference it in chat with `@Docs` → select Testo.
+- **Windsurf:** Paste the URL directly into a Cascade message.
+
+For any IDE that doesn't support URL indexing, paste the contents of `llms-full.txt` into the chat as context.

docs/attributes.md docs/guide/attributes.mddocs/attributes.md renamed to docs/guide/attributes.md

@@ -5,6 +5,10 @@ llms_description: "Getting started with Testo. Installation via Composer, testo.
 
 # Getting Started
 
+::: tip Working with an AI assistant?
+Testo is designed to be friendly to AI coding agents — both for writing new tests and for migrating from PHPUnit, Pest, or Codeception. Skim [AI Agents](./ai-agents.md) first, and your agent can do most of the work below for you.
+:::
+
 ## Installation
 
 Install Testo via Composer: