ypm

YPM (Your Project Manager)

Multi-project progress tracking system powered by Claude Code

---

What is YPM?

YPM is a project management tool that automatically tracks the status of multiple projects in a specified directory.

Key Features:

• Automatic information collection from Git history and documentation
• Centralized management of all projects in a single file (PROJECT_STATUS.md)
• Progress visualization with multiple metrics (Phase, Implementation, Testing, Documentation)
• Next task identification for each project
• Flexible configuration via config.yml

---

Quick Start

YPM is installed as a Claude Code plugin, making it accessible from any directory.

Step 1: Install the Plugin

# In Claude Code, first add the marketplace:
/plugin marketplace add signalcompose/claude-tools

# Then install the plugin:
/plugin install ypm@signalcompose/claude-tools

# Or use the Discover tab in /plugin menu

Step 2: Initial Setup

# Run the setup wizard (from any directory)
/ypm:setup

This creates ~/.ypm/ with your configuration:

• ~/.ypm/config.yml - Your monitoring settings
• ~/.ypm/PROJECT_STATUS.md - Generated project status

Step 3: Start Using

# Scan your projects
/ypm:update

# View next tasks
/ypm:next

# Show active projects
/ypm:active

---

Skills (Auto-triggered)

Skills are automatically activated when you use natural language. Just say what you need:

Skill	Description	Trigger Examples
/ypm:project-status-update	Scan and update project status	"update project status", "scan projects"
/ypm:next-tasks	Show next tasks in priority order	"what should I work on next", "next tasks"
/ypm:active-projects	Show recently active projects	"show active projects", "what am I working on"
/ypm:project-bootstrap	8-phase new project setup wizard	"create a new project", "bootstrap project"
/ypm:git-workflow-setup	Configure Git Flow and branch protection	"set up git flow", "protect branches"

Commands (Manual invocation)

All commands are prefixed with ypm::

Command	Description
/ypm:setup	Initial setup wizard
/ypm:start	Show welcome and quick commands
/ypm:help	Show detailed help
/ypm:open	Open project in editor
/ypm:export-community	Export to community version
/ypm:trufflehog-scan	Run TruffleHog security scan

Legacy commands (/ypm:update, /ypm:next, /ypm:active, /ypm:new, /ypm:setup-gitflow) still work and redirect to their skill equivalents.

Data Location

YPM stores all user data in ~/.ypm/:

~/.ypm/
  ├── config.yml           # Your monitoring settings
  └── PROJECT_STATUS.md    # Generated project status

This separation ensures:

• Plugin updates don't affect your configuration
• Easy backup (just backup ~/.ypm/)
• Works across all your projects

---

Documentation

• Detailed Guide (English) - Complete usage guide
• 詳細ガイド（日本語） - 日本語の詳細ガイド
• Security Policy - Security considerations and best practices

---

How It Works

1. Scans directories specified in config.yml
2. Collects Git information (branch, commits, changes)
3. Reads project documentation (CLAUDE.md, README.md, docs/)
4. Generates PROJECT_STATUS.md with categorized project status

---

Project Categories

• 🔥 Active: Updated within 1 week
• 🎨 Planning: In design phase (Phase 0)
• 🚧 In Development: Implementation in progress
• 💤 Inactive: No updates for over 1 month
• 📦 Non-Git: Not a Git repository

---

Requirements

• Claude Code: Required for running YPM
  • Get Claude Code
• Git: For project information collection
• Python 3.8+: For project scanning (included in the plugin)

---

Project Bootstrap Assistant

YPM includes a comprehensive project setup assistant for launching new projects.

What it does:

• Guides you through project planning and requirements definition
• Creates proper directory structure with documentation
• Sets up Git workflow (Git Flow, Worktree support)
• Configures development environment (.gitignore, .claude/settings.json)
• Establishes documentation management rules (DDD, TDD, DRY principles)

How to use:

Say "create a new project" or run /ypm:project-bootstrap in Claude Code. The skill uses Progressive Disclosure to load each phase on-demand, keeping context usage minimal.

---

Configuration

Edit ~/.ypm/config.yml to customize monitoring (created by /ypm:setup):

monitor:
  directories:
    - /path/to/your/projects    # Directories to monitor

  patterns:
    - "proj_*/*"                # Project detection patterns
    - "my-apps/*"