diff --git a/docs/src/content/docs/agent-factory-status.mdx b/docs/src/content/docs/agent-factory-status.mdx
index 6ecb720a09c..fa9a04424ac 100644
--- a/docs/src/content/docs/agent-factory-status.mdx
+++ b/docs/src/content/docs/agent-factory-status.mdx
@@ -15,8 +15,8 @@ These are experimental agentic workflows used by the GitHub Next team to learn,
 | [Agent Container Smoke Test](https://github.com/github/gh-aw/blob/main/.github/workflows/smoke-test-tools.md) | copilot | [![Agent Container Smoke Test](https://github.com/github/gh-aw/actions/workflows/smoke-test-tools.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/smoke-test-tools.lock.yml) | - | `/smoke` |
 | [Agent Performance Analyzer - Meta-Orchestrator](https://github.com/github/gh-aw/blob/main/.github/workflows/agent-performance-analyzer.md) | copilot | [![Agent Performance Analyzer - Meta-Orchestrator](https://github.com/github/gh-aw/actions/workflows/agent-performance-analyzer.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/agent-performance-analyzer.lock.yml) | - | - |
 | [Agent Persona Explorer](https://github.com/github/gh-aw/blob/main/.github/workflows/agent-persona-explorer.md) | copilot | [![Agent Persona Explorer](https://github.com/github/gh-aw/actions/workflows/agent-persona-explorer.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/agent-persona-explorer.lock.yml) | - | - |
+| [Agentic Workflow AIC Usage Optimizer](https://github.com/github/gh-aw/blob/main/.github/workflows/agentic-token-optimizer.md) | copilot | [![Agentic Workflow AIC Usage Optimizer](https://github.com/github/gh-aw/actions/workflows/agentic-token-optimizer.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/agentic-token-optimizer.lock.yml) | `daily around 14:00 on weekdays` | - |
 | [Agentic Workflow Audit Agent](https://github.com/github/gh-aw/blob/main/.github/workflows/audit-workflows.md) | claude | [![Agentic Workflow Audit Agent](https://github.com/github/gh-aw/actions/workflows/audit-workflows.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/audit-workflows.lock.yml) | - | - |
-| [Agentic Workflow Token Usage Optimizer](https://github.com/github/gh-aw/blob/main/.github/workflows/agentic-token-optimizer.md) | copilot | [![Agentic Workflow Token Usage Optimizer](https://github.com/github/gh-aw/actions/workflows/agentic-token-optimizer.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/agentic-token-optimizer.lock.yml) | `daily around 14:00 on weekdays` | - |
 | [AI Moderator](https://github.com/github/gh-aw/blob/main/.github/workflows/ai-moderator.md) | codex | [![AI Moderator](https://github.com/github/gh-aw/actions/workflows/ai-moderator.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/ai-moderator.lock.yml) | - | - |
 | [Approach Validator](https://github.com/github/gh-aw/blob/main/.github/workflows/approach-validator.md) | claude | [![Approach Validator](https://github.com/github/gh-aw/actions/workflows/approach-validator.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/approach-validator.lock.yml) | - | - |
 | [Archie](https://github.com/github/gh-aw/blob/main/.github/workflows/archie.md) | copilot | [![Archie](https://github.com/github/gh-aw/actions/workflows/archie.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/archie.lock.yml) | - | `/archie` |
@@ -55,11 +55,12 @@ These are experimental agentic workflows used by the GitHub Next team to learn,
 | [Copilot Session Insights](https://github.com/github/gh-aw/blob/main/.github/workflows/copilot-session-insights.md) | claude | [![Copilot Session Insights](https://github.com/github/gh-aw/actions/workflows/copilot-session-insights.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/copilot-session-insights.lock.yml) | - | - |
 | [Daily A/B Testing Advisor](https://github.com/github/gh-aw/blob/main/.github/workflows/ab-testing-advisor.md) | copilot | [![Daily A/B Testing Advisor](https://github.com/github/gh-aw/actions/workflows/ab-testing-advisor.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/ab-testing-advisor.lock.yml) | - | - |
 | [Daily Agent of the Day Blog Writer](https://github.com/github/gh-aw/blob/main/.github/workflows/daily-agent-of-the-day-blog-writer.md) | copilot | [![Daily Agent of the Day Blog Writer](https://github.com/github/gh-aw/actions/workflows/daily-agent-of-the-day-blog-writer.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/daily-agent-of-the-day-blog-writer.lock.yml) | - | - |
-| [Daily Agentic Workflow Token Usage Audit](https://github.com/github/gh-aw/blob/main/.github/workflows/agentic-token-audit.md) | copilot | [![Daily Agentic Workflow Token Usage Audit](https://github.com/github/gh-aw/actions/workflows/agentic-token-audit.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/agentic-token-audit.lock.yml) | `daily around 12:00 on weekdays` | - |
+| [Daily Agentic Workflow AIC Usage Audit](https://github.com/github/gh-aw/blob/main/.github/workflows/agentic-token-audit.md) | copilot | [![Daily Agentic Workflow AIC Usage Audit](https://github.com/github/gh-aw/actions/workflows/agentic-token-audit.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/agentic-token-audit.lock.yml) | `daily around 12:00 on weekdays` | - |
 | [Daily AgentRx Trace Optimizer](https://github.com/github/gh-aw/blob/main/.github/workflows/daily-agentrx-trace-optimizer.md) | claude | [![Daily AgentRx Trace Optimizer](https://github.com/github/gh-aw/actions/workflows/daily-agentrx-trace-optimizer.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/daily-agentrx-trace-optimizer.lock.yml) | - | - |
 | [Daily Ambient Context Optimizer](https://github.com/github/gh-aw/blob/main/.github/workflows/daily-ambient-context-optimizer.md) | copilot | [![Daily Ambient Context Optimizer](https://github.com/github/gh-aw/actions/workflows/daily-ambient-context-optimizer.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/daily-ambient-context-optimizer.lock.yml) | - | - |
 | [Daily AstroStyleLite Markdown Spellcheck](https://github.com/github/gh-aw/blob/main/.github/workflows/daily-astrostylelite-markdown-spellcheck.md) | claude | [![Daily AstroStyleLite Markdown Spellcheck](https://github.com/github/gh-aw/actions/workflows/daily-astrostylelite-markdown-spellcheck.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/daily-astrostylelite-markdown-spellcheck.lock.yml) | - | - |
 | [Daily AW Cross-Repo Compile Check](https://github.com/github/gh-aw/blob/main/.github/workflows/daily-aw-cross-repo-compile-check.md) | claude | [![Daily AW Cross-Repo Compile Check](https://github.com/github/gh-aw/actions/workflows/daily-aw-cross-repo-compile-check.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/daily-aw-cross-repo-compile-check.lock.yml) | - | - |
+| [Daily AWF Spec Compiler Surfacing Review](https://github.com/github/gh-aw/blob/main/.github/workflows/daily-awf-spec-compiler-surfacing.md) | claude | [![Daily AWF Spec Compiler Surfacing Review](https://github.com/github/gh-aw/actions/workflows/daily-awf-spec-compiler-surfacing.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/daily-awf-spec-compiler-surfacing.lock.yml) | - | - |
 | [Daily BYOK Ollama Test](https://github.com/github/gh-aw/blob/main/.github/workflows/daily-byok-ollama-test.md) | copilot | [![Daily BYOK Ollama Test](https://github.com/github/gh-aw/actions/workflows/daily-byok-ollama-test.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/daily-byok-ollama-test.lock.yml) | - | - |
 | [Daily Cache Strategy Analyzer](https://github.com/github/gh-aw/blob/main/.github/workflows/daily-cache-strategy-analyzer.md) | codex | [![Daily Cache Strategy Analyzer](https://github.com/github/gh-aw/actions/workflows/daily-cache-strategy-analyzer.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/daily-cache-strategy-analyzer.lock.yml) | - | - |
 | [Daily Caveman Optimizer](https://github.com/github/gh-aw/blob/main/.github/workflows/daily-caveman-optimizer.md) | claude | [![Daily Caveman Optimizer](https://github.com/github/gh-aw/actions/workflows/daily-caveman-optimizer.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/daily-caveman-optimizer.lock.yml) | - | - |
@@ -71,16 +72,19 @@ These are experimental agentic workflows used by the GitHub Next team to learn,
 | [Daily Compiler Quality Check](https://github.com/github/gh-aw/blob/main/.github/workflows/daily-compiler-quality.md) | copilot | [![Daily Compiler Quality Check](https://github.com/github/gh-aw/actions/workflows/daily-compiler-quality.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/daily-compiler-quality.lock.yml) | - | - |
 | [Daily Compiler Threat Spec Optimizer](https://github.com/github/gh-aw/blob/main/.github/workflows/daily-compiler-threat-spec-optimizer.md) | copilot | [![Daily Compiler Threat Spec Optimizer](https://github.com/github/gh-aw/actions/workflows/daily-compiler-threat-spec-optimizer.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/daily-compiler-threat-spec-optimizer.lock.yml) | - | - |
 | [Daily Copilot PR Merged Report](https://github.com/github/gh-aw/blob/main/.github/workflows/copilot-pr-merged-report.md) | copilot | [![Daily Copilot PR Merged Report](https://github.com/github/gh-aw/actions/workflows/copilot-pr-merged-report.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/copilot-pr-merged-report.lock.yml) | `daily around 15:00 on weekdays` | - |
+| [Daily Credit Limit Test (Intentionally Broken)](https://github.com/github/gh-aw/blob/main/.github/workflows/daily-credit-limit-test.md) | copilot | [![Daily Credit Limit Test (Intentionally Broken)](https://github.com/github/gh-aw/actions/workflows/daily-credit-limit-test.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/daily-credit-limit-test.lock.yml) | - | - |
 | [Daily Documentation Healer](https://github.com/github/gh-aw/blob/main/.github/workflows/daily-doc-healer.md) | claude | [![Daily Documentation Healer](https://github.com/github/gh-aw/actions/workflows/daily-doc-healer.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/daily-doc-healer.lock.yml) | - | - |
 | [Daily Documentation Updater](https://github.com/github/gh-aw/blob/main/.github/workflows/daily-doc-updater.md) | claude | [![Daily Documentation Updater](https://github.com/github/gh-aw/actions/workflows/daily-doc-updater.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/daily-doc-updater.lock.yml) | - | - |
 | [Daily Fact About gh-aw](https://github.com/github/gh-aw/blob/main/.github/workflows/daily-fact.md) | codex | [![Daily Fact About gh-aw](https://github.com/github/gh-aw/actions/workflows/daily-fact.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/daily-fact.lock.yml) | `daily around 14:00 on weekdays` | - |
 | [Daily File Diet](https://github.com/github/gh-aw/blob/main/.github/workflows/daily-file-diet.md) | copilot | [![Daily File Diet](https://github.com/github/gh-aw/actions/workflows/daily-file-diet.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/daily-file-diet.lock.yml) | - | - |
 | [Daily Firewall Logs Collector and Reporter](https://github.com/github/gh-aw/blob/main/.github/workflows/daily-firewall-report.md) | copilot | [![Daily Firewall Logs Collector and Reporter](https://github.com/github/gh-aw/actions/workflows/daily-firewall-report.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/daily-firewall-report.lock.yml) | - | - |
+| [Daily Formal Spec Verifier](https://github.com/github/gh-aw/blob/main/.github/workflows/daily-formal-spec-verifier.md) | copilot | [![Daily Formal Spec Verifier](https://github.com/github/gh-aw/actions/workflows/daily-formal-spec-verifier.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/daily-formal-spec-verifier.lock.yml) | - | - |
 | [Daily Go Function Namer](https://github.com/github/gh-aw/blob/main/.github/workflows/daily-function-namer.md) | claude | [![Daily Go Function Namer](https://github.com/github/gh-aw/actions/workflows/daily-function-namer.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/daily-function-namer.lock.yml) | - | - |
 | [Daily Grafana OTel Instrumentation Advisor](https://github.com/github/gh-aw/blob/main/.github/workflows/daily-grafana-otel-instrumentation-advisor.md) | claude | [![Daily Grafana OTel Instrumentation Advisor](https://github.com/github/gh-aw/actions/workflows/daily-grafana-otel-instrumentation-advisor.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/daily-grafana-otel-instrumentation-advisor.lock.yml) | - | - |
 | [Daily Hippo Learn](https://github.com/github/gh-aw/blob/main/.github/workflows/daily-hippo-learn.md) | copilot | [![Daily Hippo Learn](https://github.com/github/gh-aw/actions/workflows/daily-hippo-learn.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/daily-hippo-learn.lock.yml) | `daily around 7:00` | - |
 | [Daily Issues Report Generator](https://github.com/github/gh-aw/blob/main/.github/workflows/daily-issues-report.md) | copilot | [![Daily Issues Report Generator](https://github.com/github/gh-aw/actions/workflows/daily-issues-report.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/daily-issues-report.lock.yml) | - | - |
 | [Daily Malicious Code Scan Agent](https://github.com/github/gh-aw/blob/main/.github/workflows/daily-malicious-code-scan.md) | copilot | [![Daily Malicious Code Scan Agent](https://github.com/github/gh-aw/actions/workflows/daily-malicious-code-scan.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/daily-malicious-code-scan.lock.yml) | - | - |
+| [Daily Max AI Credits Test (Intentionally Fails)](https://github.com/github/gh-aw/blob/main/.github/workflows/daily-max-ai-credits-test.md) | copilot | [![Daily Max AI Credits Test (Intentionally Fails)](https://github.com/github/gh-aw/actions/workflows/daily-max-ai-credits-test.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/daily-max-ai-credits-test.lock.yml) | - | - |
 | [Daily MCP Tool Concurrency Analysis](https://github.com/github/gh-aw/blob/main/.github/workflows/daily-mcp-concurrency-analysis.md) | copilot | [![Daily MCP Tool Concurrency Analysis](https://github.com/github/gh-aw/actions/workflows/daily-mcp-concurrency-analysis.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/daily-mcp-concurrency-analysis.lock.yml) | - | - |
 | [Daily Model Inventory Checker](https://github.com/github/gh-aw/blob/main/.github/workflows/daily-model-inventory.md) | copilot | [![Daily Model Inventory Checker](https://github.com/github/gh-aw/actions/workflows/daily-model-inventory.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/daily-model-inventory.lock.yml) | - | - |
 | [Daily News](https://github.com/github/gh-aw/blob/main/.github/workflows/daily-news.md) | copilot | [![Daily News](https://github.com/github/gh-aw/actions/workflows/daily-news.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/daily-news.lock.yml) | `daily around 9:00 on weekdays` | - |
@@ -159,7 +163,7 @@ These are experimental agentic workflows used by the GitHub Next team to learn,
 | [Metrics Collector - Infrastructure Agent](https://github.com/github/gh-aw/blob/main/.github/workflows/metrics-collector.md) | copilot | [![Metrics Collector - Infrastructure Agent](https://github.com/github/gh-aw/actions/workflows/metrics-collector.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/metrics-collector.lock.yml) | - | - |
 | [Multi-Device Docs Tester](https://github.com/github/gh-aw/blob/main/.github/workflows/daily-multi-device-docs-tester.md) | claude | [![Multi-Device Docs Tester](https://github.com/github/gh-aw/actions/workflows/daily-multi-device-docs-tester.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/daily-multi-device-docs-tester.lock.yml) | - | - |
 | [Necromancer](https://github.com/github/gh-aw/blob/main/.github/workflows/necromancer.md) | codex | [![Necromancer](https://github.com/github/gh-aw/actions/workflows/necromancer.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/necromancer.lock.yml) | - | - |
-| [On-Demand Agentic Workflow Token Trend Audit](https://github.com/github/gh-aw/blob/main/.github/workflows/agentic-token-trend-audit.md) | copilot | [![On-Demand Agentic Workflow Token Trend Audit](https://github.com/github/gh-aw/actions/workflows/agentic-token-trend-audit.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/agentic-token-trend-audit.lock.yml) | - | - |
+| [On-Demand Agentic Workflow AIC Trend Audit](https://github.com/github/gh-aw/blob/main/.github/workflows/agentic-token-trend-audit.md) | copilot | [![On-Demand Agentic Workflow AIC Trend Audit](https://github.com/github/gh-aw/actions/workflows/agentic-token-trend-audit.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/agentic-token-trend-audit.lock.yml) | - | - |
 | [Organization Health Report](https://github.com/github/gh-aw/blob/main/.github/workflows/org-health-report.md) | copilot | [![Organization Health Report](https://github.com/github/gh-aw/actions/workflows/org-health-report.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/org-health-report.lock.yml) | - | - |
 | [OTLP Data Quality Validator](https://github.com/github/gh-aw/blob/main/.github/workflows/otlp-data-quality-validator.md) | copilot | [![OTLP Data Quality Validator](https://github.com/github/gh-aw/actions/workflows/otlp-data-quality-validator.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/otlp-data-quality-validator.lock.yml) | - | - |
 | [Outcome Collector](https://github.com/github/gh-aw/blob/main/.github/workflows/outcome-collector.md) | copilot | [![Outcome Collector](https://github.com/github/gh-aw/actions/workflows/outcome-collector.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/outcome-collector.lock.yml) | - | - |
@@ -203,6 +207,7 @@ These are experimental agentic workflows used by the GitHub Next team to learn,
 | [Smoke Claude](https://github.com/github/gh-aw/blob/main/.github/workflows/smoke-claude.md) | claude | [![Smoke Claude](https://github.com/github/gh-aw/actions/workflows/smoke-claude.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/smoke-claude.lock.yml) | - | `/smoke` |
 | [Smoke Codex](https://github.com/github/gh-aw/blob/main/.github/workflows/smoke-codex.md) | codex | [![Smoke Codex](https://github.com/github/gh-aw/actions/workflows/smoke-codex.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/smoke-codex.lock.yml) | - | `/smoke` |
 | [Smoke Copilot](https://github.com/github/gh-aw/blob/main/.github/workflows/smoke-copilot.md) | copilot | [![Smoke Copilot](https://github.com/github/gh-aw/actions/workflows/smoke-copilot.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/smoke-copilot.lock.yml) | - | `/smoke` |
+| [Smoke Copilot - AOAI (apikey)](https://github.com/github/gh-aw/blob/main/.github/workflows/smoke-copilot-aoai-apikey.md) | copilot | [![Smoke Copilot - AOAI (apikey)](https://github.com/github/gh-aw/actions/workflows/smoke-copilot-aoai-apikey.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/smoke-copilot-aoai-apikey.lock.yml) | - | `/smoke` |
 | [Smoke Copilot ARM64](https://github.com/github/gh-aw/blob/main/.github/workflows/smoke-copilot-arm.md) | copilot | [![Smoke Copilot ARM64](https://github.com/github/gh-aw/actions/workflows/smoke-copilot-arm.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/smoke-copilot-arm.lock.yml) | - | `/smoke` |
 | [Smoke Copilot SDK](https://github.com/github/gh-aw/blob/main/.github/workflows/smoke-copilot-sdk.md) | copilot | [![Smoke Copilot SDK](https://github.com/github/gh-aw/actions/workflows/smoke-copilot-sdk.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/smoke-copilot-sdk.lock.yml) | - | `/smoke` |
 | [Smoke Create Cross-Repo PR](https://github.com/github/gh-aw/blob/main/.github/workflows/smoke-create-cross-repo-pr.md) | copilot | [![Smoke Create Cross-Repo PR](https://github.com/github/gh-aw/actions/workflows/smoke-create-cross-repo-pr.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/smoke-create-cross-repo-pr.lock.yml) | - | `/smoke` |
diff --git a/docs/src/content/docs/blog/2026-06-08-migrating-from-effective-tokens-to-ai-credits.md b/docs/src/content/docs/blog/2026-06-08-migrating-from-effective-tokens-to-ai-credits.md
new file mode 100644
index 00000000000..c1455bb6fd8
--- /dev/null
+++ b/docs/src/content/docs/blog/2026-06-08-migrating-from-effective-tokens-to-ai-credits.md
@@ -0,0 +1,47 @@
+---
+title: "Effective Tokens replaced by AI Credits"
+description: "The latest gh-aw build uses AI Credits (AIC) as the primary spend metric and keeps Effective Tokens (ET) as a legacy compatibility field."
+authors:
+  - copilot
+date: 2026-06-08
+metadata:
+  seoDescription: "gh-aw now reports AI Credits (AIC) as the primary spend metric, aligned with GitHub Copilot billing and models.dev pricing."
+  linkedPostText: "ET replaced by AIC in latest build"
+---
+
+In the latest gh-aw build, Effective Tokens (ET) have been
+replaced by AI Credits (AIC) as the primary spend metric.
+
+> [!IMPORTANT]
+> AIC is now the default cost metric in gh-aw output. ET remains
+> available only as a legacy compatibility field.
+
+This change reflects GitHub Copilot billing and models.dev pricing.
+It makes spend tracking directly aligned to monetary cost instead of
+a normalized token proxy.
+
+## What this means in practice
+
+- `gh aw audit` and `gh aw logs` report AI Credits as the primary
+  spend metric.
+- Effective Tokens are deprecated in documentation and should be
+  treated as legacy compatibility output.
+- Cost reporting and budget discussions should use AIC values.
+
+For repositories that need automatic workflow updates, run:
+
+```bash
+gh aw fix --write
+```
+
+## Metric reference
+
+- **AI Credits (AIC)**: primary spend metric (1 AIC = $0.01 USD)
+- **Effective Tokens (ET)**: deprecated legacy metric
+
+## Where to read more
+
+- [Cost Management](/gh-aw/reference/cost-management/)
+- [Auditing Workflows](/gh-aw/reference/audit/)
+- [AI Credits Specification](/gh-aw/specs/ai-credits-specification/)
+- [Effective Tokens Specification](/gh-aw/specs/effective-tokens-specification/)
