# Portability: UNIVERSAL
# Last validated: 2026-05-17
# Next review: 2027-05-17

РУКОВОДСТВО - Стандарты документации
=====================================

Статус: 2026-02-08

ТРЕХУРОВНЕВАЯ СИСТЕМА
-------------------
1. РАБОТАЮЩИЙ (docs/help/*.txt)
   - КАК мне использовать БАХ?
   - Фокус: команды CLI, руководства, ссылки.
   - Формат: TXT (совместимый с ASCII, макс. 250 строк).

2. ЗНАНИЯ (wiki/*.txt)
   - ЧТО такое Х?
   - Фокус: базовые знания, знания предметной области, теория искусственного интеллекта.
   - Формат: TXT (совместимый с ASCII).

3. КОНЦЕПТУАЛЬНЫЕ (skills/**/*.md, docs/*.md)
   - ПОЧЕМУ И КАК это построено?
   - Фокус: архитектура, рабочие процессы, более глубокий анализ.
   - Формат: MarkDown (богато иллюстрированный/структурированный).

МЕТАДАННЫЕ ОБЯЗАТЕЛЬНЫ (НОВОЕ 2026-01)
-------------------------------
Каждый файл документации ДОЛЖЕН иметь следующий заголовок:

  # Портативность: УНИВЕРСАЛЬНАЯ | СИСТЕМА | ПОЛЬЗОВАТЕЛЬ
  # Последняя проверка: ГГГГ-ММ-ДД
  # Следующий тест: ГГГГ-ММ-ДД
  # Источники: [Необязательно]

Интервалы проверки:
  СИСТЕМА: +3 месяца (с привязкой к коду, часто меняется)
  УНИВЕРСАЛЬНЫЙ: +6 месяцев (обычно действителен, стабилен)
  ПОЛЬЗОВАТЕЛЬ: +12 месяцев (зависит от пользователя, длительный срок действия)

СТРУКТУРА TX/TXT (классическая)
---------------------------
  НАЗВАНИЕ ЗАГЛАВНЫМИ БУКВАМИ
  =======================
  [заголовок метаданных]

  ОПИСАНИЕ
  [Что делает эта функция]

  КОМАНДЫ
  bach [befehl] [argumente]

  ПРИМЕРЫ
  [Конкретные варианты использования]

  СМОТРИТЕ ТАКЖЕ
  [Ссылки на другие документы/справку/или вики/файлы]

АНАЛИЗ ЖИЗНЕННОГО ЦИКЛА
---------------------
1. СОЗДАНИЕ: пользователь/ANALYSE_Thema.md
2. ОЦЕНКА: Результаты → docs/help/ ИЛИ wiki/. Задачи → Система задач.
3. АРХИВИРОВАНИЕ: после завершения перейдите в папку user/_archive/.

УСЛОВИЯ ИМЕНОВАНИЯ
------------------
docs/help/<topic>.txt Простая тема
docs/help/<command>.txt Документация по командам CLI
wiki/<special>.txt Внешние знания

SKILL_<n>.md Документация по навыкам
CONCEPT_<n>.md концептуальный документ
<n>_ANALYSE.md Аналитический отчет
<Тема>_Proposal.md Предложения (ожидают одобрения)

КРИТЕРИИ КАЧЕСТВА
-------------------
docs/help/*.txt Файлы:
- Макс. 250 строк (рекомендуется до 150)
- Нет синтаксиса Markdown (совместим с ASCII)
- Все команды задокументированы
- Минимум 1 пример
- СМОТРИТЕ ТАКЖЕ Справочник

СМОТРИТЕ ТАКЖЕ
----------
user/_archive/Guidelines_Proposition.md Полная концепция (в архиве)
bach --help practices                    Принципы архитектуры
bach --help naming                       Соглашения об именах
