vibe-hacker

Vibe Hacker

A collection of Claude Code plugins for hacking, development workflows, and greenfield projects.

Plugins

Plugin	Description	Use Case
greenfield-mode	Prevent backwards-compatibility cruft	Prototype projects
primer	Context priming on session start	Any project
librarian	ADRs, FDPs, Action Plans, Reports, Roadmap	Structured planning
expert-agents	Klaus, Librodotus, Shawn + build/test/arch/size agents	Code audits, CI tasks
backlog	Lightweight project backlogs for ideas and polish items	Task tracking
briefcase	Personal thought management — capture, brief, tidy	Knowledge stewardship

Quick Start

# Add the vibe-hacker directory as a marketplace
/plugin marketplace add /path/to/vibe-hacker

# Install individual plugins
/plugin install greenfield-mode@vibe-hacker
/plugin install primer@vibe-hacker
/plugin install planning@vibe-hacker
/plugin install expert-agents@vibe-hacker
/plugin install backlog@vibe-hacker
/plugin install briefcase@vibe-hacker

Plugin Overview

greenfield-mode

Prevents backwards-compatibility cruft in prototype projects.

Hooks:

• PostToolUse: Detect legacy patterns in edited files
• Stop: Greenfield reminder

Config: greenfield_mode, greenfield_strict, greenfield_patterns

Full documentation

primer

Context priming - automatically load project files on session start.

Hooks:

• SessionStart: Load configured files
• After Compact: Reload files

Config: priming.files, priming.globs, priming.instructions

Full documentation

planning

Structured planning documents with protected paths.

Features:

• ADRs, FDPs, Action Plans, Reports, Roadmap
• YAML frontmatter for structured metadata
• Append-only addenda for locked documents
• Document relationships (supersedes, related)
• Protected path enforcement (readonly/guided/remind tiers)

Hooks:

• PreCompact: Roadmap update reminder
• PreToolUse: Protected paths check

Config: planning, protected_paths

Full documentation

backlog

Lightweight task tracking for ideas, polish items, and small improvements.

Commands:

• /backlog add davis "Add velocity" - Add an item
• /backlog davis - List items in a backlog
• /backlog done davis 3 - Mark done
• /backlog review davis - Analyze and prioritize

Config: backlog (root directory)

Full documentation

briefcase

Personal thought management — capture stray ideas, brief on topics, reorganize.

Features:

• Quick capture with automatic topic triage
• Synthesized briefings (not regurgitation)
• Periodic tidy: merge, split, promote, archive

Commands:

• /briefcase "thought" - Capture a thought
• /briefcase brief [topic] - Get briefed on your thinking
• /briefcase tidy - Reorganize suggestions

Config: briefcase (root directory)

Full documentation

expert-agents

Domain-specific code auditors with unique personalities.

Commands:

• /klaus - Embedded systems auditor
• /librodotus - Documentation quality auditor
• /shawn - Educational mentor

Config: None (stateless)

Full documentation

Shared Configuration

All plugins read from .claude/vibe-hacker.json:

{
  "greenfield_mode": true,
  "greenfield_strict": false,
  "greenfield_patterns": ["deprecated", "legacy", "@deprecated"],
  "priming": {
    "files": ["README.md"],
    "globs": ["docs/planning/action-plans/*.md"],
    "instructions": "Focus on active work."
  },
  "planning": {
    "version": "0.2.1",
    "subdirs": {
      "adr": "decisions",
      "fdp": "designs",
      "ap": "action-plans",
      "report": "reports"
    }
  },
  "protected_paths": {
    "planning_root": "docs/planning",
    "rules": [
      {"pattern": "docs/planning/*/archive/**", "tier": "readonly"}
    ]
  }
}

Each plugin reads only its relevant keys:

• greenfield-mode reads: greenfield_mode, greenfield_strict, greenfield_patterns
• primer reads: priming, greenfield_mode (for display)
• planning reads: planning, protected_paths
• expert-agents reads: agents (build_verifier, test_runner, etc.)
• backlog reads: backlog (root directory)
• briefcase reads: briefcase (root directory)

Repository Structure