Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
23 commits
Select commit Hold shift + click to select a range
8948b1a
feat(queries): add FinOps KPI query catalog
Jun 3, 2026
87443aa
feat(sre-agent): add FinOps recipe content
Jun 3, 2026
6a01421
feat(sre-agent): add deployable Azure template
Jun 3, 2026
a1f7008
fix(queries): remove markdown trailing whitespace
Jun 3, 2026
7e609aa
merge: update KPI query catalog base
Jun 3, 2026
a019530
fix(sre-agent): remove recipe whitespace
Jun 3, 2026
42cc7f4
merge: update SRE Agent recipe base
Jun 3, 2026
c044e75
test(sre-agent): keep deployment tests with deploy slice
Jun 3, 2026
258ee3c
merge: update SRE Agent recipe base
Jun 3, 2026
05601e6
fix(sre-agent): keep deploy checks in deploy slice
Jun 3, 2026
b332089
fix(sre-agent): address deploy CI failures
Jun 3, 2026
3e83081
test(sre-agent): normalize bash stub path on Windows
Jun 3, 2026
60d7857
test(sre-agent): harden bash stub permissions
Jun 3, 2026
e46aa39
test(sre-agent): stub extras builder in deploy tests
Jun 3, 2026
de97720
test(sre-agent): fix Windows Python extras stub
Jun 3, 2026
4ed9fb9
test(sre-agent): preserve Azure resource IDs on Windows
Jun 3, 2026
a6d68e6
fix(sre-agent): address recipe review feedback
Jun 4, 2026
fe4aa54
chore: update mslearn dates
Jun 4, 2026
d07b722
Merge remote-tracking branch 'origin/dev' into features/sre-agent-recipe
Jun 17, 2026
4b64484
fix(sre-agent): vendor capacity skill, default read-only access, cust…
Jun 17, 2026
f7cca43
fix(sre-agent): unify template with secure deploy defaults and clean …
Jun 17, 2026
a1133af
fix(sre-agent): refresh ms.date, default actionMode to review, drop g…
MSBrett Jun 17, 2026
4f3eee1
test(sre-agent): expect review-mode default for portal actionMode
MSBrett Jun 17, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -387,3 +387,6 @@ src/templates/finops-hub-copilot-studio/knowledge/query-catalog.md
todo/
done/
release/scloud-occurrence-report.md

