diff --git a/memory/ontology/RULES.md b/memory/ontology/RULES.md index 77288a1..e6d1013 100644 --- a/memory/ontology/RULES.md +++ b/memory/ontology/RULES.md @@ -25,6 +25,7 @@ - Если работа не укладывается в существующий проект, сначала создаётся новый `Project`, затем задачи внутри него. - У `Task` есть уникальный идентификатор и отдельная папка внутри папки проекта. - У `Project` есть общая документация на уровне всей папки проекта. +- Человеческое имя объекта хранится в `name` / `title`; машинный `id` остаётся внутренним и не должен быть частью читаемого названия в документации и папках. --- @@ -52,9 +53,9 @@ ### Project | Поле | Тип | Обязательно | Описание | |------|-----|-------------|----------| -| `name` | string | ✅ | Название проекта | +| `name` | string | ✅ | Человеческое название проекта | | `status` | enum | ✅ | planning, active, paused, completed, archived | -| `folder` | string | ✅ | Папка проекта: `tasks/{project}/` | +| `folder` | string | ✅ | Папка проекта: `tasks/{project-slug}/` | | `doc_path` | string | ✅ | Главный файл проекта, обычно `PROJECT.md` | | `description` | string | — | Краткое описание | | `start_date` | date | — | Дата старта | @@ -63,8 +64,8 @@ ### Task | Поле | Тип | Обязательно | Описание | |------|-----|-------------|----------| -| `title` | string | ✅ | Название задачи | -| `project` | string | ✅ | ID проекта (proj_xxx) | +| `title` | string | ✅ | Человеческое название задачи | +| `project` | string | ✅ | ID проекта | | `folder` | string | ✅ | Папка задачи внутри проекта | | `doc_path` | string | ✅ | Главный файл задачи, обычно `TASK.md` | | `assignee` | string | — | Исполнитель | @@ -184,11 +185,12 @@ tasks//TASKS/// ``` ### Правило путей -- `Project.folder` — папка проекта. +- `Project.folder` — папка проекта, всегда читаемый slug. - `Project.doc_path` — главный документ проекта. -- `Task.folder` — папка задачи внутри папки проекта. +- `Task.folder` — папка задачи внутри папки проекта, всегда читаемый slug. - `Task.doc_path` — главный документ задачи. - `Task` всегда связан с `Project` и живёт внутри его структуры. +- В именах папок и документов не использовать внутренние `id` как часть человекочитаемого названия; внутренний `id` хранится только в онтологии. --- diff --git a/tasks/ontology-management/docs/ONTLOGY-MANAGEMENT.md b/tasks/ontology-management/docs/ONTLOGY-MANAGEMENT.md index ca4cb9f..ca3a789 100644 --- a/tasks/ontology-management/docs/ONTLOGY-MANAGEMENT.md +++ b/tasks/ontology-management/docs/ONTLOGY-MANAGEMENT.md @@ -63,13 +63,19 @@ tasks// ### Task folder ```text -tasks//TASKS/// +tasks//TASKS/// ├── TASK.md ├── context.md ├── report.md └── attachments/ ``` +### Naming convention +- Human-facing names use `name` / `title`. +- Internal `id` remains stable and may be machine-oriented. +- Folder names use readable slugs, not internal ids. +- Task slugs should describe the task, not the database identifier. + ## 4. Document paths - `Project.doc_path` points to the main project document, usually `PROJECT.md`.