Merge branch 'main' into copilot/agent-agnostic-ops

Author: mnkiefer

.github/workflows/agentics-maintenance.yml

@@ -174,7 +174,7 @@ jobs:
             await main();
 
       - name: Install gh-aw
-        uses: github/gh-aw-actions/setup-cli@v0.72.1
+        uses: github/gh-aw-actions/setup-cli@bc56a0cad2f450c562810785ef38649c04db812a # v0.72.1
         with:
           version: v0.72.1
 
@@ -309,7 +309,7 @@ jobs:
             await main();
 
       - name: Install gh-aw
-        uses: github/gh-aw-actions/setup-cli@v0.72.1
+        uses: github/gh-aw-actions/setup-cli@bc56a0cad2f450c562810785ef38649c04db812a # v0.72.1
         with:
           version: v0.72.1
 
@@ -355,7 +355,7 @@ jobs:
             await main();
 
       - name: Install gh-aw
-        uses: github/gh-aw-actions/setup-cli@v0.72.1
+        uses: github/gh-aw-actions/setup-cli@bc56a0cad2f450c562810785ef38649c04db812a # v0.72.1
         with:
           version: v0.72.1
 
@@ -489,7 +489,7 @@ jobs:
             await main();
 
       - name: Install gh-aw
-        uses: github/gh-aw-actions/setup-cli@v0.72.1
+        uses: github/gh-aw-actions/setup-cli@bc56a0cad2f450c562810785ef38649c04db812a # v0.72.1
         with:
           version: v0.72.1
 

README.md

@@ -1,24 +1,46 @@
-# agentic-ops
+# `agentic-ops` [![CI](https://github.com/githubnext/agentic-ops/actions/workflows/ci.yml/badge.svg)](https://github.com/githubnext/agentic-ops/actions/workflows/ci.yml)
 
-[![CI](https://github.com/githubnext/agentic-ops/actions/workflows/ci.yml/badge.svg)](https://github.com/githubnext/agentic-ops/actions/workflows/ci.yml)
+> "Audit token spend, surface waste, and optimize agentic workflows with confidence!"
 
-This repo contains a small set of GitHub Agentic Workflows for auditing token usage across agentic workflows and highlighting workflows that should be optimized.
+`agentic-ops` is a focused bundle of GitHub Agentic Workflows for teams scaling agentic automation and wanting better visibility into cost, usage, and optimization opportunities. Instead of guessing which workflows are expensive or where token waste is hiding, this package gives you an audit trail, historical reporting, and conservative recommendations you can review before making changes.
 
-## Usage
+## Introduction
 
-To add one of these workflows to your repo, use `gh aw add <owner>/<repo>/<workflow-name>`.
+It is built for platform engineers, developer productivity teams, and repository maintainers who are scaling agentic workflows and need a practical way to keep them efficient. The bundle helps solve a common problem with AI automation: token usage grows quickly, but the signals for where to improve are scattered across workflow runs and logs. With `agentic-ops`, you get repeatable workflows that make usage measurable, optimization opportunities actionable, and efficiency work easier to operationalize.
+
+## Key Features
+
+- **Clear operational visibility** with a daily token audit that captures usage, cost, trends, and workflow-level hotspots.
+- **Actionable optimization guidance** that identifies high-token workflows and proposes safe, conservative improvements.
+- **Faster cost control** by helping teams find waste before it becomes a recurring operational expense.
+- **Built for real GitHub workflows** using GitHub Agentic Workflows, so installation and adoption fit naturally into existing repositories.
+- **Useful historical context** through shared snapshots that support trend analysis instead of one-off debugging.
+- **A focused bundle** that gives you both measurement and optimization, not just another standalone report.
+
+## Quick Start
+
+Install the bundle with `gh aw add`:
 
 ```bash
 gh aw add githubnext/agentic-ops/agentic-token-audit githubnext/agentic-ops/agentic-token-optimizer
+
+# Then compile the installed workflows in your repository
+gh aw compile
 ```
 
-This adds the workflow to `.github/workflows/`. For guided setup, use `gh aw add-wizard githubnext/agentic-ops/agentic-token-audit`.
+After installation, you can use the included workflows to:
 
-Release history lives in [CHANGELOG.md](CHANGELOG.md).
+- run a daily audit of workflow token usage
+- identify the workflows consuming the most tokens
+- generate optimization recommendations grounded in recent run data
 
-## Workflows
+Included workflows:
 
 | Workflow | What it does |
 | ----- | --- |
 | [`Daily Agentic Workflow Token Usage Audit`](https://github.com/githubnext/agentic-ops/blob/main/workflows/agentic-token-audit.md?plain=1) | Collects recent agentic workflow usage and creates a daily audit snapshot. |
 | [`Agentic Workflow Token Usage Optimizer`](https://github.com/githubnext/agentic-ops/blob/main/workflows/agentic-token-optimizer.md?plain=1) | Analyzes expensive workflows and proposes conservative token-reduction changes. |
+
+## License
+
+MIT