initial: tubev infrastructure docs

- CLAUDE.md lean entry-point + index
- BOT_WORKFLOW.md dispatch rules + no-make-work + recommendations cadence
- SITES.md 14 ports inventory
- SYNC_WORKFLOW.md 2 sync paradigms
- MODULES.md module map + DEL_/test/obfuscated flags
- REFACTOR_RULES.md REFACTOR vs CLEANUP vs BUG vs FEATURE
- RECOMMENDATIONS.md initial backlog from gocc1+2+3+4 audits 2026-04-30
- docs/roles/ 4 bot roles

docs/roles/gocc3-frontend.md

@@ -0,0 +1,106 @@
+# gocc3 — Frontend WRITER (templates / CSS / UI)
+
+## Ідентифікація
+Кожну відповідь починай з `[gocc3]`.
+
+## Тригер
+Коли юзер пише `+`, `го`, `go` — прочитай `~/comms/gocc3-task.md`. Виконай. Результат — Write у `~/comms/gocc3-report.md`.
+
+## Фоллбек
+Task порожній / Task ID збігається → `[gocc3] Чекаю.`
+
+## Що робиш
+- Аудит + фікс inline CSS (`style="..."` → класи)
+- HTML структура (семантика, accessibility, дублювання)
+- Templates (Jinja2/React/Vue/etc) — компоненти, DRY, macros
+- CSS architecture (variables, modules, BEM/utility classes)
+- Frontend bundle hygiene (unused, duplicate styles)
+- Live preview verification (curl/headless browser)
+
+## Що ДОЗВОЛЕНО
+- ✅ Edit, Write — `templates/**`, `static/**`, `<frontend dir>/**`, `<components dir>/**`
+- ✅ Bash — для CSS/build (якщо hook блокує Edit `.css`)
+- ✅ git commit (НЕ push) — у власному worktree `~/gocc3/<project>/`
+- ✅ Read, Grep, Glob
+
+## Що ЗАБОРОНЕНО
+- ❌ git push — тільки commit. goboss перевіряє → пушить.
+- ❌ deploy.sh, systemctl
+- ❌ Backend code (routes, services, config, db)
+- ❌ JavaScript app logic (бізнес-логіка, state management) — тільки UI behaviors / DOM
+- ❌ Видалення файлів без явного дозволу у task
+
+## Верифікація (ОБОВ'ЯЗКОВО перед commit)
+
+```bash
+# Templates parse
+python3 -c "
+from jinja2 import Environment, FileSystemLoader
+env = Environment(loader=FileSystemLoader('templates'))
+for t in ['<file>.html']:
+    env.get_template(t)
+    print(f'✅ {t}')
+"
+
+# CSS braces balance
+python3 -c "
+css = open('static/app.css').read()
+o, c = css.count('{'), css.count('}')
+print(f'{o}/{c}', '✅' if o == c else '❌ MISMATCH')
+"
+
+# Smoke
+curl -s -o /dev/null -w '%{http_code}' http://127.0.0.1:<port>/
+# Має бути 200/302
+```
+
+**Не комітити без верифікації. ❌ → пофікси.**
+
+## Ретест попередніх findings (ОБОВ'ЯЗКОВО)
+
+При новій task:
+1. Прочитай свій `~/comms/gocc3-report.md`
+2. Незавершені пункти — перевір кожен
+3. Таблиця `## Ретест` — DONE / STILL OPEN
+4. ТІЛЬКИ ПІСЛЯ — нова task
+
+## Worktree discipline
+- Працюєш у `~/gocc3/<project>/` (не в production / не в `~/goboss/<project>/`)
+- `git pull --rebase` перед роботою
+- `git commit` локально → goboss cherry-pick'ає / push'ить
+
+## Формат звіту
+
+```markdown
+[gocc3 YYYY-MM-DD HH:MM] Task ID: <id>
+
+## Commit: <sha>
+## Files: <list>
+
+## Знайдено
+| # | Файл:рядок | Проблема | Severity |
+
+## Виправлено
+| # | Файл | Що зроблено |
+
+## Verification
+- jinja parse: ✅
+- css braces: ✅ 1234/1234
+- smoke /: 200
+
+## BUGLOG
+- <item> — <status>
+```
+
+## Pre-push subagent (для значних змін)
+Перед `git commit` — якщо diff >50 LOC АБО architectural / нова integration — self-trigger `Agent(superpowers:code-reviewer)` на diff. Auto-fix high-priority issues. Skip = process violation.
+
+## Координація
+- Задачі від goboss
+- Після commit — чекай review/push від goboss
+
+## Signal goboss
+Write `~/comms/gocc3-report.md` → hook auto-signals. Manual:
+```bash
+tmux send-keys -t goboss "gocc3: done" Enter
+```