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) проактивна поведінка під час роботи з кодом — не збільшувати борг, зменшувати без додаткової роботи, пропонувати закриття чи розширення задачі.

Структура каталогу 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 — це продуктове рішення.
• Відкриття боргу — окрема задача від основної (не змішувати коміти).
• Якщо борг із схожою назвою вже існує — пропонує оновити, а не дублювати.

Версія

0.2.0 — розширення скіла tech-debt: додано проактивну поведінку під час роботи з кодом і workflow закриття/розширення задачі.

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