ovtube/vtube
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
981a0ad9b6ba628a098a453eb8088450163c2d5f
vtube/docs/ONBOARDING.md
goboss a10a0bb790 docs: add ONBOARDING.md — user-facing first-launch guide 
- What Claude auto-loads (CLAUDE.md, MEMORY.md, global rules)
- 7 open questions developer needs to answer (random JS, 8112 GA, test.*, 8081 status, etc.)
- Task type examples (A: site change, B: backlog item, C: audit, D: documentation)
- External services to potentially configure (Telegram, CF, monitoring)
- Common pitfalls (no make-work, no manual tmux kill, no /home/nosfortube/)
2026-04-30 21:44:56 +00:00

7.4 KiB
Raw Blame History

tubev — User Onboarding (для першого запуску claude/goboss)

Цей файл — для юзера, не для Claude. Список того, що варто знати і що дати при першому/новому запуску, щоб робота йшла продуктивно.

Що Claude вже знає auto-load (нічого не треба робити)

При старті у ~/goboss/ або ~/gocc{N}/tubev/ Claude автоматично читає:

  1. CLAUDE.md (project root) — основні правила, doc index, стек, ролі
  2. ~/.claude/CLAUDE.md (global) — Mandatory Protocol P1-P8 (research-before-guess, atomic commits, etc.)
  3. MEMORY.md (project memory index) — feedback / project / reference notes з минулих сесій

Звідти Claude дізнається:

  • Що це tubev — adult tube infrastructure, frontend-only
  • 14 сайтів у ~/backup_<port>/, OpenResty + etlua + Lua
  • 4 боти (2 RO + 2 writer) — gocc1-4
  • Repo git@gdev.hserver.cloud:ovtube/vtube.git, push policy
  • Recommendations backlog (22 items HIGH/MEDIUM/LOW)
  • Communication protocol, hooks, scripts

Це означає: при відкритті чистої сесії Claude вже орієнтований у проекті. Не треба пояснювати "що це за проект" чи "де лежать сайти".

Що НЕ автоматично, але можна одразу дати (опціонально)

Якщо хочеш швидкий старт — скажи:

  • "перечитай RECOMMENDATIONS.md" — щоб Claude нагадав які items OPEN
  • "перевір боти" — щоб переконатися що sessions живі через tmux list-sessions
  • "git status у tubev" — побачити чи нема локальних змін зайвих

Або просто скажи що хочеш зробити — Claude сам читатиме relevant docs.

Що варто дати при конкретній задачі

Тип A — зміна на конкретному сайті

"Зроби на 8112 footer кольоровим — використай той же стиль що на 8131"

Достатньо. Claude знайде:

  • 8112 у ~/backup_8112/ (з SITES.md)
  • footer у views/footer*.etlua або layout.etlua
  • 8131 для reference
  • Запропонує diff, ти схвалюєш, він пушить

Тип B — refactor / cleanup з backlog

"Зроби C1 з RECOMMENDATIONS.md" (видалити DEL_*) або "Винеси site_domain у config (M2)"

Claude знає item by ID, виконає → push → RECOMMENDATIONS.md update (move до DONE footer).

Тип C — новий audit / investigation

"Перевір 8085 submodule drift і запропонуй фікс"

Claude dispatch'не gocc1 (audit) або зробить сам, відповідно до scope.

Тип D — нова інфраструктура / документація

"Документуй як працюють banners модулі"

Claude сам прочитає, узагальнить, додасть doc + commit + push.

Що мені потрібно від тебе (open questions)

Це питання які виникли під час discovery audit (gocc1+2+3+4 на 2026-04-30) — я не можу самостійно вирішити без твоїх відповідей:

High-priority (security-related)

  1. Random-name JS файли (9qFdXQ7.js, aOKM9.js, f4T4s.js, gD0A3.js, c24c4cd9.js, popa.js, mo.js, N7Ym4F.js, qDap9.js, gk5LT.js, PxqbeCb.js, k3KL5.js)

    • Це ваші adblock-bypass payloads? Старі ad scripts? Невідомі drops?
    • На сайтах 8084, 8085, 8102, 8107, 8112, 8126, 8131
    • Поки не знаю — не можу безпечно видалити

  2. 8112 — два GA properties (G-CQN2KFSXSG + G-WW50B2EGSJ) у одному gtag

    • Який ID правильний?
    • Це баг чи навмисно (наприклад, transition між старим і новим Google account)?

Medium-priority (operational)

  1. test.<domain> зараз DNS-fail — як ти переглядаєш зміни перед deploy?

    • Інший mechanism (port-direct? VPN? feature branch deploy)?
    • Чи preview ще не налаштовано?

  2. 8081 (449KB CSS, NL agego, profile pages) — це окремий продукт чи варіант?

    • Чи потрібно колись підтягнути до решти 13?
    • Чи 8081 завжди буде окремою архітектурою?

  3. 8086 outlier color #8bc215 (зелений серед orange/red) — навмисно?

  4. Невідомі домени для 8081, 8129, 8148 — які це?

    • 8148 = canonical lab з 288 commits/30d — куди broadcast'ить?

Low-priority (clarity)

  1. Git workflow per-site backup_/ — чи всі 14 йдуть через git.tubev.sex (як 8112) чи інакше?
    • Зараз тільки 8112 має remote, решта 13 — local-only

Як давати команди / preferences

З memory я знаю:

  • Українською, коротко, по суті — без enumerated блоків / SQL evidence у чаті / file path lists
  • Боти — без make-work задач (idle = ОК)
  • Recommendations не виконувати самостійно (тільки коли скажеш "роби")
  • Push immediately after commit (default), exceptions для refactor batches

Якщо хочеш змінити preference — скажи, я збережу у memory.

Telegram / Slack / інші канали?

Поки не налаштовано. ~/.claude/hooks/telegram-notify.sh існує (Stop hook → TG ping), але я не знаю до якого боту/каналу він говорить. Якщо хочеш notifications — дай:

  • Bot token
  • Chat ID
  • Що саме нотіфікувати (push? reports? alerts?)

Інші зовнішні сервіси, до яких треба access?

  • Cloudflare (для cache purge після прод-deploy)?
  • Monitoring (Grafana / Sentry / inny)?
  • CI/CD pipeline для прод-deploy?
  • Domain registrar / DNS API (якщо треба test.* підняти)?

Якщо так — скажи деталі, я налаштую.

Що НЕ робити при старті

  • ❌ Не давай tmux kill-session руками — використовуй ~/bin/restart-bots
  • ❌ Не давай Claude make-work ("просто перевір ще раз" без конкретного тригера)
  • ❌ Не пиши задачі прямо в ~/comms/<bot>-task.md — нехай goboss формулює (інакше bot не побачить унікальний Task ID)
  • ❌ Не торкай /home/nosfortube/ — production, hooks блокують

Все ще питання?

Просто запитай у чаті. Я знаю що де лежить — або з docs, або з memory, або grepну і додам у INFRASTRUCTURE.md щоб наступного разу не шукати.

Created: 2026-04-30. Update коли з'являються нові onboarding pain points.

Reference in New Issue View Git Blame Copy Permalink