This directory contains standardized issue templates used across all LightSpeedWP repositories to ensure consistent issue creation and proper automation triggering.

Get started with LightSpeedWP issue templates in three steps:

1. Clone the repository

   git clone https://github.com/lightspeedwp/.github.git
   cd .github

2. Install dependencies

   • For Node.js/JS: npm install
   • For Python: pip install -r requirements.txt (if present)

3. Use an issue template

   • Navigate to .github/ISSUE_TEMPLATE/
   • Select the appropriate template for your issue type (bug, feature, documentation, etc.)
   • Follow the instructions in the template to submit your issue

For advanced usage, see the Issue Template Index and individual template specs for configuration and automation options.

flowchart TD
    accTitle: Flowchart
    A[User Creates Issue] --> B{Select Template}
    B -->|Bug Report| C[Bug Template]
    B -->|Feature Request| D[Feature Template]
    B -->|Documentation| E[Docs Template]
    B -->|Custom| F[Blank Template]

    C --> G[Auto-populate Fields]
    D --> G
    E --> G
    F --> G

    G --> H[Issue Creation]
    H --> I[Agent Processing]

    I --> J[Auto-labeling]
    I --> K[Issue Type Assignment]
    I --> L[Project Board Assignment]
    I --> M[Notification Routing]

    N[Template Sync] --> O[All Org Repos]
    P[Automation Agents] --> I
    Q[Label System] --> J
    R[Project Management] --> L

    style A fill:#dbeafe,color:#1e3a5f,stroke:#1e3a5f
    style I fill:#f3e8ff,color:#3b0764,stroke:#7e22ce
    style N fill:#dcfce7,color:#14532d,stroke:#14532d
accDescr: Detailed diagram

The issue templates in this directory are automatically synchronized across all organization repositories and work in conjunction with our automation agents.

These templates integrate with:

• Issue Types - Canonical issue type definitions
• Issue Labels - Automated labeling system
• Automation Governance - Agent-driven workflows
• Branching Strategy - Branch naming conventions

• Auto-labeling: Templates trigger automatic label assignment
• Type Detection: Issues are automatically typed based on template
• Agent Assignment: Specific agents are triggered based on issue type
• Project Sync: Issues are automatically added to relevant projects

• Instructions Index - All instruction files
• Agents Directory - Automation agents
• Saved Replies - Response templates
• Workflows - GitHub Actions automation

1. Template Selection: Choose the most specific template for your issue
2. Required Fields: Fill in all required template fields
3. Labels: Let automation handle labeling - don't manually add labels
4. Type Assignment: Templates automatically set the correct issue type

This directory is part of the LightSpeedWP automation ecosystem. See Automation Governance for complete automation standards.