marketing harness · live build

Папка маркетинга и инструмент для работы с ней: контекст, роли, скиллы и проверки. Демо и быстрый старт описаны ниже.

Текущие программы AI Mindset · База знаний и практик

Маркетинг-харнесс маркетинг-спринта AI Mindset (n25). Папка, в которой живёт маркетинг продукта: контекст, правила, роли, скиллы, гейты, evals и агенты в одном git. Инструмент рядом рисует эту папку живым графом: как она растёт из пустой за 10 фаз, какие агенты в ней работают и что они закоммитили.

Быстрый старт:

gh repo clone ai-mindset-org/marketing-harness ~/harness-engine
~/harness-engine/bin/new.sh ~/harness/my-product b2b-consultant   # своя папка из набора
~/harness-engine/bin/open.sh ~/harness/my-product                 # граф с консолью агентов

Маркетинг-харнесс спринта AI Mindset (n25). Вырос из инструмента aim-sim-office (соседняя папка в рабочем пространстве Алекса, в этот репозиторий не входит). Два слоя:

• набор (kit/) – сам харнесс: папка с контекстом, правилами, ролями, инструментами, скиллами, evals, дизайн-системой, рутинами, сырьём и результатом. 138 файлов, имена по конвенции {тип} имя;
• инструмент (web/, tools/, bin/) – разворачивает набор в пустую папку по таймлайну и рисует граф папки вживую; консоль отдаёт задачи агентам внутри папки.

как добавить своё

Команда AI Mindset и ведущие воркшопа пишут прямо в main, участники присылают pull request.

1. gh repo clone ai-mindset-org/marketing-harness ~/harness-engine (уже есть – git -C ~/harness-engine pull);
2. файл кладётся в kit/files/<ветка>/ с именем {тип} имя.md: правило – rules/, скилл – skills/, дизайн – design/, кейс – guides/. Это та папка, которую получают участники;
3. node tools/build-scenario.mjs – файл попадает в Demo, ⌘K и архив набора;
4. git add -A && git commit -m "…" && git push;
5. bin/deploy-site.sh – гид и Demo на открытой копии и на внутреннем показе обновятся за минуту (нужен клон ai-mindset-org/lab-sites).

Открытый гид и Demo: https://marketing-harness.lab.aimindset.org/ (Guide – guide.html, About – access.html, набор архивом – marketing-harness-kit.zip). Внутренний показ команды с режимом Team: https://content.aimindset.org/marketing-harness/. Харнесс собран для маркетинг-спринта AI Mindset: https://marketing.aimindset.org/. Режимы в шапке: Demo · Local · Team, страницы: Guide (guide.html: запуск, Local, сессии агентов, откат и форк, таймлайн блоков, ресёрч, гейты, кейсы) и About (access.html: что это, инструменты, ключи, проверки, готовность этого компьютера). В Demo: ?at=end – сразу финал, ?speed=4 – быстрее, ?phase=p05 – с фазы, ?stops=0 – без остановок.

Отдельная страница «Шаблон дизайн-системы» сохраняет структуру AIM material system с пустыми значениями бренда. Реестр для заполнения: template-values.json. Страница лежит в web/, поэтому входит в обычную выкладку сайта. Workflow GitHub Pages публикует тот же статический каталог по адресу https://ai-mindset-org.github.io/marketing-harness/design-system-template/ после включения источника GitHub Actions в настройках Pages. Карта переноса находится в docs/design-system-template-transfer.md.

Отдельно от сайта и сценария спринта лежит микрохарнесс для студентов: учебные схемы лид → бот, общего родительского блока и дочерних страниц, редактируемых страниц и QA-дашборда. В нём есть синтетические данные, запускаемые локально примеры и карта источников и ограничений. Эта папка не входит автоматически в kit/, Demo или архив набора.

команды

Рабочая папка спринта: ~/harness/marketing-sprint (ai-mindset-org/marketing-harness-sprint). Открывается в Obsidian как vault.

три режима

