lvlup-sw Organization Defaults

This repository contains organization-wide community health files, reusable workflows, and templates for all lvlup-sw repositories.

What's Included

Issue Templates (ISSUE_TEMPLATE/)

Default issue templates applied to all repos without their own templates:

• Bug Report - Report something that isn't working
• Feature Request - Suggest a new feature

Labels (labels-base.yml)

Standard label definitions for consistent issue/PR organization:

Category	Labels
Type	type:bug, type:feature, type:docs, type:chore, type:question
Status	status:triage, status:blocked, status:stale
Priority	priority:high, priority:low

Reusable Workflows (.github/workflows/)

Label Sync (label-sync.yml)

Automatically syncs labels from labels.yml to GitHub. Call from your repo:

jobs:
  label-sync:
    uses: lvlup-sw/.github/.github/workflows/label-sync.yml@main
    secrets: inherit

Project Setup (project-setup.yml)

One-time setup workflow for Project 3. Run manually via Actions tab:

• Creates Priority field (P0/P1/P2/P3)
• Verifies Iteration field exists
• Syncs all existing open issues from configured repos

Iteration Manager (iteration-manager.yml)

Weekly scheduled workflow to manage project iterations:

• Creates new iterations when running low
• Runs every Monday at 9am UTC
• Can also be triggered manually

Workflow Templates (workflow-templates/)

Project Automation

Complete automation workflow with:

• Label sync - Syncs labels when labels.yml changes
• Auto-triage - Labels new issues based on content patterns
• Auto-assign - Assigns PR author as assignee
• Project sync - Adds issues/PRs to org project board (project 3)
• Project fields - Sets Priority and Iteration based on labels
• Stale management - Marks/closes inactive issues after 60 days
• Renovate auto-merge - Auto-merges Renovate dependency PRs
• Release automation - Generates changelog and creates releases from tags

Rulesets (rulesets/default.json)

Reference template for branch protection. Copy to your repo and apply via GitHub UI or API.

Project 3 Configuration

All repos feed into Project 3 for unified issue/PR tracking.

Priority Mapping

Label	Project Priority	Iteration
priority:high + urgent keywords	P0	Current sprint
priority:high	P1	Current sprint
(no priority label)	P2	Backlog
priority:low	P3	Backlog

Urgent keywords: urgent, critical, blocker, p0, asap, emergency

Initial Setup

1. Run Project Setup workflow from Actions tab
2. Manually create Iteration field in Project settings if needed
3. Create initial sprints (2-week iterations)
4. Set up Board view sorted by Priority

Repos Configured

• ares-elite-platform
• agentic-workflow
• agentic-engine
• lvlup-claude
• DataFerry

Usage

For New Repos

1. Copy labels: Copy labels-base.yml to .github/labels.yml
2. Add scopes: Add domain-specific scope:* labels for your project
3. Copy workflow: Copy workflow-templates/project-automation.yml to .github/workflows/
4. Customize: Update scope detection patterns in auto-triage job
5. Set secret: Ensure PROJECT_TOKEN secret is configured for project sync
6. Add to project setup: Add repo name to REPOS env in project-setup.yml

For Existing Repos

Issue templates from this repo automatically apply to repos without their own templates.

To add label sync to an existing repo, add this to your workflow:

on:
  push:
    branches: [main]
    paths:
      - '.github/labels.yml'

jobs:
  label-sync:
    uses: lvlup-sw/.github/.github/workflows/label-sync.yml@main
    secrets: inherit

Required Secrets

Secret	Purpose	Scopes
PROJECT_TOKEN	PAT for project management	project, repo

Set at org level: Settings > Secrets > Actions > New organization secret