Протокол работы 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>
2.3 KiB
2.3 KiB
date, zone, task, items, branch, pr, impact, status, author
| date | zone | task | items | branch | pr | impact | status | author |
|---|---|---|---|---|---|---|---|---|
| 2026-11-08 | shared | 1.2 | chore/1.2-ai-docs-protocol | — | shared | в работе | Frontend |
[1.2] Система документирования для AI-ассистентов
Сделано
- Протокол работы AI:
docs/ai/PROTOCOL.md— источники истины, зоны frontend/backend/shared, чек-листы начала и конца сессии. - Сверка с дорожной картой:
docs/ai/roadmap.mdи скриптtools/roadmap-context/roadmap-context.mjs(Node 18+, без зависимостей, только чтение). - Шаблоны:
docs/ai/templates/— запись журнала, ADR, описание модуля. - Снимки состояния:
docs/status/shared.md,frontend.md,backend.md. - Индексы зон:
docs/frontend/README.md,docs/backend/README.md; карта документацииdocs/README.md. AGENTS.md: раздел 9 «Документирование и контекст».
Решения
- Дорожная карта остаётся единственным трекером; AI её только читает и готовит текст для людей.
- Память проекта для AI —
docs/status(снимок) +docs/journal(история по PR), документация коммитится в той же ветке, что и код. - Внутренние документы зоны в
docs/frontendиdocs/backend; ассистент другой зоны их не читает без необходимости.
Для другой стороны
- Backend: прочитать
docs/ai/PROTOCOL.md, добавить личный блок правил сзона: backend(раздел 8).
Проверка
node tools/roadmap-context/roadmap-context.mjsи... 1.2против https://locshare.ru/roadmap/ — сводка выводится.
Осталось
- Обсудить протокол вдвоём, при необходимости поправить.
- Перенести в репозиторий Gitea вместе с остальными файлами (#1.2.3).
- Включить пароль на roadmap-server (#1.1.2): сейчас
/api/progressчитается без авторизации.