dot-claude

A collection of Claude Code plugins for structured development workflows, Python best practices, and shell scripting.

Note: This is a personal project and is not affiliated with or endorsed by Anthropic. Use at your own discretion.

Quick Start

# In Claude Code, run:
/plugin marketplace add pproenca/dot-claude

# Then install the plugins you need:
/plugin install dev-workflow@dot-claude

Plugins

Plugin	Description
dev-workflow	TDD, systematic debugging, and code review workflows
cairn	Boundary-discipline harness that makes feature N+1 cheaper than feature N
dev-python	Python 3.12+ with uv, ruff, pydantic, FastAPI, Django
dev-ts	TypeScript/JavaScript with Google Style Guide patterns
dev-cpp	C++ development with clangd LSP integration
dev-shell	Shell scripting with Google Style Guide patterns

Requirements

• Claude Code CLI

Installation

Via Plugin Marketplace (Recommended)

Add the marketplace and install plugins from within Claude Code:

/plugin marketplace add pproenca/dot-claude

Then install individual plugins:

/plugin install dev-workflow@dot-claude
/plugin install cairn@dot-claude
/plugin install dev-python@dot-claude
/plugin install dev-ts@dot-claude
/plugin install dev-cpp@dot-claude
/plugin install dev-shell@dot-claude

Or install all at once:

/plugin install dev-workflow@dot-claude dev-python@dot-claude dev-ts@dot-claude dev-cpp@dot-claude dev-shell@dot-claude

Manual Installation

Clone the repository and symlink the desired plugins:

git clone https://github.com/pproenca/dot-claude.git ~/.dot-claude

# Install dev-workflow
ln -s ~/.dot-claude/plugins/dev-workflow ~/.claude/plugins/dev-workflow

# Install domain plugins
ln -s ~/.dot-claude/domain_plugins/dev-python ~/.claude/plugins/dev-python
ln -s ~/.dot-claude/domain_plugins/dev-ts ~/.claude/plugins/dev-ts
ln -s ~/.dot-claude/domain_plugins/dev-cpp ~/.claude/plugins/dev-cpp
ln -s ~/.dot-claude/domain_plugins/dev-shell ~/.claude/plugins/dev-shell

Plugin Details

dev-workflow

Development methodology plugin enforcing discipline through architecture:

• Skills: TDD, systematic debugging, verification, code review
• Commands: /brainstorm, /write-plan, /execute-plan, /resume
• Agents: code-explorer, code-architect, code-reviewer

cairn

Boundary-discipline harness so the marginal cost of each feature slopes down:

• Commands: /feature, /fix, /refactor, /spike, /setup
• Skills: boundary discipline, feature/fix/refactor/spike workflows, verify-and-diagnose, knowledge ratchet, capability ledger, mental models
• Six-stage plan → skeleton → build → verify → record → ratchet loop with a human spec parse-point
• Stack-agnostic: the four boundary kinds (trust, effect, consistency, containment) place frontend, API, database, and event-driven code

dev-python

Modern Python development plugin:

• uv package manager integration
• ruff linting and formatting
• pydantic, FastAPI, Django patterns
• Python 3.12+ idioms

dev-ts

TypeScript/JavaScript development plugin:

• Google TypeScript Style Guide compliance
• typescript-language-server LSP integration
• Modern ES6+ patterns

dev-cpp

C++ development plugin:

• clangd LSP integration for code intelligence
• Modern C++ patterns and best practices

dev-shell

Shell scripting plugin:

• Google Shell Style Guide compliance
• Bash best practices
• Script structure patterns

Contributing

Contributions are welcome. Please open an issue to discuss changes before submitting a pull request.

Acknowledgments

Inspired by anthropics/skills.

License

MIT