feat: Add Jira filter creation with guided JQL query building

[spindle79]

Summary

Adds the ability to create saved Jira filters with interactive, guided JQL query building.

Features

New Command: /jira-filter-create

• Create Jira filters with or without existing JQL
• Interactive query building through guided questions
• Query validation before filter creation
• Configurable visibility (private or shared)

Interactive Query Building

The agent asks targeted questions to build the perfect JQL query:

1. Project Scope

   • Single project (e.g., PROJ)
   • Multiple projects (e.g., PROJ1, PROJ2)
   • All accessible projects

2. Issue Types

   • All types or specific (Story, Bug, Task, Epic, Sub-task)

3. Status/Workflow

   • Open issues only
   • Specific statuses (To Do, In Progress, Done, etc.)
   • Exclude certain statuses

4. Assignee/Team

   • Current user
   • Specific users/team members
   • Unassigned
   • All assignees

5. Additional Criteria (optional)

   • Priority levels
   • Labels or components
   • Date ranges (created, updated, due)
   • Text search
   • Custom fields

Query Validation

Before creating the filter:

• ✅ Tests JQL query against Jira API
• ✅ Shows total count of matching issues
• ✅ Displays first 5-10 sample results
• ✅ Confirms results match user expectations
• ✅ Only creates filter after confirmation

Components Added

1. Agent: jira-filter-creator.md

   • Guides users through building JQL queries
   • Validates queries before filter creation
   • Creates filters with appropriate settings
   • Provides JQL syntax help and examples

2. Command: jira-filter-create.md

   • User-invokable interface
   • Accepts optional JQL query parameter
   • Interactive mode for guided building
   • Comprehensive examples and documentation

Usage Examples

Interactive Mode (Guided Building)

/jira-filter-create

# Agent asks questions to build query
# Example output:
# project = ALPHA AND type = Bug AND status in ("To Do", "In Progress") AND assignee in (user1, user2)

With Existing JQL

/jira-filter-create "project = PROJ AND type = Bug AND status != Done"

Common Patterns

# Personal work queue
/jira-filter-create "assignee = currentUser() AND status not in (Done, Closed)"

# Team bugs
/jira-filter-create "project = PROJ AND type = Bug AND assignee in (user1, user2)"

# High priority unassigned
/jira-filter-create "assignee is EMPTY AND priority in (High, Critical) AND status != Done"

# Current sprint issues
/jira-filter-create "sprint in openSprints() AND project = PROJ"

Output After Creation

Users receive:

• ✅ Filter name
• 🔗 Filter URL (direct link)
• 🆔 Filter ID (for use with other commands like /jira-retro)
• 👁️ Visibility setting
• 📝 Auto-generated description

Benefits

For Beginners:

• No need to know JQL syntax
• Guided questions make it easy
• Examples provided throughout

For Power Users:

• Paste existing JQL queries
• Quick validation before creation
• Consistent filter management

For Teams:

• Share filters with project members
• Standardize common queries
• Reuse filters in automation and other tools

Version Updates

• aai-pm-jira plugin: 1.0.0 → 1.1.0
• Marketplace: 1.0.2 → 1.0.3
• Added keywords: filters, jql
• Updated descriptions

Testing

✅ Plugin structure validated with node scripts/validate-plugins.js
✅ Manifests updated and regenerated
✅ All files follow Claude Code plugin standards

To Test

# Start Claude with the plugin
claude --plugin-dir ./plugins/aai-pm-jira

# Test interactive mode
/jira-filter-create

# Test with JQL
/jira-filter-create "project = TEST AND status = Open"

Prerequisites: Atlassian MCP server configured with valid Jira credentials and filter creation permissions

Files Changed

• ✨ plugins/aai-pm-jira/agents/jira-filter-creator.md (new)
• ✨ plugins/aai-pm-jira/commands/jira-filter-create.md (new)
• 📝 plugins/aai-pm-jira/.claude-plugin/plugin.json (version bump, keywords)
• 📝 .claude-plugin/marketplace.json (version bump, description update)
• 📝 plugin-manifest.json (regenerated)

Integration with Other Commands

The created filters can be used with:

• /jira-retro - Use filter ID for retrospectives
• Jira automation - Reference filters by ID
• Other Jira tools and APIs

🤖 Generated with Claude Code