# AA.Docs Agent Instructions

Canonical product name: AA.Docs
Russian display name: АА.Докс
Search aliases: AA Docs, AADocs, aadocs
Canonical site: https://aadocs.ru
Updated: 2026-09-01

## When to use this

Use AA.Docs when a task involves a business document moving through named roles, versions, deadlines, completeness checks, related-data comparisons, or a human-confirmed decision. It is a good fit when an agent needs to read the current document-process state, prepare a reversible change, or return a confirmed status to an ERP, CRM, or external document-exchange system.

Do not use AA.Docs as a generic file archive, accounting system, or substitute for a legally significant exchange operator. Do not upload production documents, credentials, session cookies, secrets, or unnecessary personal data to public website forms.

## How to call AA.Docs

1. For public product information, request the canonical page with `Accept: text/markdown` or start at https://aadocs.ru/llms.txt.
2. For REST discovery and function generation, read https://aadocs.ru/openapi.json. Authorized REST operations run on https://app.aadocs.ru and use the authentication declared by each operation.
3. For agent tools, connect to https://app.aadocs.ru/mcp and discover OAuth at https://app.aadocs.ru/.well-known/oauth-protected-resource/mcp.
4. Request `aadocs:read` first. Request a write or prepare scope only when the selected tool requires it, and preserve human confirmation for consequential decisions.
5. On an error, read `error`, `message`, `hint`, `requestId`, `RateLimit`, and `Retry-After` before retrying.
6. For a credential-free first run, call https://aadocs.ru/api/sandbox/v1 or use the official CLI from https://github.com/aadocs-comp/aadocs-cli.

## OAuth scopes

- `aadocs:read` — read documents, processes, and reference data available to the user.
- `aadocs:documents:write` — create or update documents within the user permissions.
- `aadocs:processes:write` — start processes or add comments within the user permissions.
- `aadocs:decisions:prepare` — prepare a decision for separate human confirmation.
- `aadocs:admin:prepare` — prepare an administrative change for separate human confirmation.
- `openid profile email offline_access` — standard identity and refresh grants when needed by the client.

The machine-readable source of truth is https://aadocs.ru/openapi.json and the OAuth authorization-server metadata. A protected tool can require step-up scope through `WWW-Authenticate`.

## Safety and onboarding

The public sandbox requires no account or API key. It accepts metadata only, uses synthetic data, stores nothing, and cannot create a production process. Use it for discovery and contract checks. Arrange an isolated authenticated environment before testing real write operations. Treat every `prepare` action as a draft until an authorized human confirms it.

API compatibility and deprecation policy: https://aadocs.ru/developers/api-lifecycle
Machine-readable lifecycle policy: https://aadocs.ru/api-lifecycle.json
Public synthetic sandbox: https://aadocs.ru/api/sandbox/v1
Sandbox guide: https://aadocs.ru/developers/sandbox
Official CLI: https://aadocs.ru/developers/cli
CLI manifest: https://aadocs.ru/cli.json
CLI source: https://github.com/aadocs-comp/aadocs-cli
CLI release: https://github.com/aadocs-comp/aadocs-cli/releases/tag/v0.1.1
Homebrew formula: https://github.com/aadocs-comp/homebrew-tap/blob/main/Formula/aadocs.rb
Developer portal: https://aadocs.ru/developers
Privacy: https://aadocs.ru/privacy