docs: документация переведена на канон av-dev-pm
- беклог и план переехали в docs/tasks (38 задач, 11 целей), слаги переименованы с транслита на английские, 85 ссылок поправлены - conventions.md разобран в docs/conventions/, local-research.md — в docs/research/, review-journal.md — в docs/review.md с разделом настройки конвейера; заведены security.md, adr/ и .pm.json - шаг docs.py check добавлен в task gate; поведение в architecture.md помечено девятью маркерами долга, database.md получил настройки с числовым значением
This commit is contained in:
@@ -23,17 +23,15 @@ context: |
|
||||
русифицируем — они несут точную нормативную/структурную семантику.
|
||||
|
||||
Ревью (процесс, не артефакт):
|
||||
- Нетривиальная/архитектурная задача — два чекпоинта: ревью дизайна (после
|
||||
design/specs, ДО кода — дешевле чинить направление) и ревью кода (после
|
||||
apply, до archive).
|
||||
- Тривиальная задача — достаточно одного прохода (код).
|
||||
- Правило выбора профиля и состав проходов здесь не пересказываем: их дом —
|
||||
скилл av-dev-pipeline:review-pipeline, проектная настройка — docs/review.md.
|
||||
|
||||
Конвенции кода (соблюдать при apply):
|
||||
- Механизируемое проверяет `task gate` (линтер, сборка, тесты, race,
|
||||
покрытие изменённых строк, миграции, образцы конфига, секреты и данные о
|
||||
здоровье в индексе). Состав шагов и правил здесь не пересказываем — он
|
||||
растёт, а гейт скажет точнее и всегда актуальнее.
|
||||
- Прозой остаётся то, что правилом не выражается: docs/conventions.md.
|
||||
- Прозой остаётся то, что правилом не выражается: docs/conventions/README.md.
|
||||
Читаем в источнике, а не отсюда — конвенции дописываются по ходу задач.
|
||||
- Безопасность: данные о здоровье чувствительнее токенов. Ни тела запросов,
|
||||
ни значения точек не попадают в логи выше DEBUG; ничего из ./data не
|
||||
@@ -48,10 +46,11 @@ context: |
|
||||
- Развилка или блокер — сперва prior art. Проект не уникален: готовые решения
|
||||
смотрим в референсах паспорта, отвергаем — с названной причиной, и причина
|
||||
идёт в architecture.md.
|
||||
- Инварианты целиком — в CLAUDE.md, архитектура — в docs/architecture.md.
|
||||
- Инварианты целиком — в CLAUDE.md, архитектура — в docs/architecture.md,
|
||||
периметр и модель угроз — в docs/security.md, схема — в docs/database.md.
|
||||
|
||||
Разведка уже проведена, догадки о формате не нужны:
|
||||
- docs/local-research.md — находки на живом потоке, во многом расходящиеся с
|
||||
- docs/research/apple-health.md — находки на живом потоке, во многом расходящиеся с
|
||||
документацией Health Auto Export. ПРОВЕРЬ ТАМ, прежде чем строить
|
||||
предположение о формате входа: скорее всего вопрос закрыт измерением.
|
||||
- Тесты на разбор формата держим на реальных пакетах (testdata), а не на
|
||||
|
||||
Reference in New Issue
Block a user