oneb-dev-plugin

Внутрішній плагін команди розробки OneB для Claude Code. Поступово збагачується скілами, яких нам не вистачає у щоденній роботі.

Встановлення

Цей репозиторій одночасно є плагіном і marketplace (каталог oneb-dev). Щоб встановити в Claude Code:

/plugin marketplace add oneb-pub/oneb-dev-plugin
/plugin install oneb-dev-plugin@oneb-dev

Перша команда додає marketplace; друга — встановлює сам плагін з нього.

Щоб згодом отримати оновлення:

/plugin marketplace update oneb-dev

Скіли

Скіл	Що робить
tech-debt	Керує технічним боргом у репозиторії за усталеною структурою OneB (tech_debt/index.md + items/NNN-slug.md). Покриває три сценарії: (1) реєстрація нового боргу за явними/неявними тригерами; (2) перевірка зв'язку поточної задачі з відкритим боргом; (3) проактивна поведінка під час роботи з кодом — не збільшувати борг, зменшувати без додаткової роботи, пропонувати закриття чи розширення задачі.
oneb-wiki	Документує user-facing зміни статтями-довідками для кінцевого користувача в OneB Wiki. Активується наприкінці задачі, коли є новий екран/модуль/фіча, зміна поведінки наявної фічі або нове доменне поняття. Резолвить каталог Wiki за назвою проєкту (не хардкодить), підбирає жанрову категорію (Огляди можливостей / Покрокові інструкції / Поняття й терміни / Що нового), пише нетехнічним тоном, створює чернетку лише після підтвердження користувача і повертає посилання на статтю. Скріни — дозовано, через Playwright-кіт проєкту.

Структура каталогу tech-debt у проєкті

Скіл працює з такою структурою у корені репо, в якому його застосовують:

tech_debt/
├── index.md                       # реєстр-таблиця всіх відкритих боргів
└── items/
    ├── 001-kebab-case-slug.md
    ├── 002-another-slug.md
    └── ...

Якщо каталог відсутній — скіл створює його разом зі скелетом index.md автоматично (з попередженням користувача).

Реєстр

Таблиця з колонками: #, Назва, Категорія, Пріоритет, Статус. Пріоритети: 🔴 високий · 🟡 середній · 🟢 низький. Закриті борги фізично видаляються — історія в git.

Item-файл

Шість блоків у фіксованому порядку: заголовок → метадані → ## Проблема → ## Куди рухатись (Варіант A/B/C + Попередня рекомендація) → ## Критерії "зроблено" → опційна прикінцева цитата для крос-посилань.

Повні шаблони — у skills/tech-debt/references/.

CLAUDE.md integration

При першій активації скіл перевіряє CLAUDE.md проєкту і, якщо там ще нема маркера <!-- tech-debt-skill -->, пропонує додати готовий блок з правилами (шаблон у skills/tech-debt/references/claude-md-snippet.md). Цей блок — критично важлива частина плагіна: він робить проактивну поведінку завжди-увімкненою, навіть коли скіл не активований явно.

Без CLAUDE.md блоку працює тільки явна реєстрація боргу за тригер-фразами. Із блоком Claude під час будь-якої задачі звіряється з tech_debt/index.md, сам помічає дотичність до боргу і пропонує закриття чи розширення задачі.

Скіл нічого не редагує без явного підтвердження користувача.

Проактивна поведінка — три правила

Після встановлення блоку в CLAUDE.md під час роботи з кодом Claude буде:

1. Не збільшувати борг. Не додавати коду, який поглиблює описану в боргу проблему.
2. Зменшувати, коли це безкоштовно. Користуватися «новим підходом» з рекомендованого варіанту боргу, якщо це не ламає логіку і не додає значної додаткової роботи.
3. Сигналити явно. Якщо все-таки використав «старий підхід» з причини — коротко це згадати.

Плюс, якщо поточна задача дуже близька до відкритого боргу, Claude запитає користувача: чи не закрити борг натомість, чи не розширити задачу так, щоб заодно закрити item.

Правила, яких скіл дотримується

• Не комітить і не пушить — це робить користувач.
• Не вирішує сам між варіантами A/B/C — це продуктове рішення.
• Відкриття боргу — окрема задача від основної (не змішувати коміти).
• Якщо борг із схожою назвою вже існує — пропонує оновити, а не дублювати.

Документування в OneB Wiki (oneb-wiki)

Скіл oneb-wiki робить продуктову довідку частиною робочого циклу: коли в задачі зʼявляється user-facing зміна, наприкінці (перед фінальним підсумком) Claude пропонує задокументувати її в OneB Wiki і, після підтвердження, пише статтю-чернетку простою мовою для кінцевого користувача.

CLAUDE.md проєкту дає скілу два значення: назву каталогу Wiki (за нею скіл резолвить catalog_id через list_catalogs) і чим робити скріншоти. Сам скіл — загальний, тому переноситься між oneb-проєктами без правок.

Скіл не публікує статті (лише чернетки) і не комітить/не пушить.

Версія

0.4.1 — oneb-wiki: завантаження скріншотів через create_image_upload (presigned PUT). 0.4.0 — додано скіл oneb-wiki (документування user-facing змін у OneB Wiki). 0.3.0 — розділення tech-debt на tech-debt / tech-debt-close / tech-debt-proactive.

Подальші скіли додаватимуться у skills/ і реєструватимуться в .claude-plugin/marketplace.json цього ж repo.