add descriptions

Author: dsyme

workflows/ci-doctor.md

@@ -1,4 +1,10 @@
 ---
+description: |
+  This workflow is an automated CI failure investigator that triggers when monitored workflows fail.
+  Performs deep analysis of GitHub Actions workflow failures to identify root causes,
+  patterns, and provide actionable remediation steps. Analyzes logs, error messages,
+  and workflow configuration to help diagnose and resolve CI issues efficiently.
+
 on:
   workflow_run:
     workflows: ["Daily Perf Improver", "Daily Test Coverage Improver"]  # Monitor the CI workflow specifically

workflows/daily-accessibility-review.md

@@ -1,4 +1,11 @@
 ---
+description: |
+  This workflow is an automated accessibility compliance checker for web applications.
+  Reviews websites against WCAG 2.2 guidelines using Playwright browser automation.
+  Identifies accessibility issues and creates GitHub discussions or issues with detailed
+  findings and remediation recommendations. Helps maintain accessibility standards
+  continuously throughout the development cycle.
+
 on: 
   schedule:
     # Run daily at 3am UTC, all days except Saturday and Sunday

workflows/daily-backlog-burner.md

@@ -1,4 +1,10 @@
 ---
+description: |
+  This workflow performs systematic backlog management by working through issues and pull requests.
+  Operates in two phases: research entire backlog to categorize and prioritize items, then
+  systematically close, resolve, or advance selected items. Creates discussions to track
+  progress and gather maintainer feedback, helping reduce technical debt.
+
 on:
     workflow_dispatch:
     schedule:

workflows/daily-dependency-updates.md

@@ -1,4 +1,11 @@
 ---
+description: |
+  This workflow performs automated dependency management by monitoring and updating project dependencies.
+  Checks Dependabot alerts and updates dependencies in package manifests (not just lock files).
+  Bundles multiple compatible updates into single pull requests, runs tests to verify
+  compatibility, and creates draft PRs with working changes. Documents investigation
+  attempts for problematic updates.
+
 on:
     workflow_dispatch:
     schedule:

workflows/daily-perf-improver.md

@@ -1,4 +1,11 @@
 ---
+description: |
+  This workflow makes performance optimizations by identifying and improving application bottlenecks.
+  It builds the project and analyzes performance metrics to find optimization opportunities.
+  Operates in three phases: research performance landscape and create plan, infer build steps
+  and create performance engineering guides, then implement optimizations and measure impact.
+  Creates discussions to coordinate and draft PRs with improvements.
+
 on:
     workflow_dispatch:
     schedule:

workflows/daily-plan.md

@@ -1,4 +1,11 @@
 ---
+description: |
+  This workflow performs strategic project planning by maintaining and updating the project roadmap.
+  Analyzes repository state including open issues, PRs, and completed work to formulate
+  a comprehensive project plan. Creates or updates a planning discussion with prioritized
+  tasks, dependencies, and suggested new issues (via gh commands but doesn't create them).
+  Incorporates maintainer feedback from comments on the plan.
+
 # Run once a day at midnight UTC
 on:
   schedule:

workflows/daily-progress.md

@@ -1,4 +1,10 @@
 ---
+description: |
+  This workflow systematically delivers features from the project plan.
+  Operates in two phases: research roadmap and feature landscape to create prioritized plan,
+  then implement selected high-priority features via pull requests. Creates discussions to
+  coordinate with maintainers and advance the project toward its strategic goals.
+
 on:
     workflow_dispatch:
     schedule:

workflows/daily-qa.md

@@ -1,4 +1,10 @@
 ---
+description: |
+  This workflow performs adhoc quality assurance by validating project health daily.
+  Checks that code builds and runs, tests pass, documentation is clear, and code
+  is well-structured. Creates discussions for findings and can submit draft PRs
+  with improvements. Provides continuous quality monitoring throughout development.
+
 on:
     schedule:
       # Run daily at 3am UTC, all days except Saturday and Sunday

workflows/daily-team-status.md

@@ -1,4 +1,11 @@
 ---
+description: |
+  This workflow created daily team status reporter creating upbeat activity summaries.
+  Gathers recent repository activity (issues, PRs, discussions, releases, code changes)
+  and generates engaging GitHub discussions with productivity insights, community
+  highlights, and project recommendations. Uses a positive, encouraging tone with
+  moderate emoji usage to boost team morale.
+
 on:
   schedule:
     # Every day at 9am UTC, all days except Saturday and Sunday

workflows/daily-test-improver.md

@@ -1,4 +1,10 @@
 ---
+description: |
+  This workflow performs test enhancements by systematically improving test quality and coverage.
+  Operates in three phases: research testing landscape and create coverage plan, infer build
+  and coverage steps, then implement new tests targeting untested code. Generates coverage
+  reports, identifies gaps, creates comprehensive test suites, and submits draft PRs.
+
 on:
     workflow_dispatch:
     schedule: