type: decision
layer: arch
object: standards
aspect: structure
title: "ADR-004: Плоская структура architect/standards/"
status: active
date: 2026-04-14
id: ADR-004

ADR-004: Плоская структура architect/standards/

Дата: 2026-04-14
Статус: APPROVED

Контекст

До реорганизации стандарты были вложены по тематическим папкам:

standards/
  structure/    (23 файла)
  naming/       (10 файлов)
  process/      (35 файлов)
  format/       (12 файлов)
  policy/       (14 файлов)
  ...

Итого ~380 файлов в 8+ папках. Проблемы:
- AI-агент читал всю папку не зная какие файлы нужны
- Один стандарт мог частично относиться к двум папкам
- Поиск файла требовал знания где он "должен" лежать

Решение

Все стандарты — в одной папке architect/standards/ с именованием по формуле:

arch-{object}-{aspect}.md

Примеры:

arch-document-format.md
arch-workspace-structure.md
arch-deployment-operation.md

20 файлов вместо 380. Формула имени содержит всю информацию о содержимом.

Альтернативы

Сохранить вложенные папки — отклонена: не решает проблему навигации AI.

Одна папка + теги в frontmatter (выбрано) — позволяет фильтровать по layer:, object:, aspect: без физических папок.

Именование по номеру (001-structure.md) — отклонена: непонятно содержимое без открытия файла.

Последствия

• AI-агент видит весь список стандартов одним ls без рекурсии
• Формула имени = поиск по имени файла без чтения содержимого
• Все ссылки между стандартами — простые, без ../../
• Необходима дисциплина именования — иначе список превращается в хаос