CCPM Optimal - Clean Claude Code Project Management

Zero-Command Automation for modern development workflows with GitHub integration.

🚀 Quick Start

1. Install CCPM

# Copy template to your project
cp -r ccpm-optimal/* your-project/
cd your-project

# Install automation hooks
./.claude/scripts/install-hooks.sh

2. Create Your First Epic

# Only command you'll ever need to remember
/new user-auth "Implement user authentication system"

3. Code Normally

# Just code and commit - everything else is automatic
git add .
git commit -m "feat(auth): implement login component"
git push

# 🤖 Auto-sync handles:
# - Progress tracking
# - GitHub issue updates
# - PR creation at 100% completion
# - Auto-merge when CI passes

🎯 Core Philosophy

Zero commands after /new. Everything happens automatically through your normal git workflow.

What CCPM Does Automatically

• ✅ Progress Tracking: File-based completion detection
• ✅ GitHub Sync: Issue updates, PR creation, auto-merge
• ✅ Quality Gates: Progressive validation without blocking workflow
• ✅ Memory Sync: Context preservation in Supermemory/OpenMemory
• ✅ CI/CD Integration: GitHub Actions with simplified testing

🆕 Enhanced Features (Optional)

• ✨ Intelligent Comments: No-spam GitHub issue updates (updateable comments)
• 🎯 Deliverable Tracking: Smart detection of which files actually changed
• 🔄 Enhanced Auto-sync: Better logging, error handling, and reliability
• 📝 GitHub Templates: Issue and PR templates for consistent workflow

What You Do

1. /new epic-name "description" (once per epic)
2. Code and commit normally
3. Push when ready
4. Done! 🎉

📁 System Architecture

5 Core Rules (Not 38 Commands)

.claude/rules/
├── auto-sync.md        # Zero-command automation
├── ci-integration.md   # GitHub Actions CI/CD
├── git-workflow.md     # Standard branches + PR automation
├── memory-sync.md      # Supermemory integration
└── quality-gates.md    # Progressive validation

6 Simplified Agents

.claude/agents/
├── project-manager.md     # Epic coordination
├── simple-tester.md       # Streamlined testing (no CI blocking)
├── code-analyzer.md       # Bug tracing with Serena
├── frontend-specialist.md # Modern frontend patterns
├── backend-specialist.md  # API and service architecture
└── security-specialist.md # Security review and auditing

5 Core Commands

.claude/commands/
├── new.md      # /new - Create epic (only manual command)
├── start.md    # /start - Load context for existing epic
├── status.md   # /status - Check progress (no automation)
├── sync.md     # /sync - Force GitHub sync if needed
└── close.md    # /close - Archive completed epic

Auto-Sync Engine

.claude/scripts/
├── auto-sync-engine.sh    # Core automation logic
├── hooks/
│   ├── post-commit        # Trigger after each commit
│   └── pre-push          # Final sync before push
└── install-hooks.sh      # Setup automation

🛠️ Tool Integration

Preferred Tools (Pre-configured)

• 💭 Supermemory: Context + decisions auto-sync
• 🔍 Serena: Code analysis (find_symbol, search_for_pattern)
• ✨ Zen: Complex decisions + quality review
• 🧠 MorphLLM: Multi-model consensus for architecture
• 📝 OpenMemory: Session context preservation

CI/CD Stack

• GitHub Actions: Native CI with progressive quality gates
• Auto-merge: PR automation when tests pass
• Branch Protection: Standard git workflow
• Quality Gates: Fast feedback, never blocking

📊 Progress Tracking

File-Based Completion Detection

{
  "deliverables": [
    {
      "pattern": "src/components/AuthComponent.vue",
      "required": true,
      "description": "Authentication component"
    },
    {
      "pattern": "tests/auth.test.js",
      "required": true,
      "description": "Test coverage"
    }
  ]
}

Automatic GitHub Integration

• Issue Comments: Progress updates after each commit
• PR Creation: Auto-created at 100% completion
• Auto-merge: Enabled when CI passes
• Milestone Sync: Epic progress tracking

🔄 Workflow Example

Epic Lifecycle

# 1. Create epic (only manual command)
/new bike-gallery "Interactive bike photo gallery"

# 2. CCMP creates:
# - .claude/epics/bike-gallery/deliverables.json
# - feature/bike-gallery branch
# - GitHub issue #123
# - Auto-sync configuration

# 3. Normal development
git add src/components/BikeGallery.vue
git commit -m "feat(gallery): add bike photo component"
# 🤖 Auto-sync: Updates GitHub issue "33% complete"

git add src/pages/gallery.astro
git commit -m "feat(gallery): add gallery page"
# 🤖 Auto-sync: Updates GitHub issue "67% complete"

git add tests/gallery.test.js
git commit -m "test(gallery): add comprehensive tests"
# 🤖 Auto-sync: Updates GitHub issue "100% complete"
# 🤖 Auto-sync: Creates PR with auto-merge label

git push origin feature/bike-gallery
# 🤖 CI/CD: Runs quality gates
# 🤖 Auto-merge: Merges PR when tests pass
# 🤖 GitHub: Closes issue #123
# 🤖 Cleanup: Deletes feature branch

⚙️ Configuration

Minimal Setup Required

{
  "auto_sync": {
    "enabled": true,
    "github_integration": true,
    "supermemory_integration": true
  },
  "github": {
    "auto_merge": true,
    "target_branch": "main"
  }
}

GitHub CLI Setup

# Required for GitHub integration
gh auth login

🆕 Enhanced Features Configuration

To enable the new intelligent features, add these optional configurations:

{
  "auto_sync": {
    "enabled": true,
    "github_integration": true,
    "supermemory_integration": true,
    "intelligent_comments": {
      "enabled": true,
      "update_existing": true,
      "include_deliverable_changes": true,
      "pr_issue_linking": true
    },
    "deliverable_tracking": {
      "enabled": true,
      "change_detection": true,
      "commit_analysis": true
    }
  },
  "github": {
    "auto_merge": true,
    "target_branch": "main",
    "issue_management": {
      "auto_update_comments": true,
      "milestone_comments": true,
      "pr_issue_linking": true
    }
  }
}

Benefits:

• intelligent_comments: Eliminates comment spam by updating existing comments instead of creating new ones
• deliverable_tracking: Only triggers GitHub updates when actual deliverables change
• Enhanced error handling: Better logging and fallback mechanisms

🚨 Emergency Procedures

Disable Auto-Merge

# Create emergency stop file
touch .github/auto-merge-disabled
git commit -m "emergency: disable auto-merge"

Manual Sync Recovery

# If auto-sync fails
/sync epic-name --force

# Check auto-sync logs
tail -f .claude/logs/auto-sync.log

🤝 Contributing

This is a clean template. Copy to your projects and adapt as needed.

CCPM Optimal: The CCPM system that actually works. 🚀

---

Zero commands. Maximum automation. Pure focus on coding.