| name | use-pmc |
| description | Use PMC (Project Manager Claude) CLI for workflow orchestration. Use this skill when running workflows, creating new projects, syncing docs with implementation, or managing project planning. |
Use PMC
PMC is a workflow orchestration CLI for Claude Code. It manages project planning, ticket implementation, and documentation sync.
Reference Documentation
| Reference | When to Read |
|---|
references/how-to-use-pmc.md | Running workflows, CLI commands, available workflows |
references/how-to-create-workflow.md | Creating custom workflow definitions |
Prerequisites
PMC must be available from the repository root:
cd <repo-root>
uv sync
Quick Reference
List Available Workflows
pmc list
Run a Workflow
pmc run <workflow-name>
pmc run <workflow-name> -i working_dir=/path/to/project
pmc run <workflow-name> -v
pmc run <workflow-name> --dry-run
Note: working_dir defaults to . (current directory) when not specified.
Common Workflows
| Workflow | Purpose | Command |
|---|
pm.init-project | Initialize planning from PRD | pmc run pm.init-project |
pm.analyze-gaps | Compare codebase vs PRD | pmc run pm.analyze-gaps |
pm.sync-prd | Update PRD from implementation | pmc run pm.sync-prd |
pm.sync-planning | Create tickets for unbuilt features | pmc run pm.sync-planning |
scaffold.workflow | Bootstrap new projects | pmc run scaffold.workflow -i project_name=... -i target_dir=... |
Typical Workflows
Initialize New Project
pmc new my-project --stack python-uv
pmc run pm.init-project -i working_dir=./my-project
Sync Documentation with Implementation
pmc run pm.analyze-gaps
pmc run pm.sync-prd
pmc run pm.sync-planning
Project Management
pmc projects list
pmc projects info my-project
pmc projects switch my-project
pmc projects stacks
Check Status
pmc status
pmc status --ticket T00001
pmc tasks
Workflow Validation
Before running a new or modified workflow:
pmc validate <workflow-name>
pmc validate <workflow-name> --check-deps
CLI Options
| Option | Description |
|---|
-i, --input KEY=VALUE | Pass input variables |
--dry-run | Preview without executing |
-v, --verbose | Show detailed output |
-q, --quiet | Minimal output |
--log-file PATH | Write logs to file |
--workflows-dir PATH | Override workflows directory |
When to Use PMC
Use PMC workflows when:
- Initializing a project -
pm.init-project sets up docs structure from PRD
- Documentation drift -
pm.analyze-gaps finds discrepancies
- Updating docs -
pm.sync-prd and pm.sync-planning fix documentation
- Creating new projects -
pmc new scaffolds with templates
- Orchestrating ticket work - Supervisor/ticket workflows automate implementation
Troubleshooting
Workflow Not Found
pmc list
pmc validate path/to/workflow.json
Missing Inputs
If running from a different directory, specify working_dir:
pmc run pm.init-project -i working_dir=/path/to/project
Dependency Errors
Check sub-workflow dependencies exist:
pmc validate my.workflow --check-deps
View Detailed Logs
pmc run my.workflow -v --log-file ./pmc.log
Critical Rules
- Run from repo root - PMC defaults
working_dir to current directory
- Check PRD first - Ensure
docs/1-prd/ has requirements before pm.init-project
- Validate before running - Use
pmc validate for custom workflows
- Review discrepancies - Check
99-discrepancies.md after pm.analyze-gaps
- Specify working_dir explicitly - Only needed when running from a different location