@cloudkinetix/bmad-enhanced
Version:
Cloud-Kinetix enhanced fork of BMAD-METHOD - Breakthrough Method of Agile AI-driven Development with robust versioning and unified validation.
231 lines (201 loc) • 9.21 kB
YAML
# JIRA Project Configuration Template
# This file should be copied to .bmad-workspace/config/jira-project-{PROJECT_KEY}.yml
# and customized for your specific project
project:
key: PROJ # Your JIRA project key
url: https://company.atlassian.net # Your JIRA instance URL
name: "Project Name" # Human-readable project name
# Custom field mappings (auto-detected or manually specified)
fields:
epic_link: customfield_10014 # Epic link field ID
sprint: customfield_10020 # Sprint field ID
story_points: customfield_10016 # Story points field ID
acceptance_criteria: customfield_10025 # Acceptance criteria field
technical_notes: customfield_10030 # Technical notes field
# Repository configuration
repository:
url: https://github.com/company/repo # Repository URL
type: github # github|gitlab|bitbucket|azure
default_branch: main # Default branch name
doc_path: docs/stories/ # Path to BMAD stories
# Synchronization settings
sync:
mode: light # light|full
auto_status: true # Auto-update status from JIRA
create_links: true # Add links between JIRA and Git
sync_comments: false # Sync comments (full mode only)
conflict_strategy: jira_wins # jira_wins|git_wins|manual
# Work tracking settings
work_tracking:
# Upload settings
upload:
auto_link: true # Auto-link related issues
notify_mentions: true # Notify @mentioned users
preserve_formatting: true # Keep markdown formatting
add_metadata: true # Add upload timestamp/author
# Template settings
templates:
universal: work-documentation.md # Single template for all documentation
use_templates: true # false = pure LLM intelligence
match_team_style: true # Learn from existing docs
# Label conventions
conventions:
bug_labels:
- bug
- needs-analysis
- root-cause-analysis
retro_labels:
- retrospective
- sprint-{number} # {number} replaced with sprint
decision_labels:
- architecture
- decision
- adr
review_labels:
- code-review
- needs-review
- reviewed
planning_labels:
- sprint-planning
- capacity-planning
test_labels:
- test-report
- test-results
- qa-complete
# Attachment handling
attachments:
download_path: .bmad-workspace/attachments/ # Where to store downloads
max_size_mb: 50 # Max attachment size to download
auto_download: true # Auto-download on analysis start
file_types: # File types to auto-download
- "*.log"
- "*.txt"
- "*.json"
- "*.xml"
- "*.csv"
- "screenshot*"
- "error*"
# Team settings
team:
time_zone: "America/New_York" # Team timezone for planning
sprint_length: 2 # Sprint length in weeks
sprint_start_day: "Monday" # Sprint start day
# Team member mappings (JIRA username → display name)
members:
john.doe: "John Doe"
jane.smith: "Jane Smith"
# Role assignments for mentions
roles:
scrum_master: john.doe
product_owner: jane.smith
tech_lead: john.doe
# Integration settings
integrations:
# Confluence settings (if using for documentation)
confluence:
enabled: true
space_key: PROJ # Confluence space key
parent_page_id: "12345" # Parent page for documents
# Slack notifications (optional)
slack:
enabled: false
webhook_url: "" # Slack webhook URL
channels:
bugs: "#project-bugs"
reviews: "#code-reviews"
planning: "#sprint-planning"
# Quality gates
quality:
# Minimum requirements for uploads
bug_analysis:
require_root_cause: true # Must identify root cause
require_impact: true # Must assess impact
require_fix_plan: true # Must propose fix
code_review:
require_test_check: true # Must verify tests
require_security_check: true # Must check security
sprint_retro:
require_metrics: true # Must include metrics
require_actions: true # Must have action items
# JIRA Cleanup Rules
cleanup_rules:
# Stale issue detection
stale_threshold:
days: 90 # Days without updates to consider stale
exclude_statuses: [Blocked, Waiting] # Statuses to exclude from stale detection
exclude_labels: [keep-active, important] # Labels to exclude from cleanup
exclude_components: [] # Components to exclude
# Orphaned issue handling
orphan_detection:
require_bmad_reference: true # Issues must have BMAD documentation
auto_create_documentation: false # Auto-create missing BMAD docs
archive_legacy_items: true # Archive pre-BMAD issues
legacy_cutoff_date: "2024-01-01" # Date before which issues are legacy
# Duplicate detection
duplicate_detection:
similarity_threshold: 0.8 # Minimum similarity to flag as duplicate
auto_merge_threshold: 0.95 # Auto-merge above this threshold
manual_review_threshold: 0.7 # Manual review above this threshold
check_fields: [summary, description, component] # Fields to compare
# Data quality rules
data_quality:
required_fields: [priority, component] # Fields that must have values
auto_populate: true # Auto-populate missing values
validation_rules: strict # strict|moderate|lenient
normalize_values: true # Standardize field values
# Sprint hygiene
sprint_hygiene:
auto_close_completed: true # Close sprints at 100% completion
move_incomplete_to_backlog: true # Move incomplete items to backlog
archive_old_sprints: true # Archive sprints older than threshold
sprint_archive_threshold_days: 30 # Days after end to archive sprint
# Attachment management
attachment_management:
max_attachment_age_days: 365 # Remove attachments older than this
compress_large_files: true # Compress attachments >10MB
remove_duplicates: true # Remove duplicate attachments
archive_resolved_attachments: true # Archive attachments from resolved issues
# Backup settings
backup_settings:
automatic_backup: true # Auto-backup before cleanup
backup_retention_days: 30 # Keep backups for this many days
verify_integrity: true # Verify backup integrity
compress_backups: true # Compress backup files
backup_location: .bmad-workspace/cleanup/backups/ # Backup storage location
# Approval workflow
approval_workflow:
low_risk_auto_approve: true # Auto-approve low-risk operations
medium_risk_reviewers: [team-lead] # Reviewers for medium-risk operations
high_risk_reviewers: [project-manager, stakeholder] # Reviewers for high-risk
require_confirmation: true # Require explicit confirmation
notification_channels: [email, jira] # How to notify about cleanups
# Safety settings
safety:
max_issues_per_batch: 100 # Maximum issues to process at once
require_preview: true # Always preview changes first
rollback_enabled: true # Enable rollback functionality
dry_run_default: true # Default to dry run mode
# Scheduling
schedule:
frequency: weekly # never|weekly|monthly|quarterly
day: Sunday # Day of week to run
time: "02:00" # Time to run (24-hour format)
timezone: "UTC" # Timezone for scheduling
# Advanced settings
advanced:
# API rate limiting
rate_limit:
requests_per_minute: 30 # API request limit
retry_after_seconds: 60 # Retry delay
# Caching
cache:
enabled: true # Cache JIRA data locally
ttl_minutes: 15 # Cache time-to-live
# Logging
logging:
level: info # debug|info|warn|error
file: .bmad-workspace/jira-integration.log # Log file location
# Error handling
errors:
retry_count: 3 # Number of retries
fallback_to_local: true # Save locally if upload fails