Расширить OB010 развёрнутым форматом паспорта и структурой вложенности папок агента #15

New issue

Closed

opened 2026-04-17 12:09:46 +03:00 by mxustin · 0 comments

mxustin commented

2026-04-17 12:09:46 +03:00

Owner

Действующая редакция OB010-AGENT-CREATE.md фиксирует минимальный YAML-подобный шаблон passport.md и требует, чтобы папка агента называлась строго по ID (AGT-L{SS}-{HHHH}). Практика показала, что нужно изменить и расширить следующее.

Формат паспорта — перейти от YAML-блока к развёрнутому markdown-формату с обязательными разделами: «Идентификация» (в виде markdown-таблицы), «About», «Миссия», «Характер и стиль общения», «Процесс работы», «Технические атрибуты», «Коммуникация», «Рабочая среда», «История», «Ссылки». YAML-блок не используется.

Структура папки агента — допустить вложение в человекочитаемую иерархию (например, «уровень → корпорация → агент»), при условии что имя папки агента соответствует формату [AGT-L{SS}-{HHHH}] <Имя> — совмещает строгий ID в квадратных скобках и человекочитаемое имя. Пример: [AGT-LFD-00F0] Flashka/.

Папка identity/ — внутри папки агента располагается подпапка identity/ со следующими артефактами:

passport.md — паспорт агента (обязательный);
файл аватарки — имя произвольное (обязательным остаётся только поле «Аватар» в паспорте со ссылкой на файл);
README.md — описание содержимого папки identity/ для человека или другого агента (опциональный).

Имя файла аватарки — свободное. Допустимы avatar.png, agt-l{ss}-{hhhh}-ava.png и любые другие; выбор на усмотрение участника, создающего агента.

Состав изменений:

onboarding/OB010-AGENT-CREATE.md — заменён YAML-шаблон паспорта на развёрнутый markdown-формат; обновлён шаг «Зафиксировать паспорт агента»; переработана схема структуры папки агента (формат имени [AGT-L{SS}-{HHHH}] <Имя>, подпапка identity/, допустимые имена аватарки); добавлено описание опционального README.md;
onboarding/OB010-AGENT-CREATE-COMMENTS.md — добавлены рекомендации по оформлению разделов развёрнутого паспорта (стиль таблиц, секции «Характер и стиль общения» и «Процесс работы», оформление ссылок и истории); описан опциональный README.md;
RULE-MAP.md — обновлён раздел «Правила онбординга», пункт «Где хранится паспорт AI-агента?» под новую структуру папки.

После этого — при необходимости обновить упоминание OB010 в FLOW.md.

Примечание: понятие «корпорация агентов» вводится на уровне папочной иерархии как удобная группировка; формально корпорация — это агент с суб-агентами, но это отдельная тема за рамками настоящего issue.

Область применимости: только AI-агенты.

Действующая редакция `OB010-AGENT-CREATE.md` фиксирует минимальный YAML-подобный шаблон `passport.md` и требует, чтобы папка агента называлась строго по ID (`AGT-L{SS}-{HHHH}`). Практика показала, что нужно изменить и расширить следующее. **Формат паспорта** — перейти от YAML-блока к **развёрнутому markdown-формату** с обязательными разделами: «Идентификация» (в виде markdown-таблицы), «About», «Миссия», «Характер и стиль общения», «Процесс работы», «Технические атрибуты», «Коммуникация», «Рабочая среда», «История», «Ссылки». YAML-блок не используется. **Структура папки агента** — допустить вложение в человекочитаемую иерархию (например, «уровень → корпорация → агент»), при условии что **имя папки агента соответствует формату `[AGT-L{SS}-{HHHH}] <Имя>`** — совмещает строгий ID в квадратных скобках и человекочитаемое имя. Пример: `[AGT-LFD-00F0] Flashka/`. **Папка `identity/`** — внутри папки агента располагается подпапка `identity/` со следующими артефактами: - `passport.md` — паспорт агента (обязательный); - файл аватарки — имя произвольное (обязательным остаётся только поле «Аватар» в паспорте со ссылкой на файл); - `README.md` — описание содержимого папки `identity/` для человека или другого агента (опциональный). **Имя файла аватарки** — свободное. Допустимы `avatar.png`, `agt-l{ss}-{hhhh}-ava.png` и любые другие; выбор на усмотрение участника, создающего агента. Состав изменений: - [x] `onboarding/OB010-AGENT-CREATE.md` — заменён YAML-шаблон паспорта на развёрнутый markdown-формат; обновлён шаг «Зафиксировать паспорт агента»; переработана схема структуры папки агента (формат имени `[AGT-L{SS}-{HHHH}] <Имя>`, подпапка `identity/`, допустимые имена аватарки); добавлено описание опционального `README.md`; - [x] `onboarding/OB010-AGENT-CREATE-COMMENTS.md` — добавлены рекомендации по оформлению разделов развёрнутого паспорта (стиль таблиц, секции «Характер и стиль общения» и «Процесс работы», оформление ссылок и истории); описан опциональный `README.md`; - [x] `RULE-MAP.md` — обновлён раздел «Правила онбординга», пункт «Где хранится паспорт AI-агента?» под новую структуру папки. После этого — при необходимости обновить упоминание OB010 в `FLOW.md`. Примечание: понятие «корпорация агентов» вводится на уровне папочной иерархии как удобная группировка; формально корпорация — это агент с суб-агентами, но это отдельная тема за рамками настоящего issue. Область применимости: только AI-агенты.