ub-mode README

README проекта с github.com/unclebob/ub-mode. Одним файлом markdown: README.md.

ub-mode

ub-mode is an agent skill that enforces disciplined software engineering principles when writing or changing code. It is loosely based on portions of @poteto's rules (poteto-mode / pstack), reduced and paired with deterministic quality-gate tools:

  1. First Make it Work — Laziness Protocol, Foundational Thinking, TDD, Redesign From First Principles, Attack the Premise, Subtract Before You Add, Outcome-Oriented Execution, Build the Lever, and Architecture (Model the Domain, Boundary Discipline, Type System Discipline, Make Operations Idempotent, Separate Before Serializing Shared State).
  2. Then Make it Right — Fix Root Causes, Sequence Work into Verifiable Units, Test Behavior (Not Implementation), Crapper (CRAP < 10), Dryer (duplication < 0.8), Mutator (cover the uncovered, kill the survivors, delete dead code), and Refactoring.
  3. Practice — Keep a Log, Guard the Context Window, Worktree Cleanup, and Commit and Push in small ordered commits.

Companion Tool Repositories

ub-mode relies on deterministic quality-gate tools to enforce structure, complexity, duplication, and test thoroughness:

Installation

Copy SKILL.md into your agent's skills directory as ub-mode/SKILL.md (for example ~/.grok/skills/ub-mode/SKILL.md, ~/.claude/skills/ub-mode/SKILL.md, or ~/.cursor/skills/ub-mode/SKILL.md), then invoke /ub-mode.

ub-mode (unclebob/ub-mode)

Ищем в базе…

8.1K ·GitHub
Что это такое?ub-mode — это навык для агента, который заставляет ИИ-агента, пишущего или меняющего код, придерживаться дисциплинированных инженерных принципов: например, разработки через тестирование (TDD), переосмысления задачи с первых принципов и соблюдения архитектурной дисциплины.
Это отдельное приложение или файл, который я кладу в своего агента для кода?Это один файл SKILL.md, который вы помещаете в папку навыков вашего агента. Это не программа, которую запускают отдельно. Он частично основан на правилах @poteto (poteto-mode / pstack), но сокращён и дополнен детерминированными инструментами проверки качества.
Какие агенты для кода могут использовать его?Пути установки показывают поддержку Grok, Claude (Claude Code) и Cursor, так как навык помещается в папку навыков каждого из них.
Нужны ли другие инструменты для полноценной проверки качества?Чтобы на этапе 'Make it Right' действительно измерялись покрытие мутациями и оценки CRAP, нужны сопутствующие репозитории unclebob/mutator для мутационного тестирования и unclebob/uml-viewer для визуализации покрытия, CRAP и оценок мутаций. Сам ub-mode только навязывает правила агенту.
Что входит в этап 'First Make it Work'?Он включает Laziness Protocol, Foundational Thinking, TDD, Redesign From First Principles, Attacking the Premise, Subtracting Before Adding, Outcome-Oriented Execution, Building the Lever, а также архитектурные практики: доменное моделирование, дисциплину границ, дисциплину системы типов, идемпотентные операции и отделение разделяемого состояния перед сериализацией.
Что входит в этап 'Then Make it Right'?Он сосредоточен на устранении первопричин, разбиении работы на проверяемые части, тестировании поведения, а не реализации, и снижении метрики CRAP (порог сходства 0.8) до тех пор, пока проблемный код не будет устранён.
Почему ub-mode основан на poteto-mode?Автор сократил и адаптировал части существующего набора правил @poteto (poteto-mode / pstack), сделав из них более компактную версию, а затем дополнил её детерминированными инструментами проверки качества, а не полагался только на суждение агента.
Что за оценка CRAP, которую навык пытается устранить?CRAP (Change Risk Anti-Patterns) измеряет сложность кода в сочетании с отсутствием покрытия тестами. Связка ub-mode с инструментами проверки качества нацелена на код, у которого эта оценка при пороге сходства 0.8 указывает на рискованный, слабо протестированный код.
Какие есть похожие проекты?pstack, superpowers-zh, skills, Claude-Code-Game-Studios, oil-ui, skills, anti-slop, ai-design-skills
Автор
unclebob
Размер
<0.1 MB
Звёзды
8.1K
Обновлён
КоммитNov 02
Возраст
24 д
Коммиты · 90 дней