# Generated SRE Agent recipe packages
docs/deploy/sre-agent/*/sre-agent-recipe.zip

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit: Why are these in the deploy folder if they're not getting committed? Shouldn't we clean them up so they don't even land there?

5 changes: 5 additions & 0 deletions docs-mslearn/.openpublishing.redirection.finops.json
Original file line number Diff line number Diff line change
Expand Up @@ -130,6 +130,11 @@
"redirect_url": "/cloud-computing/finops/toolkit/workbooks/customize-workbooks",
"redirect_document_id": false
},
{
"source_path_from_root": "/finops/finops/toolkit/hubs/configure-sre.md",
"redirect_url": "/cloud-computing/finops/toolkit/sre-agent/overview",
"redirect_document_id": false
},
Comment on lines +133 to +137

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We don't need a redirect for something that never existed before

Suggested change
{
"source_path_from_root": "/finops/finops/toolkit/hubs/configure-sre.md",
"redirect_url": "/cloud-computing/finops/toolkit/sre-agent/overview",
"redirect_document_id": false
},

{
"source_path_from_root": "/finops/finops/framework/manage/culture.md",
"redirect_url": "/cloud-computing/finops/framework/manage/education",
Expand Down
24 changes: 22 additions & 2 deletions docs-mslearn/TOC.yml
Original file line number Diff line number Diff line change
Expand Up @@ -54,7 +54,7 @@
href: framework/optimize/optimize-cloud-usage-cost.md
- name: Architecting for cloud
href: framework/optimize/architecting.md
- name: Workload optimization
- name: Usage optimization
href: framework/optimize/workloads.md
- name: Rate optimization
href: framework/optimize/rates.md
Expand Down Expand Up @@ -154,6 +154,26 @@
href: toolkit/hubs/upgrade.md
- name: Compatibility guide
href: toolkit/hubs/compatibility.md
- name: FinOps toolkit SRE Agent

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit: I would put this after Workbooks, based on popularity. I know it's new, but that's the general practice we've always have. I could see higher than Alerts and AOE, but probably not Workbooks. We can always move it based on usage.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Following the naming convention: We don't put "FinOps toolkit" as a prefix on everything. Adding "Azure" to hopefully add context to what "SRE" means. Lowercasing "agent" per Microsoft style.

Suggested change
- name: FinOps toolkit SRE Agent
- name: Azure SRE agent

items:
- name: Overview
href: toolkit/sre-agent/overview.md
- name: Deploy
href: toolkit/sre-agent/deploy.md
- name: Agents and skills
href: toolkit/sre-agent/agents.md
- name: Tools
href: toolkit/sre-agent/tools.md
- name: Scheduled tasks
href: toolkit/sre-agent/scheduled-tasks.md
- name: Knowledge and memory
href: toolkit/sre-agent/knowledge.md
- name: Security and permissions
href: toolkit/sre-agent/security.md
- name: Troubleshooting
href: toolkit/sre-agent/troubleshooting.md
Comment on lines +173 to +174

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit: I'd probably put this last. But besides that, I'm more wondering whether this should be merged with the FTK troubleshooter. It's mostly for hubs, but that's only because we haven't taken the time to add anything else.

- name: Template reference

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is this a deployment template? If so, I'd be consistent with hubs:

Suggested change
- name: Template reference
- name: Deployment template

href: toolkit/sre-agent/template.md
- name: Power BI
items:
- name: Overview
Expand All @@ -170,7 +190,7 @@
href: toolkit/power-bi/invoicing.md
- name: Rate optimization report
href: toolkit/power-bi/rate-optimization.md
- name: Workload optimization report
- name: Usage optimization report
href: toolkit/power-bi/workload-optimization.md
- name: Data ingestion report
href: toolkit/power-bi/data-ingestion.md
Expand Down
54 changes: 25 additions & 29 deletions docs-mslearn/toolkit/changelog.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: FinOps toolkit changelog
description: Review the latest features and enhancements in the FinOps toolkit, including updates to FinOps hubs, Power BI reports, and more.
author: MSBrett
ms.author: brettwil
ms.date: 05/26/2026
ms.date: 06/17/2026
ms.topic: reference
ms.service: finops
ms.subservice: finops-toolkit
Expand All @@ -25,28 +25,16 @@ This article summarizes the features and enhancements in each release of the Fin

The following section lists features and enhancements that are currently in development.

-->

<br><a name="latest"></a>

## v15

_Released June 2026_

### [Implementing FinOps guide](../implementing-finops-guide.md) v15

- **Fixed**
- Corrected stale and incorrect descriptions for `BilledCost`, `EffectiveCost`, `BillingCurrency`, `BillingProfileId`, `BillingProfileName`, `CommitmentDiscountQuantity`, `ListUnitPrice`, `PricingQuantity`, `PricingUnitDescription`, and `TotalSavingsRunningTotal` in the [data dictionary](help/data-dictionary.md) to align with FOCUS 1.2 ([#2112](https://github.com/microsoft/finops-toolkit/pull/2112)).

### Claude Code plugin v15
### Claude Code plugin v15.0.0

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Undo these changes. You can change the June date to July or August (or leave it until we have a better idea), but the v15 header is valid and should stay. And the Claude Clode plugin needs to follow the naming pattern.


- **Added**
- Added Claude Code plugin with skills for FinOps hubs and Azure Cost Management ([#2043](https://github.com/microsoft/finops-toolkit/pull/2043)).
- Added 4 agents (CFO, FinOps practitioner, database query, hubs agent), 5 commands (`/ftk-hubs-connect`, `/ftk-hubs-healthCheck`, `/ftk-mom-report`, `/ftk-ytd-report`, `/ftk-cost-optimization`), and an output style.
- Linked to the existing KQL query catalog in `src/queries/` from the plugin.

### [FinOps hubs](hubs/finops-hubs-overview.md) v15
### Bicep Registry module pending updates

- Cost Management export modules for subscriptions and resource groups.
Comment on lines -48 to +37

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Undo - we aren't bringing this into v15 and it broke a valid section header by "moving" content to be under the wrong header.

- **Changed**
- Added a callout to the `config_RunBackfillJob` backfill option clarifying that it isn't supported on Microsoft Customer Agreement (MCA) billing accounts or billing profiles ([#2113](https://github.com/microsoft/finops-toolkit/issues/2113)).
- **Fixed**
Expand All @@ -57,26 +45,34 @@ _Released June 2026_

- **Fixed**
- Corrected stale and incorrect descriptions for `BilledCost`, `EffectiveCost`, `BillingCurrency`, `BillingProfileId`, `BillingProfileName`, `CommitmentDiscountQuantity`, `ListUnitPrice`, `PricingQuantity`, `PricingUnitDescription`, and `TotalSavingsRunningTotal` to align with FOCUS 1.2 ([#2112](https://github.com/microsoft/finops-toolkit/pull/2112)).

### [Optimization engine](optimization-engine/overview.md) updates

- **Fixed**
- Removed call to Azure Classic administrators endpoint (deprecated on May 1, 2026) from Azure RBAC assignments exports ([#2142](https://github.com/microsoft/finops-toolkit/issues/2142)).

-->
<!-- prettier-ignore-start -->
> [!div class="nextstepaction"]
> [Download](https://github.com/microsoft/finops-toolkit/releases/tag/v15)
> [!div class="nextstepaction"]
> [Full changelog](https://github.com/microsoft/finops-toolkit/compare/v14...v15)
<!-- prettier-ignore-end -->

<br>
<br><a name="latest"></a>

Comment on lines 60 to 51

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Undo - nothing here is a valid change; if anything, "updates" should be changed to "v15"

## v14

_Released April 2026_

### Claude Code plugin v13.0.0

- **Added**
- Added Claude Code plugin with skills for FinOps hubs and Azure Cost Management.
- Added 4 agents (CFO, FinOps practitioner, database query, hubs agent), 5 commands (`/ftk-hubs-connect`, `/ftk-hubs-healthCheck`, `/ftk-mom-report`, `/ftk-ytd-report`, `/ftk-cost-optimization`), and an output style.
- Linked to the existing KQL query catalog in `src/queries/` from the plugin.

### [SRE agent](sre-agent/overview.md)

- **Added**
- Added Azure SRE Agent template with a packaged Deploy to Azure path, `deploy.sh` local CLI automation, and Bicep infrastructure.
- Added 5 subagents (`finops-practitioner`, `azure-capacity-manager`, `chief-financial-officer`, `ftk-database-query`, `ftk-hubs-agent`), 3 skills, 50 tools, and 1 Kusto MCP connector.
- Added 19 scheduled tasks (daily, weekly, monthly, semiannual, and quarterly cadences) with Teams channel delivery.
- Added 6 knowledge documents for agent onboarding, artifact verification, Teams notification patterns, known issues, document index guidance, and FinOps Toolkit output style.
- Added FinOps toolkit SRE Agent documentation pages for Microsoft Learn.
- **Changed**
- Set agent action mode to Autonomous so scheduled tasks can deliver reports without human approval.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤖 [AI][Claude Code] 💡 Suggestion

This line says the agent action mode was "set to Autonomous," but the secure-by-default resolution changed the shipped defaults: main.bicep (portal) defaults actionMode to review, and createUiDefinition.json defaults to review as well. A reader scanning the changelog would conclude autonomous is the out-of-box behavior, which it no longer is for the portal path.

Consider rewording to reflect that the agent defaults to review mode, with autonomous available as an opt-in for scheduled task delivery — e.g.:

Suggested change
- Set agent action mode to Autonomous so scheduled tasks can deliver reports without human approval.
- Defaulted the deployment to review mode (read-only `Low` access); autonomous mode is an opt-in for unattended scheduled task delivery.

- Switched scheduled task persistence from legacy CLI creation to manifest apply for idempotent re-runs.
- Replaced "save to knowledge base" instructions with `#remember` for operational notes across all scheduled tasks.

Comment on lines +56 to +75

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Move these to v15

### [Implementing FinOps guide](../implementing-finops-guide.md) v14

- **Added**
Expand Down
Loading
Loading