Conversation
Add foundational open source community health files following best practices: - README.md: Comprehensive project overview with features, quick start guide, usage examples for SPARC/agents/PM system, and architecture documentation - CONTRIBUTING.md: Developer guidelines with SPARC methodology, shell script style guide, testing requirements, PR process, and agent coordination - CODE_OF_CONDUCT.md: Contributor Covenant 2.1 community standards - SECURITY.md: Vulnerability reporting process, security policy, and best practices for contributors and users - docs/github-setup-plan.md: Complete implementation roadmap for repository improvements across 4 phases - TODO.md: Task tracking for CCPM integration (pending installation) Phase 1 (Core Community Health Files) complete. Enables community participation and establishes professional project standards. Note: Placeholders need updating (contact emails, repository URLs)
Install complete Claude Code Project Management (CCPM) framework with all components and documentation. CCPM enables spec-driven development using GitHub Issues and Git worktrees for parallel agent execution. ## What Was Added ### Core Framework - ccpm/ directory with complete framework structure - ccpm/scripts/pm/ - 15 executable PM scripts - ccpm/agents/ - Specialized agent definitions - ccpm/commands/ - Command definitions (pm, context, testing) - ccpm/rules/ - Coordination and operation rules - ccpm/hooks/ - Git hooks and integrations ### Documentation - docs/CCPM-README.md - Complete system documentation - docs/CCPM-AGENTS.md - Agent reference guide - docs/CCPM-COMMANDS.md - Full command reference ### Initial PRD - .claude/prds/ccpm-framework-installation.md Comprehensive PRD documenting the installation process, root cause analysis, implementation steps, and validation ## Implementation Details ### Root Cause Previous installation only copied .claude/ directory, missing the executable ccpm/ directory entirely. All PM commands were registered but non-functional due to missing scripts. ### Solution Cloned official CCPM repository (https://github.com/automazeio/ccpm) to temporary location and copied missing ccpm/ directory to project root. Preserved existing .claude/ configurations while adding all required executable components. ### Validation - ✅ All 15 PM scripts execute successfully - ✅ System validation passes (pm:validate) - ✅ Commands accessible via /pm:* interface - ✅ GitHub integration ready (gh CLI + gh-sub-issue) - ✅ Created test PRD and epic demonstrating workflow ## System Capabilities ### PM Commands - PRD Management: prd-new, prd-parse, prd-list, prd-edit, prd-status - Epic Management: epic-decompose, epic-sync, epic-oneshot, epic-show, epic-list - Issue Workflow: issue-start, issue-sync, issue-show, issue-close - Project Status: status, standup, next, blocked, in-progress - Maintenance: validate, clean, search, help ### Benefits Enabled - Spec-driven development (PRD → Epic → Tasks → GitHub → Code) - Parallel execution via git worktrees - Full traceability from requirement to implementation - GitHub Issues as source of truth - Persistent context across work sessions ## Testing Created comprehensive test case documenting this installation: - PRD: ccpm-framework-installation (status: completed) - Epic: ccpm-framework-installation (100% progress) - 10 tasks documenting investigation through validation - Full workflow validated: PRD creation → Epic parsing → Status reporting 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
Add comprehensive GitHub automation and engagement features: GitHub Actions Workflows: - shellcheck.yml: Automated shell script linting with ShellCheck - health-check.yml: Community health file validation (weekly + on changes) - auto-label.yml: Automatic issue/PR labeling by title, content, and files - stale.yml: Stale issue/PR management (60 days stale, 14 days close) Configuration Files: - dependabot.yml: Weekly GitHub Actions dependency updates - FUNDING.yml: Sponsorship platform configuration (template) - CODEOWNERS: Code ownership and automatic review assignment - markdown-link-check-config.json: Link validation configuration Features: - Automatic labeling by type (bug, feature, docs, SPARC, agents) - PR size labeling (XS/S/M/L/XL) - File-based labeling (scripts, docs, workflows, config) - Shell script quality enforcement - Community health monitoring - Markdown link validation - Stale item cleanup with exemptions Phase 2 (Enhanced GitHub Features) complete. Improves automation, code quality, and community engagement. Note: Update placeholders (@YOUR_USERNAME) in CODEOWNERS and configure funding platforms in FUNDING.yml
Add GitHub repository best practices and automation
github-actions
bot
added
documentation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Complete installation of the CCPM (Claude Code Project Management) framework with all components and documentation. CCPM enables spec-driven development using GitHub Issues and Git worktrees for parallel agent execution.
What Was Added
Core Framework
Documentation
Test PRD
Problem Statement
Previous installation only copied
.claude/directory, missing the executableccpm/directory entirely. All PM commands were registered but non-functional due to missing scripts.Solution
Cloned official CCPM repository (https://github.com/automazeio/ccpm) to temporary location and copied missing
ccpm/directory to project root. Preserved existing.claude/configurations while adding all required executable components.Validation
/pm:validate)/pm:*interfacePM Commands Available
PRD Management
/pm:prd-new- Create new PRD through brainstorming/pm:prd-parse- Transform PRD into technical epic/pm:prd-list- List all PRDs/pm:prd-edit- Edit existing PRD/pm:prd-status- Show PRD implementation statusEpic Management
/pm:epic-decompose- Break epic into task files/pm:epic-sync- Push epic and tasks to GitHub/pm:epic-oneshot- Decompose and sync in one step/pm:epic-list- List all epics/pm:epic-show- Display epic and tasks/pm:epic-status- Show epic progressIssue Workflow
/pm:issue-start- Begin work with specialized agent/pm:issue-sync- Push updates to GitHub/pm:issue-show- Display issue details/pm:issue-close- Mark as completeProject Management
/pm:next- Get next priority task/pm:status- Project dashboard/pm:standup- Daily standup report/pm:blocked- Show blocked tasks/pm:in-progress- List work in progressUtilities
/pm:validate- Check system integrity/pm:help- Command reference/pm:sync- Full bidirectional sync/pm:clean- Archive completed workSystem Capabilities Enabled
Testing
Created comprehensive test case documenting this installation:
Files Changed
Breaking Changes
None - This is purely additive functionality.
Migration Notes
No migration needed. CCPM integrates with existing
.claude/structure without modifications.Next Steps After Merge
/pm:prd-newto create feature requirements/pm:statusfor project dashboarddocs/CCPM-*.md/pm:helpReferences
.claude/prds/ccpm-framework-installation.mddocs/CCPM-README.md🤖 Generated with Claude Code