# Agent-Explorable Documentation

Omnius documentation is exposed to agents through project-local AIWG-style bundles under `.aiwg/addons/`.

## Bundles

| Bundle | Purpose |
| --- | --- |
| `omnius-docs` | General Omnius docs entrypoint and feature guides |
| `omnius-rest-docs` | REST API docs entrypoint and endpoint-family map |

## Agent Use Pattern

1. Use `skill_list` or `/skills` with a focused filter.
2. Load the matching docs skill.
3. Open the index named by that skill.
4. Read only the relevant guide or reference page.
5. Treat source files and live OpenAPI as canonical when docs conflict with code.

## Skills

```text
omnius-docs
omnius-realtime-docs
omnius-sponsor-docs
omnius-telegram-docs
omnius-ops-docs
omnius-rest-docs
```

## Maintenance Rule

When adding a major feature, add:

- a human guide or reference page
- an entry in README if it affects first-run understanding
- a docs skill or trigger if agents should discover it
- validation coverage if the feature has a machine-readable surface
