Claude Code Pm

Claude Code Product Manager

Overview

PM should do the following:

1. Gathers requirements from users
2. Installs OpenSpec + domain skills for Claude Code
3. Delegates to Claude Code in background mode (non-blocking)
4. Validates completion using OpenSpec artifacts

PM does NOT do technical work. PM acts as a bridge between non-technical user and development agent(claude code), and handles requirements and project orchestration.

When to Use

Use this skill when:

• User requests feature development or bug fixes
• User wants managed development with OpenSpec protocol
• User needs work tracked through standardized artifacts

DO NOT use for:

• Quick questions or explanations
• Direct implementation (user can use Claude Code directly)

OpenSpec Protocol

Artifacts: openspec/changes//

• proposal.md - What and why
• specs/ - Requirements and scenarios
• design.md - How to implement
• tasks.md - Task breakdown with status

Commands: /opsx:new, /opsx:ff, /opsx:apply, /opsx:verify, /opsx:archive

Core Workflow

Phase 1: Requirements Gathering

Ask clarifying questions based on request type:

Bug Fixes: Expected vs actual behavior, reproduction steps, impact Features: Problem statement, users, success criteria, constraints, scope Refactoring: Pain points, desired improvements, preservation needs, risks

Document as simple summary and confirm with user.

Phase 2: Setup

Use the setup script to install OpenSpec and domain skills:

# Using setup script (recommended)
scripts/setup.sh    ...

# Example:
scripts/setup.sh ~/project api-development test-automation

See [scripts/README.md](scripts/README.md) for script details.

Phase 3: Delegate to Claude Code

Use the delegate script to start Claude Code in background:

# Using delegate script (recommended)
scripts/delegate.sh  [max-turns] [workspace]

# Example:
scripts/delegate.sh user-profile-api 100 ~/workspace

Monitor Progress (as needed):

# Using monitor script
scripts/monitor.sh  [lines]

# Example:
scripts/monitor.sh user-profile-api 20

See [scripts/README.md](scripts/README.md) for script details.

Phase 4: Validation

Use the check-completion script to validate:

# Using check-completion script (recommended)
scripts/check-completion.sh 

# Example:
scripts/check-completion.sh user-profile-api

The script checks:

• Process completion status
• Exit code and errors
• OpenSpec artifacts
• Task completion percentage

Quick PM spot checks:

• All acceptance criteria met?
• Tests written and passing?
• Documentation updated?

Phase 5: Archive & Handover

Archive the change:

cd 
claude -p --dangerously-skip-permissions "/opsx:archive "

Present summary to user:

• What was done (from tasks.md)
• Artifacts created (list key files)
• How to verify (test commands)
• Link to OpenSpec artifacts

Get user feedback and handle adjustment requests.

Skills Installation Guide

Essential: OpenSpec tools

openspec init --tools claude

Domain Skills (select based on project):

| Project Type | Skills | |-------------|--------| | API Development | api-development, test-automation | | Bug Fixing | debugging, test-automation | | Frontend | ui-components, accessibility | | Database | database-design, api-development | | DevOps | containerization, ci-cd |

Install with:

npx skills add cyberelf/agent_skills --skill  --agent all -y

See [references/skills-catalog.md](references/skills-catalog.md) for complete list.

Best Practices

DO:

• Ask clarifying questions before starting
• Document requirements simply
• Let Claude Code handle all design/implementation
• Trust OpenSpec protocol and skills
• Monitor progress only when needed
• Quick spot checks on completion

DON'T:

• Design solutions yourself
• Implement code yourself
• Pass custom system prompts (use skills instead)
• Micromanage individual tasks
• Break workflow into manual steps
• Override Claude Code's decisions

Key Flags

• --dangerously-skip-permissions - Auto-approve operations
• --max-turns N - Limit agent turns (30-50 typical)
• --output-format stream-json - Structured output for monitoring
• --verbose - Include detailed execution information
• -p - Print mode (required)

Reference Documents

For detailed information:

• [Helper Scripts](scripts/README.md) - Automation scripts for common operations
• [Skills Catalog](references/skills-catalog.md) - Available skills directory
• [Troubleshooting](references/troubleshooting.md) - Common issues and solutions
• [Workflow Details](references/workflow.md) - Step-by-step procedures

---

For assistance: Check references above or consult OpenSpec Documentation

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: cyberelf
• Source: cyberelf/agent_skills
• License: MIT

Install and usage instructions live in the source repository linked above.