claude

roach

Research-first methodology with skills-first enforcement for Claude Code

1 on GitHubby Stefan Faurv1.7.0MITupdated 1 month agoproductivity
/

Plugin roach from marketplace roach-marketplace in stefanfaur/roach-marketplace. Commands read from the repo's manifest — 1 month ago.

This plugin runs code on your machine — its hooks fire automatically on events like tool use. The exact commands are listed below; read them before installing.

What it installs

Skills (18)

  • brainstorming

    Use before any creative work — creating features, building components, adding functionality, or modifying behavior — before writing code or invoking an implementation skill.

  • committing

    Use when creating git commits with user approval, whether committing explicit file paths or auto-discovering all changes

  • create-handoff

    Use when context is getting long, before pausing or ending a work session, or when transferring ongoing work to a new session — prefer this over auto-compacting, and write it before context fills up.

  • dispatching-parallel-agents

    Use when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies

  • executing-plans

    Use when implementing a written plan task by task, in this session or a new one

  • grill-me

    Use when the user wants their plan or design stress-tested — poke holes, challenge assumptions, devil's-advocate pushback — mentions "grill me", or arrives at brainstorming with a design already in their head.

  • receiving-code-review

    Use when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation

  • requesting-code-review

    Use when completing tasks, implementing major features, or before merging to verify work meets requirements. Invoke with arguments: BASE_SHA HEAD_SHA 'what was implemented' 'plan path or requirements' — without the two SHAs it reviews the wrong diff.

  • researching-codebase

    Use when documenting codebase as-is through parallel agent research, producing a research document in thoughts/ to answer a specific question about how existing code works

  • resuming-handoff

    Use when resuming work from a handoff document, given its path or a domain name

  • systematic-debugging

    Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes

  • test-driven-development

    Use when implementing any feature or bugfix, before writing implementation code

  • using-roach

    Use when starting any conversation — explains how to find and invoke roach skills before responding or acting, including before clarifying questions

  • verification-before-completion

    Use when about to claim work is complete, fixed, or passing — before committing, opening a PR, marking a task done, or reporting success to the user or a controller

  • writing-natural

    Use when writing any natural language — documentation, READMEs, changelogs, summaries, skill content, command content, or any prose that will be read by humans.

  • writing-plans

    Use when you have a spec or requirements for a multi-step task, before touching code

  • writing-simply

    Use when writing any natural language that will be read by humans: documentation, READMEs, changelogs, summaries, PR descriptions, release notes, error messages, or skill content. Applies when plain controlled prose is wanted over prose with a voice. Also use when asked to remove AI slop, stop text

  • writing-skills

    Use when creating new skills, editing existing skills, or verifying skills work before deployment

Subagents (7)

  • code-reviewer

    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

  • codebase-analyzer

    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! :)

  • codebase-locator

    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

    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 locatio

  • thoughts-analyzer

    The research equivalent of codebase-analyzer. Use this subagent_type when wanting to deep dive on a research topic. Not commonly needed otherwise.

  • thoughts-locator

    Discovers relevant documents in thoughts/ directory (We use this for all sorts of metadata storage!). This is really only relevant/needed when you're in a reseaching mood and need to figure out if we have random thoughts written down that are relevant to your current research task. Based on the name

  • web-search-researcher

    Do you find yourself desiring information that you don't quite feel well-trained (confident) on? Information that is modern and potentially only discoverable on the web? Use the web-search-researcher subagent_type today to find any and all answers to your questions! It will research deeply to figure

Hooks (1)

  • SessionStart

    bash ${CLAUDE_PLUGIN_ROOT}/hooks/session-start.sh

View source on GitHub

More from stefanfaur/roach-marketplace

All 6 plugins →

MariaDB MCP integration with best practices for schema design, indexing, Hibernate/QueryDSL, and database operations

1 skill · 3 commands · hooks

1

Build CI/CD pipelines for GitHub Actions, Gitea Actions, GitLab CI, Jenkins, and more

1 skill · 1 command

1

Generate Docker Compose and Podman Compose configurations for multi-container applications

1 skill · 1 command

1

Similar plugins

Matt Pocock's agent skills for real engineering (grilling, spec/ticket flows, TDD, code review, domain modelling and more).

39 skills

mattpocock/skills 323,108

superpowers

claudecodex

Core skills library for Claude Code: TDD, debugging, collaboration patterns, and proven techniques

15 skills · hooks

obra/superpowers 316,836

nextjs

claude

Official Next.js skills: adopt and optimize Cache Components, adopt Partial Prefetching, and verify runtime behavior against a running dev server.

6 skills

vercel/next.js 143,495

caveman

claude

Talk like caveman. Cut filler. Keep technical details explicit.

22 skills · 1 command · 3 agents · hooks

JuliusBrussee/caveman 119,462

claude-mem

claudecodex

Persistent memory for Claude Code: the next session starts where the last one left off.

29 skills · 1 MCP server · hooks

thedotmack/claude-mem 116,618

Taste Skill

claudecodex

tasteskill 2.5.1: professional company websites at the figma.com and x.ai level, with one section per screen, real photographs, real product UI, effects kept for tech and gaming pages, and a real-browser checker and finish gate.

1 skill

Leonxlnx/taste-skill 114,391

Maintain roach?

This page updates itself from your repo. Add the badge to your README, or get it Featured to pin it above the organic results with a followed link to your site.

claude & codex plugins6 plugins