Скилл Reference

Coworker Context

Канонический справочник конвенций Datarim для внешних LLM, вызываемых через профиль делегирования coworker. Stage Header, побайтовое сохранение YAML, append-log Q&A, чек-лист ожиданий, frontmatter снапшотов, зеркалирование PRD↔архив, таксономия Diátaxis, history-agnostic gate, Верховная Директива.

Зачем

Datarim делегирует объёмное чтение и генерацию шаблонных файлов внешним LLM через CLI-инструмент coworker. Профиль datarim в конфигурации coworker инструктирует внешнюю модель о том, как себя вести при генерации архивных документов, рефлексий, PRD, планов, описаний задач и других артефактов Datarim. До появления этого скила system prompt профиля состоял из 56 слов общих фраз — он просил сохранять YAML frontmatter и зеркалить PRD success criteria, но не передавал ни одной другой конвенции фреймворка. В итоге внешние модели генерировали структурно правдоподобные документы, которые молча нарушали мандаты, невидимые оператору на этапе черновика.

Что покрывает

  • Верховная Директива — Универсальные Законы Искусственных Сущностей имеют приоритет; на конфликте — отказ с объяснением.
  • Stage Header — каждый ответ pipeline-команды оператору начинается жирным inline-заголовком с ID и полным названием задачи, до любого tool-call narration.
  • Сохранение YAML frontmatter — побайтово: не менять порядок ключей, не переквотать, не менять пробелы.
  • Append-log Q&A — фиксированный заголовок, пять обязательных полей, раунды agent-decided несут rationale ≥50 символов.
  • Чек-лист ожиданий (Option B) — wish_id slug, plain-language пожелание, фальсифицируемый success criterion, история статусов по строке на переход, текущий статус, опциональный override.
  • Frontmatter снапшота — десять обязательных скалярных полей плюс опциональный список options с CTA-пунктами.
  • Зеркало PRD ↔ архив — validation в архиве 1:1 повторяет success criteria из PRD с цитатами, как был выполнен каждый пункт.
  • Таксономия документации — закрытый набор из четырёх категорий Diátaxis: tutorials, how-to, reference, explanation.
  • History-agnostic gate — никогда не упоминать конкретный ID задачи в skills/agents/commands/templates.

Как подключается

Профиль datarim в конфигурации coworker ссылается на этот скил по имени в своём system prompt. Внешний LLM получает инструкцию прочитать его перед генерацией любого артефакта. Сам скил history-agnostic — называет только контрактные поверхности, без конкретных ID — и проходит stack-agnostic и history-agnostic gates фреймворка.

Источник

Написан во время Phase 2 расширения задачи Stage Output Prefix в мае 2026, после того как первый dogfood-стенд фреймворка вскрыл три ортогональных пробела в распространении конвенций: markdown-only enforcement Stage Header был ненадёжен без runtime-hook, snapshot writer тихо падал под zsh-parent shell, а coworker profile передавал внешнему LLM почти ни один из мандатов фреймворка.