docs: establish workspace engineering conventions #9

2026-09-15T05:43:32+03:00

codex-bot commented

2026-09-15 05:43:32 +03:00

AI-инструкции дублировали общие решения между репозиториями и не задавали Test Intent, code-health review и migration baseline. Добавлены общие Git/dependency/code-health/testing conventions, карта deterministic guardrails и компактный workspace router.

Root tracking допускает только семь конкретных Markdown-файлов .ai; существующий тест проверяет также исключение приватных файлов внутри новых каталогов. Semantic audit содержит 7 findings (P0: 0, P1: 4, P2: 3) и план vertical slices. Production-код и зависимости не изменены.

Проверка:

python3 test-workspace-tracking.py — PASS.
Установленный docs markdownlint-cli2 + relative-links: 27 файлов conventions/routing/README, 0 ошибок.
docs npm run verify: 42 Markdown, 0 ошибок.
frontend deps и deps:storybook — PASS.
Actual ValidationPipe → HttpExceptionFilter: подтверждена потеря field details, errors=[]; исправление оставлено отдельной migration.
git diff --check и проверка scope изменений — PASS.

Проверки выполнены на согласованном workspace веток codex/engineering-conventions в main/frontend/backend. Application builds/coverage/e2e полностью не запускались для Markdown-only scope. Связанные frontend/backend PR должны поставляться вместе с общими conventions; слияние не выполняется этим изменением.

Связанные PR: frontend #14, backend #18.

Локальная структура frontend/backend: один .ai/architecture.md с устройством и правилами архитектуры; conventions без repo-префиксов; AGENTS объединяет routing и карту источников. CONVENTIONS.md и SOURCES.md удалены, активные ссылки обновлены. Findings audit сохранены.

AI-инструкции дублировали общие решения между репозиториями и не задавали Test Intent, code-health review и migration baseline. Добавлены общие Git/dependency/code-health/testing conventions, карта deterministic guardrails и компактный workspace router. Root tracking допускает только семь конкретных Markdown-файлов .ai; существующий тест проверяет также исключение приватных файлов внутри новых каталогов. Semantic audit содержит 7 findings (P0: 0, P1: 4, P2: 3) и план vertical slices. Production-код и зависимости не изменены. Проверка: - python3 test-workspace-tracking.py — PASS. - Установленный docs markdownlint-cli2 + relative-links: 27 файлов conventions/routing/README, 0 ошибок. - docs npm run verify: 42 Markdown, 0 ошибок. - frontend deps и deps:storybook — PASS. - Actual ValidationPipe → HttpExceptionFilter: подтверждена потеря field details, errors=[]; исправление оставлено отдельной migration. - git diff --check и проверка scope изменений — PASS. Проверки выполнены на согласованном workspace веток codex/engineering-conventions в main/frontend/backend. Application builds/coverage/e2e полностью не запускались для Markdown-only scope. Связанные frontend/backend PR должны поставляться вместе с общими conventions; слияние не выполняется этим изменением. Связанные PR: [frontend #14](https://git.personal.ksv741.ru/WealthLedger/frontend/pulls/14), [backend #18](https://git.personal.ksv741.ru/WealthLedger/backend/pulls/18). Локальная структура frontend/backend: один .ai/architecture.md с устройством и правилами архитектуры; conventions без repo-префиксов; AGENTS объединяет routing и карту источников. CONVENTIONS.md и SOURCES.md удалены, активные ссылки обновлены. Findings audit сохранены.

codex-bot added 1 commit 2026-09-15 05:43:32 +03:00

docs: establish workspace engineering conventions

Workspace security / security (push) Successful in 7s

Details

Workspace verify / verify (push) Successful in 20s

Details

Workspace security / security (pull_request) Successful in 6s

Details

Workspace verify / verify (pull_request) Successful in 20s

Details

Conventional commits / commits (pull_request) Successful in 10s

Details