---
slug: "dot-claude-pproenca"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/pproenca/dot-claude@master/README.md"
repo: "https://github.com/pproenca/dot-claude"
source_file: "README.md"
branch: "master"
---
# dot-claude

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

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

```bash
# 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](https://github.com/pproenca/dot-claude/tree/HEAD/plugins/dev-workflow) | TDD, systematic debugging, and code review workflows |
| [cairn](https://github.com/pproenca/dot-claude/tree/HEAD/plugins/cairn) | Boundary-discipline harness that makes feature N+1 cheaper than feature N |
| [dev-python](https://github.com/pproenca/dot-claude/tree/HEAD/domain_plugins/dev-python) | Python 3.12+ with uv, ruff, pydantic, FastAPI, Django |
| [dev-ts](https://github.com/pproenca/dot-claude/tree/HEAD/domain_plugins/dev-ts) | TypeScript/JavaScript with Google Style Guide patterns |
| [dev-cpp](https://github.com/pproenca/dot-claude/tree/HEAD/domain_plugins/dev-cpp) | C++ development with clangd LSP integration |
| [dev-shell](https://github.com/pproenca/dot-claude/tree/HEAD/domain_plugins/dev-shell) | Shell scripting with Google Style Guide patterns |

## Requirements

- [Claude Code](https://github.com/anthropics/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:

```bash
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](https://github.com/pproenca/dot-claude/tree/HEAD/plugins/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](https://github.com/pproenca/dot-claude/tree/HEAD/plugins/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](https://github.com/pproenca/dot-claude/tree/HEAD/domain_plugins/dev-python)

Modern Python development plugin:

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

### [dev-ts](https://github.com/pproenca/dot-claude/tree/HEAD/domain_plugins/dev-ts)

TypeScript/JavaScript development plugin:

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

### [dev-cpp](https://github.com/pproenca/dot-claude/tree/HEAD/domain_plugins/dev-cpp)

C++ development plugin:

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

### [dev-shell](https://github.com/pproenca/dot-claude/tree/HEAD/domain_plugins/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](https://github.com/anthropics/skills).

## License

[MIT](https://github.com/pproenca/dot-claude/tree/HEAD/LICENSE)