mirror of https://github.com/automazeio/ccpm.git synced 2025-10-09 13:41:06 +03:00

Files

Ran Aroussi 4d4f88868e Major Cleanup & Issue Resolution - 2025-01-24 (#953 )

* feat: Major cleanup and issue resolution - 2025-01-24 release

✨ NEW FEATURES:
- Add comprehensive LOCAL_MODE.md guide for offline workflow
- Auto-create GitHub labels (epic, task) during init
- Modernize PM command syntax with !bash pattern
- Add context accuracy safeguards with self-verification
- Create comprehensive CHANGELOG.md documentation

🔧 IMPROVEMENTS:
- Update 4 core PM commands to use efficient !bash syntax
- Enhance init.sh with automatic GitHub label creation
- Document context accuracy improvements in CONTEXT_ACCURACY.md
- Streamline command definitions for better token efficiency

📊 IMPACT:
- Resolves 10+ GitHub issues with comprehensive solutions
- Enables true local-only development workflow
- Reduces AI hallucination in context generation
- Improves Claude Code compatibility and performance

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

* fix: improve GitHub detection and error handling in init.sh

Address GitHub Copilot feedback for better robustness:

🔧 IMPROVED REPOSITORY DETECTION:
- Replace string matching with `gh repo view` for robust detection
- Handles SSH URLs, GitHub Enterprise, and edge cases properly
- Graceful fallback for non-GitHub repositories

🛡️ ENHANCED ERROR HANDLING:
- Replace silent failures with meaningful user feedback
- Track label creation success/failure individually
- Check for existing labels before reporting errors
- Clear status messages: success, partial, or failure

🧪 TESTED:
- Bash syntax validation passed
- Repository detection logic verified
- Error handling scenarios tested

Addresses high and medium priority feedback from Copilot review.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

---------

Co-authored-by: Claude <noreply@anthropic.com>

2025-09-24 14:47:09 +01:00

3.3 KiB

Raw Blame History

CCPM Local Mode

CCPM works perfectly in local-only mode without any GitHub integration. All management is done through local markdown files.

Local-Only Workflow

1. Create Requirements (PRD)

/pm:prd-new user-authentication

Creates: .claude/prds/user-authentication.md
Output: Complete PRD with requirements and user stories

2. Convert to Technical Plan (Epic)

/pm:prd-parse user-authentication

Creates: .claude/epics/user-authentication/epic.md
Output: Technical implementation plan

3. Break Down Into Tasks

/pm:epic-decompose user-authentication

Creates: .claude/epics/user-authentication/001.md, 002.md, etc.
Output: Individual task files with acceptance criteria

4. View Your Work

/pm:epic-show user-authentication    # View epic and all tasks
/pm:status                           # Project dashboard
/pm:prd-list                         # List all PRDs

5. Work on Tasks

# View specific task details
cat .claude/epics/user-authentication/001.md

# Update task status manually
vim .claude/epics/user-authentication/001.md

What Gets Created Locally

.claude/
├── prds/
│   └── user-authentication.md      # Requirements document
├── epics/
│   └── user-authentication/
│       ├── epic.md                 # Technical plan
│       ├── 001.md                  # Task: Database schema
│       ├── 002.md                  # Task: API endpoints
│       └── 003.md                  # Task: UI components
└── context/
    └── README.md                   # Project context

Commands That Work Locally

✅ Fully Local Commands

/pm:prd-new <name> - Create requirements
/pm:prd-parse <name> - Generate technical plan
/pm:epic-decompose <name> - Break into tasks
/pm:epic-show <name> - View epic and tasks
/pm:status - Project dashboard
/pm:prd-list - List PRDs
/pm:search <term> - Search content
/pm:validate - Check file integrity

🚫 GitHub-Only Commands (Skip These)

/pm:epic-sync <name> - Push to GitHub Issues
/pm:issue-sync <id> - Update GitHub Issue
/pm:issue-start <id> - Requires GitHub Issue ID
/pm:epic-oneshot <name> - Includes GitHub sync

Benefits of Local Mode

✅ No external dependencies - Works without GitHub account/internet
✅ Full privacy - All data stays local
✅ Version control friendly - All files are markdown
✅ Team collaboration - Share .claude/ directory via git
✅ Customizable - Edit templates and workflows freely
✅ Fast - No API calls or network delays

Manual Task Management

Tasks are stored as markdown files with frontmatter:

---
name: Implement user login API
status: open          # open, in-progress, completed
created: 2024-01-15T10:30:00Z
updated: 2024-01-15T10:30:00Z
parallel: true
depends_on: [001]
---

# Task: Implement user login API

## Description
Create POST /api/auth/login endpoint...

## Acceptance Criteria
- [ ] Endpoint accepts email/password
- [ ] Returns JWT token on success
- [ ] Validates credentials against database

Update the status field manually as you work:

open → in-progress → completed

That's it! You have a complete project management system that works entirely offline.

3.3 KiB Raw Blame History