Files
shtil/docs/journal/2026-11-08-shared-1.2-ai-docs-protocol.md
TMSHandDevin a1ce4bdb8a 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>
2026-11-08 17:14:44 +03:00

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).

Проверка

Осталось

  • Обсудить протокол вдвоём, при необходимости поправить.
  • Перенести в репозиторий Gitea вместе с остальными файлами (#1.2.3).
  • Включить пароль на roadmap-server (#1.1.2): сейчас /api/progress читается без авторизации.