By jonnycbb
Engineering utilities: /assess-incident for severity classification, /incident-investigation for root cause analysis across backend/data/indexing domains, /refactor-architecture for codebase friction analysis and proposals, /system-architecture-doc for C4 architecture documentation, plus service diagnostics and operational skills.
C4 model architecture diagrams for systems. Use when asked to create architecture documentation, model a system for agent reasoning, generate C4 diagrams from code/config, or plan multi-system refactorings that need architectural context.
Explore a codebase for architectural friction (scattered concepts, shallow modules, tight coupling), quantify issues with coupling metrics, design multiple interface alternatives via parallel agents, and produce a proposal document with old/new architecture diagrams and honest pros/cons. Proposal-only — never makes code changes. Use when asked to "refactor architecture", "improve codebase structure", "deepen modules", "reduce coupling", "make code more navigable", or when /code-review repeatedly surfaces structural issues. Invocable as /refactor-architecture [scope-path].
Create architecture documentation for a system with C4 diagrams and enriched Structurizr DSL models. Use when asked to document a system's architecture, produce C4 diagrams from system names or repos, or create a comprehensive architecture README with diagrams and request flow walkthroughs. Trigger phrases include "create architecture documentation", "document this system", "generate C4 diagram", "system architecture doc". Outputs to ~/.claude/thoughts/shared/architecture/.
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.
A directory with my Claude Code setup - agents, commands, skills.
Follow the README for instructions on how to use these for your own use cases and hopefully be inspired by what's possible.
Important Note: The agents and commands are constantly evolving. I'll try to keep this README up-to-date but hopefully the content can be useful in inspiring others to leverage some more advanced features of Claude Code.
This repo also serves as a Claude Code plugin marketplace. You can install plugins directly from this repo.
| If you want to... | Install |
|---|---|
| Build features with AI-guided TDD workflow | jbb-feature-dev |
| Investigate incidents or document architecture | eng-utils |
| Create interactive explainers or presentations | jiffy-toolkit |
| All of the above | Install all three -- they work independently |
| Plugin | When to use it | Description | Examples |
|---|---|---|---|
| jbb-feature-dev | You're building a feature from scratch | End-to-end development workflow: from requirements gathering and codebase research through TDD planning, parallel implementation, code review, and delivery. | /interview -> /create-plan-tdd -> /implement-plan-tdd -> /code-review |
| eng-utils | Something is broken in production or you need to understand a system | Incident triage and root cause investigation, architecture documentation with C4 diagrams, and service diagnostics (pods, logs, alerts, callgraphs, edge config). | /incident-investigation, /system-architecture-doc |
| jiffy-toolkit | You need to explain or present something | Turn concepts into polished interactive pages, slide decks, and standards-compliant documentation. | /teach-me, /frontend-slides |
| Plugin | Skills | Agents | Commands | Size |
|---|---|---|---|---|
| jbb-feature-dev | 17 | 13 | 2 | Comprehensive |
| eng-utils | 3 | 1 | 0 | Focused |
| jiffy-toolkit | 5 | 5 | 0 | Lightweight |
From within Claude Code:
/plugin marketplace add https://github.com/JonnyCBB/claude-code-config.git
Or from the terminal:
claude plugin marketplace add https://github.com/JonnyCBB/claude-code-config.git
/plugin install jbb-feature-dev@jbb-claude-code-plugins
/plugin install eng-utils@jbb-claude-code-plugins
/plugin install jiffy-toolkit@jbb-claude-code-plugins
Add to any project's .claude/settings.json to prompt users to install automatically:
{
"extraKnownMarketplaces": {
"jbb-claude-code-plugins": {
"source": {
"source": "git",
"url": "https://github.com/JonnyCBB/claude-code-config.git"
}
}
}
}
Required for all plugins:
gh CLI tool for GitHub workflowsnpx claudepluginhub jonnycbb/claude-code-config --plugin eng-utilsCreative and standards tools: /teach-me for interactive scrollytelling explanations, /frontend-slides for HTML presentations, plus editorial, diagram, and skills-authoring standards with companion review agents.
Complete feature development workflow: /interview for requirements gathering, /research-problem for codebase research, /map-feature-to-plans and /break-down-initiative for feature splitting, /create-plan-tdd and /implement-plan-tdd for test-driven planning and execution, /code-review for multi-agent review, /verify-implementation for evidence generation, /commit and /pr-description for git workflows.
Cross-cutting utilities: technical writing, git workflow, code review, pair programming, on-call runbooks, incident response.
DevsForge incident report generator with root cause analysis, timeline tracking, and post-mortem documentation
Systematic debugging and root cause analysis framework - four-phase investigation process ensuring understanding before fixes
Streamline engineering workflows — standups, code review, architecture decisions, incident response, and technical documentation. Works with your existing tools or standalone.
Verification-first engineering toolkit for Claude Code. 15 skills across a 5-phase spine (Investigate → Design → Implement → Verify → Ship), 8 specialist agents, an interactive setup wizard. Every skill has rationalizations + evidence requirements. Built for senior ICs and tech leads.
Debug issues systematically with root cause analysis and execution tracing