architect/projects/naming-standard/PROJECT.md

type: system-project
domain: standards
name: naming-standard
status: active
phase: 2
created: 2026-02-19
updated: 2026-03-26
template: BASE

naming-standard — Единый стандарт именования

Единый стандарт именования файлов, папок, переменных и БД для всей платформы.

Текущая версия: v1.0.0 (в architect/standards/6-naming/)
Целевая версия: v2.0.0

Проблема

v1.0.0 покрывает только документы платформы (aspect-object-detail.md).
Не покрыты:
- Новые роли файлов (.tpl, .data, .spec, .cache, .task)
- Типология документов (методологическая, проектная, операционная...)
- Форматы и когда что применять
- Именование папок
- Форматы хранения данных (SQLite, CSV)
- Extended Markdown (Obsidian-style links)

Архитектурные решения

Формула файла (v2.0.0)

[aspect]-[object]-[detail].[role].[format]

Два контекста именования

СТАНДАРТЫ (architect/):
  aspect-object-detail.md         ← самодостаточны, уникальны

ПРОЕКТЫ (projects/):
  NAME[.role].format              ← контекст = папка (как package.json)
  PROJECT.md, PROJECT.tpl.md      ← предсказуемые имена

Типология документов (9 типов)

Методологическая → .md (LOCKED, редко меняется)
Нормативная      → .md (стандарты и правила)
Прескриптивная   → .tpl.md (шаблоны)
Концептуальная   → .md (видение, цели)
Проектная        → .md (архитектура, ERD, API)
Контекстная      → .md (CLAUDE.md, AI.md — короткие)
Рабочая          → .spec.yaml (ТЗ на блоки)
Операционная     → .yaml (состояние, кэш — машина пишет)
Отчётная         → .md (результаты)

Форматы данных

Человек читает   → .md
Машина парсит    → .yaml / .json / .csv
Таблица/каталог  → .csv
БД с запросами   → SQLite (.db)
Обмен данными    → CSV

Extended Markdown

Наш MD = стандартный MD +
- Frontmatter (YAML между ---)
- Wikilinks [[документ]]
- Направленные ссылки → [[...]]
- Теги #тег

Карта документов

Документ Что изменить Статус
6-naming/naming-files.md Обновить до v2.0.0 ⏳
5-format/format-data.md Добавить SQLite + CSV стандарт —
5-format/format-markdown.md Описать Extended Markdown —

Роадмап

Фаза 1 — v1.0.0 ✅ (2026-02-19)

Фаза 2 — v2.0.0 ⏳ (2026-03-26)

Фаза 3 — v3.0.0 (будущее)

Связанные проекты