Skip to content

Latest commit

 

History

History
71 lines (47 loc) · 2.12 KB

q.md

File metadata and controls

71 lines (47 loc) · 2.12 KB

🔧 Q - Agentic Workflow Optimizer

For an overview of all available workflows, see the main README.

Expert system for optimizing and fixing agentic workflows

The Q workflow analyzes workflow performance, identifies missing tools, detects inefficiencies, and creates pull requests with optimized configurations.

Installation

# Install the 'gh aw' extension
gh extension install github/gh-aw

# Add the workflow to your repository
gh aw add-wizard githubnext/agentics/q

This walks you through adding the workflow to your repository.

How It Works

graph LR
    A["/q Command"] --> B[Analyze Workflows]
    B --> C[Check Logs & Metrics]
    C --> D{Issues Found?}
    D -->|Yes| E[Optimize Configuration]
    E --> F[Create PR]
    D -->|No| G[Report: All Optimized]
Loading

The workflow downloads recent workflow logs and audit information, examines workflow files, researches best practices, and validates changes using the compile tool.

Usage

This workflow triggers from issue or PR comments - you cannot start it manually.

Usage as a General-Purpose Assistant

Trigger on any issue or PR:

/q

Example commands:

/q Analyze all workflows and suggest optimizations
/q Fix the missing tools in the repo-assist workflow
/q Investigate why the CI doctor workflow is failing
/q Extract common patterns from coding workflows into a shared config
/q Optimize workflows with high token usage

Configuration

This workflow requires no configuration and works out of the box.

After editing run gh aw compile to update the workflow and commit all changes to the default branch.

Triggering CI on Pull Requests

To automatically trigger CI checks on PRs created by this workflow, configure an additional repository secret GH_AW_CI_TRIGGER_TOKEN. See the triggering CI documentation for setup instructions.

Human in the Loop

  • Review the analysis and findings before accepting optimizations
  • Validate that suggested changes align with your requirements
  • Test workflow changes before merging