RU The Card

Карточка

Wiki · см. также: Доверие · Словарь · полные правила: правила знаний

Карточка — один Markdown-файл в AuroraKnowledgeDB/, в котором лежит знание об одной сущности: понятии, процессе, системе, роли, статусе, требовании. Это не пересказ документа: пять документов об одном предмете питают одну карточку, а побочное объяснение внутри карточки выносится в свою карточку и остаётся ссылкой.

Устройство

---
title: "Возврат"
aliases: ["Возврат платежа"]
type: concept
status: draft
kind: knowledge
sources:
  - "Sources/Confluence/Платежи/Возврат.md"
built: machine
created: 2026-09-01
updated: 2026-09-01
related: ["Платёж", "Опротестование платежа"]
---

Возврат отдаёт деньги плательщику в течение десяти дней после заявки. …   ← тезис, пишет модель

## Источник (перенесено дословно)

…исходный текст, перенесённый скриптом, не пересказанный…

## История изменений

- 2026-09-01: карточка заведена

Часть	Смысл
`title`, `aliases`	Название и другие имена, которые ведут к карточке; ссылки используют имя файла
`type`	Вид сущности, привязан к папке раздела: `Concepts` → `concept`, `Processes` → `process`, `Glossary` → `glossary`, `Systems` → `system`, `Roles` → `role`, `Statuses` → `status-model`, `Reference` → `reference`, `Requirements` → `requirement`, `Specs` → `spec`, `Decisions` → `decision`, `Questions` → `question`
`status`	Класс доверия — см. ниже. Считает движок, человек не пишет
`kind`	Кому можно трогать тело — см. ниже
`sources`	Откуда знание пришло (путь в зеркале или файл в `Raw/`)
`built: machine`	Метка движка. Её отсутствие значит «происхождение неизвестно», а не «написал человек»
`related`, `[[ссылки]]`	Связи карточки: карточка без связей — ошибка линтера
тезис + «Источник» + история	Тезис — короткое утверждение; под ним дословный источник; хвост «История изменений» не перезаписывается

Шапку читает один разбор (aurora_common.frontmatter): список можно писать в строку (aliases: ["А", "Б"]) или блоком (aliases: и пункты - "А" ниже) — граф, поиск, эмбеддинги и карты содержания видят обе записи одинаково. Пустая строка и комментарий # … внутри блока его не закрывают. Тело карточки начинается после закрывающей строки ---; тройной дефис внутри значения (title: "Ретро --- итоги") шапку не обрывает.

Три вида — вид (`kind`) решает, кто правит тело

`kind`	Что это	Кто пишет тело
`dictionary`	Справочный список, перенесён целиком	никто не пересказывает; модель даёт только имя и суть
`document`	Дословный текст документа	переносит скрипт; не переписывается никогда
`knowledge`	Сущность, которую поняла модель	модель пишет тезис, под ним дословный источник, Момус проверяет тезис

Вид сильнее статуса: доверенный словарь всё равно нельзя пересказывать.

Тип, шаблон и поле `template:`

Тип (type) — это о чём карточка и по какому шаблону она составлена; вид (kind) отвечает на другой вопрос — «кому править тело». У каждого типа есть шаблон — файл TemplatesCommon/akdb_<тип>_v1.0.md: паспорт типа (название, раздел базы, допустимые виды и статусы, разделы тела), скелет шапки и тела, пример и чек-лист. Его читают человек, ассистент и сам движок. Типов тринадцать:

Класс	Типы
сущность	`concept`, `glossary`, `process`, `system`, `role`, `status-model`, `requirement`
дословный носитель	`reference`, `cited-document`
запись	`decision`, `question`, `correction`
карта	`moc`

Сомневаетесь, какой тип выбрать, — берите concept; границы соседних типов разобраны в самих шаблонах. Поле template: в шапке называет файл, по которому составлена карточка (template: akdb_concept_v1.0.md); у прежних карточек его нет — это «до-шаблонная» карточка, а не ошибка. Список типов и разделов — kb:cards --list, проверка — kb:cards --check (и раздел «шаблоны карточек» в kb:lint). Пока проверка только советует: ничего не переписывает и не запрещает. Выпущенный шаблон не правят — исправление выходит новой версией (v1.1).

Правила проекта. Тип выбирают по инструкции «Как определить тип карточки» — файлу Prompts/KB_classify.md: шаги 0–7, ответ одной строкой type: …; template: …; section: …; why: …. Файл принадлежит проекту: правка остаётся, новая версия кита ложится рядом как .new; текст печатает kb:cards --guide. Подпись, описание и выключатель типа — блок cards: в aurora.config.yaml. Выключатель пока только советует: проверка называет карточки выключенного типа, классификатор такой тип отклоняет, а создание карточек его не учитывает. Каталог типов AuroraKnowledgeDB/meta/card_types.md генерируется (установка, update --apply, kb:cards --write --apply), ручные правки в нём теряются. Всё это правится в «Настройки проекта → Типы карточек». Подробно — шаблоны карточек.

Пять статусов

`status`	Смысл
`knowledge`	Факт: все связанные задачи Jira в доверенных статусах либо источник — подписанный документ в `Raw/`
`draft`	Пока не подтверждено — попадает в контекст только с громким заголовком и названной причиной
`placeholder`	Заготовка: ссылка называет понятие, а знания ещё нет; исключена из поиска и контекста
`index`	Служебные карточки: карты содержания и таблицы
`deprecated`	Заменена; хранится для истории в `_archive/`

stateDiagram-v2
  [*] --> draft: разобрана
  [*] --> placeholder: ссылка есть, карточки нет
  placeholder --> draft: появилось определение
  draft --> knowledge: kb#58;trust — источники доверены
  knowledge --> draft: задача вернулась в работу
  knowledge --> deprecated: kb#58;supersede
  draft --> deprecated: kb#58;supersede

Что стоит помнить

Карточка — сущность. Нашли две карточки об одном — kb:twins / agent:twins сведут их: решает модель, не человек.
Связи обязательны. Карточка, до которой нельзя дойти, лежит на диске, но не в базе (kb:links --cards, kb:moc).
Движок не переписывает то, что не писал. Тела словарей и документов, хвост истории и прежний тезис сохраняются.
Имена файлов должны проходить на Windows, macOS и Linux — без < > : " / \ | ? *, не CON/NUL, до 255 байт. Проверка — kit:doctor, починка — kb:names. → Windows и macOS