• Demo – index.html: сборка по web/scenario.json, карточки фаз, клик по фазе внизу возвращает к её карточке;
• Local – локальное хранение: bin/open.sh <папка> → ?mode=live, папка этого компьютера через локальный сервер: правка, роли агентов, сессии, откат, форк, история файла, Obsidian; на сайте та же вкладка открывает папку в браузере (без агентов); пробел замораживает картинку;
• Team – ?mode=team: рабочая папка спринта из git (ai-mindset-org/marketing-harness-sprint), статичный team/state.json, опрос раз в 20 с, без консоли и правки. Публикация: bin/publish-team.sh [папка] [клон lab-sites] – экспорт через tools/export-state.mjs, push в lab-sites только при новом HEAD папки. На сервере это делает таймер marketing-harness-team-publish на VM105 (раз в 5 минут, запись в реестре team-ai-infrastructure, ранбук worldstream/docs/runbooks/2026-09-29-marketing-harness-team-publish.md).

ключи не уходят из процесса

tools/folder-state.mjs читает папку одинаково для сервера и экспорта и маскирует всё, что похоже на ключ (sk-, ghp_, github_pat_, токены ботов Telegram, Google, Apify, Krisp, Bearer, api_key=…, exaApiKey=…) в содержимом файлов, журналах агентов и раздаче /f/. Плейсхолдеры ${ИМЯ} остаются. Скрытые файлы папки (.env и другие) сервер не отдаёт, кроме .mcp.json, .githooks/, .claude/settings.json.

выкладка во внутренний контур

node tools/build-scenario.mjs
rsync -a --delete --exclude marketing-harness-kit.zip --exclude team/ web/ ~/repos/lab-sites/internal-sites/marketing-harness/
git archive --prefix=marketing-harness-sim/ -o ~/repos/lab-sites/internal-sites/marketing-harness/marketing-harness-kit.zip HEAD
cd ~/repos/lab-sites && gitleaks detect --no-git --source internal-sites/marketing-harness && git add internal-sites/marketing-harness && git commit -m "…" && git push
bin/publish-team.sh ~/harness/marketing-sprint    # командный вид

остановки

После каждой фазы – карточка человеческим языком: что появилось в папке, зачем это, какие файлы (клик открывает файл). Тексты – поле stop у фазы в kit/manifest.json. В демо остановки включены по умолчанию; в живой сборке – флаг --stops: раннер ждёт, пока в браузере нажмут «продолжить» (POST /api/continue пишет .harness/continue).

живая папка: правка и открытие

• сервер перечитывает папку каждые 0,7 с, граф и дерево меняются от любой правки: Obsidian, редактор, агент;
• панель файла: «вид» (markdown отрисован, ссылки кликаются), «исходник», «править» – текст слева, живое превью справа, ⌘S сохраняет и коммитит edit(human): <файл>;
• «Obsidian» открывает файл в хранилище; если папка ещё не хранилище, при закрытом Obsidian сервер регистрирует её сам, при открытом – показывает менеджер хранилищ и кладёт путь в буфер. «приложение» – open в программе по умолчанию, «Finder» – open -R; «папка в Obsidian» в шапке – вся папка;
• клик по слою легенды прячет слой со связями.

агенты, сессии, откат (только Local с сервером)

Панель «05 · агенты»: шесть ролей (загрузчик, исследователь, экстрактор, автор, дизайнер, критик), ▶ запускает роль с готовой задачей по её скиллу, ✎ кладёт задачу в консоль. Вкладка «консоль»: исполнитель, модель, задача, пресеты. Сервер слушает только 127.0.0.1, отвечает только на Host localhost/127.0.0.1 (защита от DNS rebinding), запись требует заголовка с токеном сессии.

