Requirements Expert Plugin for Claude Code
A comprehensive requirements management plugin that guides users through the full requirements lifecycle using GitHub Projects for complete traceability and collaboration.
Overview
The Requirements Expert plugin helps you transform vague ideas into fully-structured, actionable requirements using a proven methodology:
Vision → Epics → User Stories → Tasks
Everything is managed in GitHub Projects with full parent/child hierarchy, making your entire product roadmap visible and trackable in one place.
Features
- Interactive Discovery: Guided Q&A sessions for each phase using best practices
- Full Lifecycle Support: Vision → Epics → Stories → Tasks with feedback loops
- GitHub Projects Integration: All requirements stored as GitHub issues in GitHub Projects with true hierarchy
- MoSCoW Prioritization: Built-in prioritization framework at every level
- Automated Validation: Quality checks for completeness, consistency, and best practices
- Workflow Orchestration: Seamlessly move from one phase to the next with guided automation
Prerequisites
- Claude Code: Install from claude.com/product/claude-code
- GitHub CLI (
gh): Installed and authenticated (gh auth login)
- Git repository: A GitHub repository where you want to track requirements
- GitHub permissions:
repo and project scopes (read/write)
Verify setup:
gh auth status # Should show ✓ Logged in and list scopes
If project scope is missing, add it:
gh auth refresh -s project
Installation
Local Development
# Clone the repository
git clone https://github.com/sjnims/requirements-expert.git
cd requirements-expert
# Load the plugin (note: plugin root is in plugins/ subdirectory)
claude --plugin-dir plugins/requirements-expert
From Marketplace
In Claude Code, run:
/install-plugin sjnims/requirements-expert
This installs the plugin from the GitHub marketplace.
Quick Start
1. Initialize a New Project
/re:init
Creates a GitHub Project for your repository with custom fields (Type, Priority, Status). Provides instructions for configuring project views manually.
2. Discover Your Vision
/re:discover-vision
Interactive Q&A session that helps you articulate:
- Problem statement
- Target users
- Success metrics
- Core value proposition
Creates a Vision issue in your GitHub Project.
3. Identify Epics
/re:identify-epics
Analyzes your vision and guides you through identifying major features/capabilities. Creates Epic issues as children of the Vision issue.
4. Create User Stories
/re:create-stories
Select an epic and break it down into user stories following INVEST criteria. Creates Story issues as children of the Epic.
5. Define Tasks
/re:create-tasks
Break a story into concrete tasks with acceptance criteria. Creates Task issues as children of the Story.
6. Prioritize
/re:prioritize
Use MoSCoW framework (Must/Should/Could/Won't) to prioritize at any level.
7. Review & Validate
/re:review
Runs automated validation checks:
- Completeness (all required sections present)
- Consistency (proper linking, no orphans)
- Quality (INVEST criteria for stories, clear acceptance criteria)
- Traceability (vision → epic → story → task chain)
8. Check Status
/re:status
View project overview:
- Counts by type (X epics, Y stories, Z tasks)
- Completion status
- Validation results
- Recent activity
GitHub Projects Structure
All requirements are stored as GitHub issues in GitHub Projects with this hierarchy:
📋 Vision (Issue, Type: Vision)
├── 🎯 Epic 1 (Child Issue, Type: Epic)
│ ├── 📝 Story 1 (Child Issue, Type: Story)
│ │ ├── ✅ Task 1 (Child Issue, Type: Task)
│ │ └── ✅ Task 2 (Child Issue, Type: Task)
│ └── 📝 Story 2 (Child Issue, Type: Story)
│ └── ✅ Task 3 (Child Issue, Type: Task)
└── 🎯 Epic 2 (Child Issue, Type: Epic)
└── 📝 Story 3 (Child Issue, Type: Story)
└── ✅ Task 4 (Child Issue, Type: Task)
Custom Fields
sjnims