Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

imbue

Workflow methodologies for analysis, evidence gathering, and structured output.

Overview

Imbue provides reusable patterns for approaching analysis tasks. It’s a methodology plugin - the patterns apply to various inputs (git diffs, specs, logs) and chain together for complex workflows.

Core Philosophy: “NO IMPLEMENTATION WITHOUT A FAILING TEST FIRST” - The Iron Law enforced through proof-of-work validation.

Installation

/plugin install imbue@claude-night-market

Principles

  • Generalizable: Patterns work across different input types
  • Composable: Skills chain together naturally
  • Evidence-based: Emphasizes capturing proof for reproducibility
  • TDD-First: Iron Law enforcement prevents cargo cult testing

Skills

Review Patterns

SkillDescriptionWhen to Use
review-coreScaffolding for detailed reviewsStarting architecture, security, or code quality reviews
evidence-loggingEvidence capture methodologyCreating audit trails during analysis
structured-outputOutput formatting patternsPreparing final reports

Analysis Methods

SkillDescriptionWhen to Use
diff-analysisSemantic changeset analysisUnderstanding impact of changes
catchupContext recoveryGetting up to speed after time away

Workflow Guards

SkillDescriptionWhen to Use
scope-guardAnti-overengineeringEvaluating if features should be built now
proof-of-workEvidence-based validationEnforcing Iron Law TDD discipline
rigorous-reasoningAnti-sycophancy guardrailsAnalyzing conflicts, evaluating contested claims

Feature Planning

SkillDescriptionWhen to Use
feature-reviewFeature prioritizationSprint planning, roadmap reviews

Workflow Automation

SkillDescriptionWhen to Use
workflow-monitorExecution monitoring and issue creationAfter workflow failures or inefficiencies

Commands

CommandDescription
/catchupQuick context recovery from recent changes
/structured-reviewStart structured review workflow with evidence logging
/feature-reviewFeature prioritization with RICE+WSJF scoring

Agents

AgentDescription
review-analystAutonomous structured reviews with evidence gathering

Hooks

HookTypeDescription
session-start.shSessionStartInitializes scope-guard, Iron Law, and learning mode
user-prompt-submit.shUserPromptSubmitValidates prompts against scope thresholds
tdd_bdd_gate.pyPreToolUseEnforces Iron Law at write-time
pre-pr-scope-check.shManualChecks scope before PR creation
proof-enforcement.mdDesignIron Law TDD compliance enforcement

Usage Examples

Structured Review

Skill(imbue:review-core)

# Required TodoWrite items:
# 1. review-core:context-established
# 2. review-core:scope-inventoried
# 3. review-core:evidence-captured
# 4. review-core:deliverables-structured
# 5. review-core:contingencies-documented

Diff Analysis

Skill(imbue:diff-analysis)

# Answers: "What changed and why does it matter?"
# - Categorizes changes by function
# - Assesses risks
# - Summarizes implications

Quick Catchup

/catchup

# Summarizes:
# - Recent commits
# - Changed files
# - Key decisions
# - Action items

Feature Prioritization

/feature-review

# Uses hybrid RICE+WSJF scoring:
# - Reach, Impact, Confidence, Effort
# - Weighted Shortest Job First
# - ISO 25010 quality dimensions

Scope Guard

The scope-guard skill prevents overengineering via four components:

ComponentPurpose
decision-frameworkWorthiness formula and scoring
anti-overengineeringRules to prevent scope creep
branch-managementThreshold monitoring (lines, commits, days)
baseline-scenariosValidated test scenarios

Iron Law TDD Enforcement

The proof-of-work skill enforces the Iron Law:

NO IMPLEMENTATION WITHOUT A FAILING TEST FIRST

This prevents “Cargo Cult TDD” where tests validate pre-conceived implementations.

Self-Check Protocol

Thought PatternViolationAction
“Let me plan the implementation first”Skipping REDWrite failing test FIRST
“I know what tests we need”Pre-conceived implDocument failure, THEN design
“The design is straightforward”Skipping uncertaintyLet design EMERGE from tests

TodoWrite Items

proof:iron-law-red     - Failing test documented
proof:iron-law-green   - Minimal code to pass
proof:iron-law-refactor - Code improved, tests green
proof:iron-law-coverage - Coverage gates verified

See iron-law-enforcement.md module for full enforcement patterns.

Rigorous Reasoning

The rigorous-reasoning skill prevents sycophantic patterns through structured analysis:

ComponentPurpose
priority-signalsOverride principles (no courtesy agreement, checklist over intuition)
conflict-analysisHarm/rights checklist for interpersonal conflicts
debate-methodologyTruth claims and contested territory handling
red-flag monitoringDetect sycophantic thought patterns

Red Flag Self-Check

Thought PatternReality CheckAction
“I agree that…”Did you validate?Apply harm/rights checklist
“You’re right that…”Is this proven?Check for evidence
“That’s a fair point”Fair by what standard?Specify the standard

TodoWrite Integration

All skills output TodoWrite items for progress tracking:

review-core:context-established
review-core:scope-inventoried
diff-analysis:baseline-established
diff-analysis:changes-categorized
catchup:context-confirmed
catchup:delta-captured

Integration Pattern

Imbue is foundational - other plugins build on it:

# Sanctum uses imbue for review patterns
Skill(imbue:review-core)
Skill(sanctum:git-workspace-review)

# Pensive uses imbue for evidence gathering
Skill(imbue:evidence-logging)
Skill(pensive:architecture-review)

Superpowers Integration

SkillEnhancement
scope-guardUses brainstorming, writing-plans, execute-plan
/feature-reviewUses brainstorming for feature suggestions
  • sanctum: Uses imbue for review scaffolding
  • pensive: Uses imbue for evidence gathering
  • spec-kit: Uses imbue for analysis patterns