By stefanfaur
Unified workflow plugin combining research-first methodology with skills-first enforcement for Claude Code
Use this agent when a major project step has been completed and needs to be reviewed against the original plan and coding standards. Examples: <example>Context: The user is creating a code-review agent that should be called after a logical chunk of code is written. user: "I've finished implementing the user authentication system as outlined in step 3 of our plan" assistant: "Great work! Now let me use the code-reviewer agent to review the implementation against our plan and coding standards" <commentary>Since a major project step has been completed, use the code-reviewer agent to validate the work against the plan and identify any issues.</commentary></example> <example>Context: User has completed a significant feature implementation. user: "The API endpoints for the task management system are now complete - that covers step 2 from our architecture document" assistant: "Excellent! Let me have the code-reviewer agent examine this implementation to ensure it aligns with our plan and follows best practices" <commentary>A numbered step from the planning document has been completed, so the code-reviewer agent should review the work.</commentary></example>
Analyzes codebase implementation details. Call the codebase-analyzer agent when you need to find detailed information about specific components. As always, the more detailed your request prompt, the better! :)
Locates files, directories, and components relevant to a feature or task. Call `codebase-locator` with human language prompt describing what you're looking for. Basically a "Super ripgrep/Glob/LS tool" — Use it if you find yourself desiring to use one of these tools more than once.
codebase-pattern-finder is a useful subagent_type for finding similar implementations, usage examples, or existing patterns that can be modeled after. It will give you concrete code examples based on what you're looking for! It's sorta like codebase-locator, but it will not only tell you the location of files, it will also give you code details!
The research equivalent of codebase-analyzer. Use this subagent_type when wanting to deep dive on a research topic. Not commonly needed otherwise.
You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores user intent, requirements and design before implementation.
Use when creating git commits with user approval, whether committing explicit file paths or auto-discovering all changes
Use when context is getting long, before pausing or ending a work session, or when transferring ongoing work to a new session. ALWAYS prefer this over auto-compacting — use proactively before context fills up.
Use when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies
Use when you have a written implementation plan to execute in a separate session with review checkpoints
Matches all tools
Hooks run on every tool call, not just specific ones
Uses power tools
Uses Bash, Write, or Edit tools
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
Private Claude Code plugin marketplace.
The core plugins — roach, preroach, and agent-browser — derive from the Claude Code configurations of HumanLayer and obra/superpowers, restructured into a unified plugin with domain-scoped artifact storage (thoughts/shared/{plans|research|handoffs}/<domain>/).
The marketplace also includes community-contributed plugins from Jeremy Longshore for CI/CD, Ansible, Docker Compose, and database query profiling.
| Plugin | Author | Description |
|---|---|---|
| roach | Stefan Faur | Research-first methodology with skills-first enforcement |
| preroach | Stefan Faur | Legacy plan-centric workflow skills (creating, implementing, validating, iterating plans) |
| agent-browser | Stefan Faur | Browser automation with workflow persistence (requires agent-browser CLI) |
| mariadb-mcp | Stefan Faur | MariaDB MCP server integration with automated setup and database best practices |
| ci-cd-pipeline-builder | Jeremy Longshore | Build CI/CD pipelines for GitHub Actions, Gitea, GitLab CI, Jenkins |
| ansible-playbook-creator | Jeremy Longshore | Create and validate Ansible playbooks |
| docker-compose-generator | Jeremy Longshore | Generate Docker Compose files with validation |
| database-query-profiler | Jeremy Longshore | Profile and optimize database queries |
1. Install and authenticate the GitHub CLI:
| Platform | Command |
|---|---|
| macOS | brew install gh |
| Linux | See gh installation docs |
| Windows | winget install GitHub.cli or choco install gh |
# All platforms — log in and select HTTPS when prompted
gh auth login
gh auth status
2. Verify access to this repository:
gh repo view stefanfaur/roach-marketplace --json name
/plugin
# Select "Add Marketplace"
# Enter: https://github.com/stefanfaur/roach-marketplace.git
After adding the marketplace, enable the plugins you want. Available plugins: roach, preroach, agent-browser, mariadb-mcp, ci-cd-pipeline-builder, ansible-playbook-creator, docker-compose-generator, database-query-profiler.
ripgrep (required — used by Claude Code for codebase searching):
| Platform | Command |
|---|---|
| macOS | brew install ripgrep |
| Linux | apt install ripgrep or cargo install ripgrep |
| Windows | winget install BurntSushi.ripgrep.MSVC or choco install ripgrep |
agent-browser (recommended — enables browser automation):
# All platforms (requires Node.js)
npm install -g agent-browser
agent-browser install
If you use a JetBrains IDE (IntelliJ, WebStorm, PyCharm, etc.):
roach detects JetBrains MCP availability at session start and tells the agent whether to use JetBrains tools or fall back to built-in tools.
roach warns at session start if any companion is missing.
Add this to your project's .claude/settings.json to auto-prompt teammates:
{
"extraKnownMarketplaces": {
"roach-marketplace": {
"source": {
"source": "github",
"repo": "stefanfaur/roach-marketplace"
}
}
}
}
The core plugin. Derived from obra/superpowers and HumanLayer's Claude Code configurations, restructured into a single plugin with domain-scoped artifact storage (thoughts/shared/{plans|research|handoffs}/<domain>/).
A SessionStart hook injects the foundational skill into every session, forcing Claude to check for applicable skills before responding. A PostToolUse hook monitors context window usage after every tool call and warns when remaining context drops below 35% (warning) or 25% (critical), prompting handoff creation before context runs out.
npx claudepluginhub stefanfaur/roach-marketplace --plugin roachBuild CI/CD pipelines for GitHub Actions, Gitea Actions, GitLab CI, Jenkins, and more
Create Ansible playbooks for configuration management
MariaDB MCP server integration with comprehensive best practices for schema design, indexing, query optimization, Hibernate/QueryDSL, and operations
Generate Docker Compose and Podman Compose configurations for multi-container applications with best practices
Profile and optimize database queries for performance
Harness-native ECC operator layer - 67 agents, 271 skills, 92 legacy command shims, reusable hooks, rules, selective install profiles, and production-ready workflows for Claude Code, Codex, OpenCode, Cursor, and related agent harnesses
Superpowers Plus core skills library for Claude Code: planning, execution routing, TDD, debugging, and collaboration workflows
Claude harness - A harness for solo developers (Vibecoders) to handle full-cycle contract development.
Core skills library for Claude Code: TDD, debugging, collaboration patterns, and proven techniques
Persistent file-based planning for AI coding agents. Crash-proof markdown plans (task_plan.md, findings.md, progress.md) that survive context loss and /clear, with an opt-in completion gate and multi-agent shared state. Manus-style. Works with Claude Code, Codex CLI, Cursor, Kiro, OpenCode and 60+ agents via the SKILL.md standard. Includes Arabic, German, Spanish, and Chinese (Simplified and Traditional).
Unity Development Toolkit - Expert agents for scripting/refactoring/optimization, script templates, and Agent Skills for Unity C# development