docs: AI documentation protocol and roadmap context tool

Протокол работы AI-ассистентов, зоны frontend/backend/shared, статусы, журнал, шаблоны и скрипт сводки дорожной карты.

Refs: 1.2.3

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
This commit is contained in:
TMSHandDevin committed 2026-11-08 17:14:44 +03:00
1 parent 699e6bbd57
commit a1ce4bdb8a
15 files changed
+804

No files matched your search

+28
View File
@@ -0,0 +1,28 @@
# Документация «Штиль»
Начните с `AGENTS.md` (правила проекта), затем `docs/ai/PROTOCOL.md` (как работать с контекстом и документировать).
## Порядок чтения для новой сессии
1. `AGENTS.md`
2. `docs/ai/PROTOCOL.md`
3. `docs/status/shared.md` + `docs/status/<ваша зона>.md`
4. Последние записи `docs/journal/`
5. Дорожная карта: `node tools/roadmap-context/roadmap-context.mjs`
## Карта
| Папка / файл | Зона | Что внутри |
|---|---|---|
| `ai/` | shared | Протокол AI, сверка с дорожной картой, шаблоны |
| `status/` | shared + зоны | Снимок текущего состояния: общее, Frontend, Backend |
| `journal/` | все | История работы: одна запись на ветку/PR |
| `adr/` | shared | Архитектурные решения `NNNN-название.md` |
| `architecture/` | shared | ERD, правила БД, протокол агента, IPC Помощника |
| `ux/` | shared | Информационная архитектура, макеты, сценарии |
| `testing/` | shared | Тестовый стенд, сценарии доступа |
| `research/` | shared | Интервью, исследования рынка |
| `frontend/` | frontend | Внутренние правила Frontend: дизайн-система, компоненты, соглашения |
| `backend/` | backend | Внутренние правила Backend: области сервера, агент, эксплуатация |
| `glossary.md` | shared | Словарь терминов (#2.1) |
| `features.md` | shared | Каталог функций и лимитов (#2.3) |
| `contributing.md` | shared | Ветки, коммиты, PR, версии (#1.2.9) |