• claude – claude -p --output-format stream-json в папке, только настройки и MCP папки (--setting-sources project,local --strict-mcp-config), модель по умолчанию opus (выбор opus · sonnet · haiku), MCP только тех серверов, чьи ключи заданы в окружении;
• codex – codex exec --json -s workspace-write в папке (с 0.156 флага --full-auto нет);
• сотник – Codex на сервере команды (ssh-алиас в HARNESS_SERVER_HOST): папка уезжает в ~/harness/<имя> (rsync вместе с .git, чтобы агент видел историю; назад .git не возвращается), codex exec работает там, изменения возвращаются каждые 4 секунды, граф растёт вживую;
• сессия: шаги (прочитал, записал, команда, ошибка) и токены приходят вживую, клик по запуску открывает её в боковой панели; журнал и метаданные – .harness/runs/<id>.log|json, после запуска – конспект sessions/{session} <исполнитель> <скилл> <время> – <дата>.md (ключи замаскированы, файлы ссылками, слой графа ▷);
• каждый успешный запуск заканчивается одним коммитом agent(<исполнитель>): <роль · скилл> ровно с файлами этого запуска и конспектом; упал или остановлен – коммит только конспекта session(…); гейт остановил коммит – сессия и панель это пишут;
• откат: клик по коммиту → карточка (файлы, изменения) → «откатить» (git revert, подтверждение в карточке); у сессии – «откатить запуск»; у файла – «история» → версия → «вернуть эту версию» (коммит restore(human));
• форк: «форк» в строке папки или «форк с этого коммита» → bin/fork.sh (клон с историей, source – исходная папка, Obsidian-настройки едут следом).

Вкладка «инструменты» показывает, какие ключи заданы (значения не отдаются), CLI, доступность сервера и LMS API.

устройство

kit/
  answers.json · answers/*.json   анкета по умолчанию и пресеты трёх архетипов когорты
  manifest.json                    10 фаз, 6 дорожек агентов, пояснение к шагу
  files/                           харнесс: AGENTS.md · CLAUDE.md · context/ · rules/ · tools/ (+ mcp/lms.mjs)
                                   skills/ · evals/ · design/ · guides/ · bin/ (check, render, sync-skills)
                                   sources/ · research/ · nuclei/ · outputs/ · dashboards/
  versions/                        промежуточные версии: до нейминга, до правки li-02, отчёт проверок v1
tools/
  timeline.mjs        manifest → один таймлайн (переименование, параллельные дорожки)
  build-scenario.mjs  рендер и проверки набора → web/scenario.json
  harness-server.mjs  статика, /api/state, /api/tools, /api/agent, /api/runs/:id, /api/commit/:hash, /api/history, /api/revert, /api/restore, /api/fork, /api/file, /api/open, /api/continue, /f/<файл папки>
  update-folder.mjs   обновить развёрнутую папку до текущего набора, не трогая правленое
  harness-demo.mjs    раннер: пустая папка → фазы → git; --agents, --preset, --pace 0
web/                  инструмент: index.html · app.js · styles.css · vendor/d3 · scenario.json
                      страницы: guide.html · access.html · doc.css · doc.js · kit-docs.json (из набора при сборке)
bin/                  demo.sh · new.sh · open.sh · fork.sh · replay.sh · stop.sh · publish-team.sh

Правка набора: файл в kit/files/ или шаг в kit/manifest.json → node tools/build-scenario.mjs.

фазы

00 пустая папка · 01 анкета → контекст · 02 правила и принципы · 03 нейминг (файлы переименовываются, ссылки правятся) · 04 инструменты · 05 скиллы и правила спикеров · 06 evals · 07 дизайн-система · 08 агенты параллельно (загрузчик из LMS, исследователь, экстрактор, автор, дизайнер, критик) · 09 срез и петля.

слои графа

◆ хаб · ■ контекст · ◇ правило · ⬡ роль · △ инструмент · × код · ✳ гайд · ○ скилл · ▲ eval · ☆ дизайн · ● агент · □ сырьё · Y ресёрч · • нуклеус · ▢ черновик · ✚ срез · ⧗ рутина · ⊓ гейт · ▷ сессия · пунктир – файл, которого ещё нет. Клик по легенде скрывает слой.

требования

node ≥ 18, git. Для агентов – Claude Code CLI, Codex CLI; для Сотника – SSH-ключ к серверу команды и export HARNESS_SERVER_HOST=<алиас>. Ключи сервисов – только в окружении.