ypm

claude-tools

Development workflow plugins for Claude Code's official plugin system.

Core Workflow

These plugins work together to form an end-to-end development lifecycle:

/ypm:new           Set up a new project with plans and documentation
     |
/code:dev-cycle    Autonomously run: sprint -> audit -> ship -> retrospective
     |
/simplify          (optional) Simplify and refine code post-implementation
     |
/code:pr-review-team   Team-based PR review with specialized agents
     |
/ypm:update        Update project status after shipping

Before & After

Without dev-cycle (manual steps):

1. Read the plan, create issue, write specs
2. Implement feature, run tests
3. Stage files, review code, fix issues, re-review
4. Commit, push, create PR
5. Run PR review, fix findings, push again
6. Write retrospective notes

With /code:dev-cycle:

/code:dev-cycle docs/plans/phase-3-plan.md

One command. Four stages run autonomously.

dev-cycle Stages

Stage	What happens
Sprint	Plan parsing, issue creation, parallel team implementation, tests, build verification
Audit	DDD/TDD/DRY/ISSUE/PROCESS compliance check
Ship	Code review loop (auto-fix), commit, push, PR creation
Retrospective	Two-agent parallel analysis, learnings update, metrics recording

Design Principles

1. Documentation Driven Development (DDD): Documentation is the single source of truth. Specs are written before code, and kept in sync with implementation.

2. Official Plugin System Compliance: Built on Claude Code's plugin system (skills, commands, hooks, agents). No custom runtime or framework required.

3. External CLI Bridge: Integrates external CLI tools (Codex, Gemini, Kiro) as Claude Code plugins, bringing their capabilities into the same workflow.

Available Plugins

Development Lifecycle

Plugin	Commands	Description
ypm	/ypm:new, /ypm:update, /ypm:next	Project management - setup wizard, status tracking, task prioritization
code	/code:dev-cycle, /code:shipping-pr, /code:review-commit	Autonomous dev lifecycle, code review, PR creation gate

Supporting Tools

Plugin	Commands	Description
cvi	/cvi:speak, /cvi:lang, /cvi:check	Voice notifications for Claude Code on macOS
codex	/codex:research, /codex:review	OpenAI Codex CLI integration for research and code review
gemini	/gemini:search	Google Gemini CLI integration for web search
kiro	/kiro:research	AWS Kiro CLI integration for AWS expert assistance
chezmoi	/chezmoi:check, /chezmoi:sync	Dotfiles management integration using chezmoi
utils	/utils:clear-plugin-cache	Utility commands for plugin cache management
x-article	/x-article:draft, /x-article:publish	X (Twitter) Articles publishing workflow

Quick Start

# 1. Add the marketplace
/plugin marketplace add signalcompose/claude-tools

# 2. Browse plugins interactively
/plugin    # Opens the Discover tab

# 3. Install a plugin
/plugin install code@claude-tools

# 4. Run the dev cycle
/code:dev-cycle docs/plans/my-plan.md

Installation

Add Marketplace

/plugin marketplace add signalcompose/claude-tools

Install Plugins

You can browse and install plugins using the interactive /plugin command, or use CLI commands directly:

# Install specific plugin (format: plugin-name@marketplace-name)
/plugin install cvi@claude-tools
/plugin install ypm@claude-tools
/plugin install chezmoi@claude-tools
/plugin install code@claude-tools
/plugin install utils@claude-tools
/plugin install codex@claude-tools
/plugin install gemini@claude-tools
/plugin install kiro@claude-tools
/plugin install x-article@claude-tools

Install with Scope (Optional)

# Install to project scope (shared with team via .claude/settings.json)
/plugin install cvi@claude-tools --scope project

# Install to user scope (default, personal settings)
/plugin install cvi@claude-tools --scope user

# Install to local scope (local settings only)
/plugin install cvi@claude-tools --scope local

Plugin Management

Update Marketplace

/plugin marketplace update claude-tools

Clear Plugin Cache (Important!)