# DOCS — Архив документации

## Архитектура

| Файл | Описание |
|------|----------|
| `ARCHITECTURE.md` | Актуальная архитектура: эндпоинты, схема БД, безопасность (§8 с фиксами аудита) |
| `ARCHITECTURE-FULL.md` | Развёрнутая архитектура: полный список файлов, все роуты, зависимости |
| `ARCHITECTURE.legacy.md` | Архитектура v1.0.x (до рефакторинга) |
| `architecture-final.md` | Финальная архитектура после всех рефакторингов и аудитов |
| `architecture-next.md` | Черновик архитектуры vNext — идеи на будущее |
| `architecture-questions-for-sonnet.md` | Вопросы к Sonnet по архитектуре (перед ревью) |
| `architecture-review-sonnet.md` | Ревью архитектуры от Sonnet |
| `architecture-round2.md` | Второй раунд архитектурных решений |

## Как делать (How-to)

| Файл | Описание |
|------|----------|
| `howto-flask-nubes.md` | **ВАЖНО.** Как писать Flask-приложение под Nubes: структура `site/`, порт 5000, `app.run()`, запреты |

## API Nubes

| Файл | Описание |
|------|----------|
| `api-access.md` | Как получить доступ к Nubes API: токены, clientId, стенды |
| `api-create-flow.md` | Полный flow создания инстанса: instances → instanceOperations → params → run → poll |
| `api-operation-stages.md` | Стадии выполнения операций (plan, apply, etc.) |
| `terraform-operations-full-logic.md` | Логика Terraform-операций: validate-cfs, refSvc, нормализация параметров |

## Планы

| Файл | Описание |
|------|----------|
| `polygon-plan.md` | **ВАЖНО.** План мок-полигона: 3 фазы, 12 шагов, YAML-спецификация |
| `opus-plan-2026-07-31.md` | План Опуса: унификация executor, гибкие ссылки, 4 фазы 13 шагов |
| `test-results-history-plan.md` | План истории результатов тестов |
| `gpt56-sol-plan.md` | План Sol по GPT-5.6 |

## Промпты для агентов

| Файл | Описание |
|------|----------|
| `agent-analysis-request.md` | Запрос на анализ проекта (архитектура, риски, рекомендации) |
| `opus-architecture-prompt.md` | Промпт Опусу: полное описание проекта + вопросы по архитектуре |
| `opus-frontend-prompt.md` | Промпт Опусу: вопросы по фронтенду (instance dropdown) |
| `gpt56-sol-prompt.md` | Промпт GPT-5.6: описание проекта для Sol |
| `sonnet-review-prompt.md` | Промпт Sonnet для code review |

## Ревью и аудиты — Sonnet

| Файл | Описание |
|------|----------|
| `sonnet-full-code-review.md` | Полный code review всех файлов |
| `sonnet-full-response.md` | Полный ответ Sonnet на review |
| `sonnet-full-review.md` | Сводка review |
| `sonnet-architecture-review-v1.0.89.md` | Архитектурное ревью v1.0.89 |
| `sonnet-architecture-review-v1.0.89-r2.md` | Второй раунд архитектурного ревью |
| `sonnet-review-v1.1.11.md` | Ревью v1.1.11 |
| `sonnet-review-answers.md` | Ответы на замечания Sonnet |
| `sonnet-review-round2.md` | Второй раунд ревью |
| `sonnet-review-round3.md` | Третий раунд ревью |
| `sonnet-final-audit.md` | Финальный аудит |
| `sonnet-final-review.md` | Финальное ревью |
| `sonnet-missed-bugs.md` | Пропущенные баги (что Sonnet не нашёл) |
| `sonnet-params-and-audit.md` | Параметры + аудит |
| `sonnet-response-params-audit.md` | Ответ: параметры и аудит |
| `sonnet-response-final.md` | Финальный ответ |
| `sonnet-response-round2.md` | Ответ второго раунда |
| `sonnet-response-v1.1.11.md` | Ответ на ревью v1.1.11 |
| `sonnet-response-serviceInstanceUid.md` | Ответ про serviceInstanceUid |
| `sonnet-response-state-out.md` | Ответ про state.out |
| `sonnet-state-out-valuelist.md` | stateOut + valueList |
| `sonnet-terraform-diff.md` | Разбор Terraform diff |
| `sonnet-new-chat.md` | Новый чат с Sonnet |
| `sonnet-question-tracker.md` | Трекер вопросов к Sonnet |

## Ревью — Опус

| Файл | Описание |
|------|----------|
| `opus-questions-2026-07-31.md` | 19 уточняющих вопросов Опуса по архитектуре |
| `opus-instance-dropdown-questions.md` | Вопросы Опуса про instance dropdown |
| `opus-review-v1.2.0.md` | Ревью v1.2.0 от Опуса |

## Вопросы-ответы

| Файл | Описание |
|------|----------|
| `questions-to-sol.md` | Вопросы к Sol |
| `sol-answers.md` | Ответы Sol |
| `sol-scenario-editor.md` | Sol про редактор сценариев |

## Прочее

| Файл | Описание |
|------|----------|
| `HISTORY.md` | Краткая хронология версий (v1.0.x → v1.2.x) |
| `dialogues.md` | Диалоги/дискуссии в процессе разработки |
| `service-categories.md` | Категории сервисов Nubes (37 сервисов, их типы) |
| `review-comparison-sonnet-opus.md` | Сравнение ревью Sonnet vs Opus |
| `step-by-step-audit-v1.0.50.md` | Пошаговый аудит v1.0.50 |
| `vm-213.md` | Заметки о VM-213 (тестовый стенд) |