prd-workflow

Claude Code Plugin Marketplace

A portable plugin marketplace for Claude Code, featuring a comprehensive PRD (Product Requirements Document) workflow system.

Overview

This marketplace provides plugins that extend Claude Code with structured workflows, commands, and automation. The flagship plugin is prd-workflow, which offers a complete system for creating, planning, and implementing product requirements.

Installation

Prerequisites

Ensure you have the required dependencies installed. See DEPENDENCIES.md for detailed installation instructions.

Required:

• jq - JSON parsing
• yq - YAML parsing
• check-jsonschema - Schema validation

Optional:

• glow - Markdown rendering
• Exa MCP server - For research capabilities

Quick Install Dependencies

macOS (Homebrew):

brew install jq yq
pip install check-jsonschema

Ubuntu/Debian:

apt install jq
snap install yq  # or: pip install yq
pip install check-jsonschema

Arch Linux:

pacman -S jq yq
pip install check-jsonschema

Installing the Plugin

Once Claude Code supports plugin marketplaces, you can install via:

/plugin marketplace add /path/to/jackbot-ai
/plugin install prd-workflow

Until then, you can manually symlink or copy the plugin contents to your Claude configuration.

Available Plugins

prd-workflow

A complete PRD workflow system with three main phases:

1. Create - Gather requirements and create structured PRD documents
2. Plan - Analyze, research, and define detailed task specifications
3. Work - Implement defined tasks with tracking and logging

Features

• Agents: Specialized subagents for research and implementation
• Commands: Git rebase with intelligent conflict resolution
• Hooks: Automatic validation of task and research YAML files
• Skills: Full PRD workflow with routing logic
• Scripts: CLI tools for task and research management

Usage

# Create a new PRD
/prd create my-feature

# Plan an existing PRD (research and task definition)
/prd plan my-feature

# Work on a planned PRD (implementation)
/prd work my-feature

# Check PRD status (scripts are relative to the skill directory)
scripts/list-prds.sh
scripts/task-status.sh my-feature

Directory Structure

cc-prd/
├── .claude-plugin/
│   └── marketplace.json       # Marketplace catalog
├── plugins/
│   └── prd-workflow/          # PRD workflow plugin
│       ├── .claude-plugin/
│       │   └── plugin.json    # Plugin configuration
│       ├── agents/            # Subagent definitions
│       ├── commands/          # Custom commands
│       ├── hooks/             # Validation hooks
│       ├── skills/            # Skill definitions
│       ├── specs/             # JSON schemas
│       └── scripts/           # Utility scripts
├── README.md
└── DEPENDENCIES.md

Configuration

Exa MCP Server (Optional)

The prd-researcher agent uses Exa MCP tools for web research. To enable:

1. Get an API key from Exa AI
2. Configure the Exa MCP server in your Claude settings
3. Set EXA_API_KEY environment variable

Without Exa, the research features will gracefully degrade with appropriate error messages.

Hooks

Hooks automatically validate tasks.yaml and research.yaml files when edited. They require jq, yq, and check-jsonschema to be installed.

If dependencies are missing, hooks will log a warning but won't block operations.

PRD File Structure

PRDs are stored in .claude/prds/<prd-name>/:

.claude/prds/my-feature/
├── PRD.md              # Main requirements document
├── tasks.yaml          # Task definitions
├── research.yaml       # Research questions (optional)
├── log.md              # Implementation log
└── specs/              # Task specification files
    └── task-name.md

Scripts

Scripts are located in plugins/prd-workflow/skills/prd/scripts/ and are invoked relative to the skill directory.

Script	Description
scripts/list-prds.sh	List all PRDs with status
scripts/task-status.sh <prd>	Get task counts by status
scripts/get-task.sh <prd> <task>	Get full task details
scripts/list-prd-draft-tasks.sh <prd>	List tasks needing specs
scripts/list-defined-tasks.sh <prd>	List tasks ready to implement
scripts/update-task-status.sh <prd> <task> <status>	Update task status
scripts/research-status.sh <prd>	Get research completion status
scripts/get-unanswered-research.sh <prd>	Get pending research questions

Credits

Adapted from fullykubed/nixos-config - converted from NixOS-specific configuration to a portable plugin format.

License

MIT