typology-document-types.md

type: standard
aspect: typology
title: "Стандарт: Документ (Информационная система)"
version: 1.0.0
date: 2026-02-19
status: active

Стандарт: Документ (Информационная система)

Версия: 1.0.0
Тип системы: Информационная
Вопросов: 5

ОПРЕДЕЛЕНИЕ

Документ — информационная система, хранящая и передающая знания.

ПОСЛЕДОВАТЕЛЬНОСТЬ ВОПРОСОВ

ЧТО? → ЧЕМ? → КАК? → ГДЕ? → СКОЛЬКО?
  │      │      │       │        │
Содерж. Формат Структ. Путь    Объём

Опционально: ПОЧЕМУ, ЗАЧЕМ, КТО, КОГДА (контекст использования).

ОБЯЗАТЕЛЬНЫЕ ПОЛЯ

Вопрос	Поле	Описание
ЧТО?	`content`	О чём документ, содержание
ЧЕМ?	`format`	Формат (markdown, yaml, json)
КАК?	`structure`	Структура, организация
ГДЕ?	`path`	Где находится
СКОЛЬКО?	`size`	Объём (строки, разделы)

Опционально:
| Поле | Описание |
|------|----------|
| purpose | ЗАЧЕМ (назначение) |
| audience | КТО (аудитория) |
| version | КОГДА (версия, дата) |

ТИПЫ ДОКУМЕНТОВ

СТРУКТУРА ДОКУМЕНТА

Тип	Назначение	Формат имени
Стандарт	Правила	`UPPER_CASE.md`
AI-агент	Инструкции для Claude	`kebab-case.ai.md`
README	Точка входа	`README.md`
CLAUDE	Инструкции контекста	`CLAUDE.md`
Индекс	Метаданные	`index.yaml`

# НАЗВАНИЕ

**Версия:** X.Y.Z
**Формат:** markdown

---

## СЕКЦИЯ 1 (ЧТО?)
Основное содержание

## СЕКЦИЯ 2 (ЧЕМ?)
Формат представления

## СЕКЦИЯ 3 (КАК?)
Структура и организация

...

---

**Версия:** X.Y.Z

МЕТАДАННЫЕ (YAML front matter)

---
title: "Название"
type: "standard|guide|reference"

# ЧТО?
content: "Краткое описание содержания"

# ЧЕМ?
format: "markdown|yaml|json"

# КАК?
structure:
  - "Секция 1"
  - "Секция 2"

# ГДЕ?
path: "architect/standards/..."

# СКОЛЬКО?
size: "~100 строк, 5 секций"

# Опционально
purpose: "Назначение документа"
audience: ["Архитектор", "Кодер"]
version: "1.0.0"
---

УРОВНИ ДОКУМЕНТОВ

У0: ТЕОРИЯ        — theory/*.md          — LOCKED
У0: КОНЦЕПЦИЯ     — concept/*.md         — Стабильно
У1: СТАНДАРТЫ     — standards/*.md       — Редко меняется
У2: ПАТТЕРНЫ      — patterns/*.md        — По мере накопления
У3: ШАБЛОНЫ       — templates/*.md       — Готовые заготовки
У4: РЕАЛИЗАЦИЯ    — {project}/*.md       — Часто меняется

ВЕРСИОНИРОВАНИЕ

ПРИМЕРЫ

CLAUDE.md (инструкции контекста)

Изменение	Версия
Опечатки, форматирование	X.Y.Z+1 (patch)
Новая секция, уточнения	X.Y+1.0 (minor)
Изменение структуры	X+1.0.0 (major)

# НАЗВАНИЕ ПРОЕКТА

## ЧТО (content)
- Структура проекта
- Основные команды
- Правила работы

## ЧЕМ (format)
Markdown с секциями

## КАК (structure)
Иерархия: описание → структура → команды → правила

## ГДЕ (path)
$WORKSPACE/{project}/CLAUDE.md

## СКОЛЬКО (size)
~50-100 строк, 5-7 секций

Стандарт (ENTITIES.md)

# СУЩНОСТИ СИСТЕМЫ

**Версия:** 1.0.0

## ЧТО
Описание всех сущностей: Server, Hub, Project...

## ЧЕМ
Markdown + таблицы

## КАК
Группировка по типам, алфавитный порядок

## ГДЕ
architect/standards/ENTITIES.md

## СКОЛЬКО
~200 строк, 10 сущностей