tomevault-io CCPM - Claude Code Project Manager
A spec-driven development workflow: PRD → Epic → GitHub Issues → Parallel Agents → Shipped Code.
Core Philosophy
Requirements live in files, not heads. Every feature starts as a PRD, becomes a technical epic, decomposes into GitHub issues, and gets executed by parallel agents with full traceability.
File Conventions
Before doing anything, read references/conventions.md for path standards, frontmatter schemas, and GitHub operation rules. These apply to all phases.
The Five Phases
1. Plan — Capture requirements
When: User wants to define a new feature, product requirement, or scope of work.
Read: references/plan.md
Covers: Writing PRDs through guided brainstorming, converting PRDs to technical epics.
2. Structure — Break it down
When: An epic exists and needs to be decomposed into concrete tasks.
Read: references/structure.md
Covers: Epic decomposition into numbered task files with dependencies and parallelization.
3. Sync — Push to GitHub
When: Local epic/tasks need to become GitHub issues, progress needs to be posted as comments, or a bug is found and needs a linked issue created.
Read: references/sync.md
Covers: Epic sync (epic + tasks → GitHub issues), issue sync (progress comments), closing issues/epics, bug reporting against completed issues.
4. Execute — Start building
When: User wants to start working on one or more GitHub issues with parallel agents.
Read: references/execute.md
Covers: Issue analysis (parallel work stream identification), launching parallel agents, coordinating worktrees.
5. Track — Know where things stand
When: User asks for status, standup report, what's blocked, what's next, or needs to validate state.
Read: references/track.md
Covers: Status, standup, search, in-progress, next priority, blocked items, validation.
Script-First Rule
For deterministic operations — anything that reads and reports without needing reasoning — always run the bash script directly rather than doing the work manually:
| What the user wants | Script to run |
|---|---|
| Project status | bash references/scripts/status.sh |
| Standup report | bash references/scripts/standup.sh |
| List all epics | bash references/scripts/epic-list.sh |
| Show epic details | bash references/scripts/epic-show.sh <name> |
| Epic status | bash references/scripts/epic-status.sh <name> |
| List PRDs | bash references/scripts/prd-list.sh |
| PRD status | bash references/scripts/prd-status.sh |
| Search issues/tasks | bash references/scripts/search.sh <query> |
| What's in progress | bash references/scripts/in-progress.sh |
| What's next | bash references/scripts/next.sh |
| What's blocked | bash references/scripts/blocked.sh |
| Validate project state | bash references/scripts/validate.sh |
Use the LLM for work that requires reasoning: writing PRDs, analyzing parallelism, launching agents, synthesizing updates.
Quick Reference
Plan a feature: "I want to build X" or "create a PRD for X"
Parse to epic: "turn the X PRD into an epic"
Decompose: "break down the X epic into tasks"
Sync to GitHub: "push the X epic to GitHub"
Start an issue: "start working on issue 42"
Check status: "what's our status" / "standup"
What's next: "what should I work on next"
Merge epic: "merge the X epic"
Report a bug: "found a bug in issue 42" / "testing issue 42 revealed X"
Source: automazeio/ccpm — distributed by TomeVault.