From e8a91efe9ae5d07d5a0a4d4ffb073bc5d8485c00 Mon Sep 17 00:00:00 2001 From: John CSA <103165870+jluocsa@users.noreply.github.com> Date: Fri, 22 May 2026 14:09:29 -0700 Subject: [PATCH 1/2] docs(decisions): resolve duplicate ADR sequence numbers (0016, 0021, 0024) Three ADR pairs in docs/decisions/ shared sequence numbers despite the directory README's guidance to pick unique numbers. This commit renames the file in each pair that does not already have established cross-references. Renames: - 0016-structured-output.md -> 0027-structured-output.md - 0021-agent-skills-design.md -> 0028-agent-skills-design.md - 0024-codeact-integration.md -> 0029-codeact-integration.md Pure rename; no content edits. --- .../{0016-structured-output.md => 0027-structured-output.md} | 0 .../{0021-agent-skills-design.md => 0028-agent-skills-design.md} | 0 .../{0024-codeact-integration.md => 0029-codeact-integration.md} | 0 3 files changed, 0 insertions(+), 0 deletions(-) rename docs/decisions/{0016-structured-output.md => 0027-structured-output.md} (100%) rename docs/decisions/{0021-agent-skills-design.md => 0028-agent-skills-design.md} (100%) rename docs/decisions/{0024-codeact-integration.md => 0029-codeact-integration.md} (100%) diff --git a/docs/decisions/0016-structured-output.md b/docs/decisions/0027-structured-output.md similarity index 100% rename from docs/decisions/0016-structured-output.md rename to docs/decisions/0027-structured-output.md diff --git a/docs/decisions/0021-agent-skills-design.md b/docs/decisions/0028-agent-skills-design.md similarity index 100% rename from docs/decisions/0021-agent-skills-design.md rename to docs/decisions/0028-agent-skills-design.md diff --git a/docs/decisions/0024-codeact-integration.md b/docs/decisions/0029-codeact-integration.md similarity index 100% rename from docs/decisions/0024-codeact-integration.md rename to docs/decisions/0029-codeact-integration.md From 702e537a1980bcef2417ece5c29018e961801ad2 Mon Sep 17 00:00:00 2001 From: John CSA <103165870+jluocsa@users.noreply.github.com> Date: Fri, 22 May 2026 15:09:59 -0700 Subject: [PATCH 2/2] docs: update cross-references to renumbered ADRs Updates 6 markdown links that pointed to ADR sequence numbers reassigned by the previous commit: * README.md -> 0021 -> 0028 (agent-skills-design) * dotnet/src/Microsoft.Agents.AI.Hyperlight/README.md -> 0024 -> 0029 * docs/features/code_act/python-implementation.md (x2) -> 0024 -> 0029 * docs/features/code_act/dotnet-implementation.md (x2) -> 0024 -> 0029 Caught by the markdown-link-check workflow. No content changes. --- README.md | 2 +- docs/features/code_act/dotnet-implementation.md | 4 ++-- docs/features/code_act/python-implementation.md | 4 ++-- dotnet/src/Microsoft.Agents.AI.Hyperlight/README.md | 2 +- 4 files changed, 6 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index fdf6cfbd3d..fe57f39f67 100644 --- a/README.md +++ b/README.md @@ -52,7 +52,7 @@ Explore new MAF capabilities and real implementation patterns on the [official b - **Declarative Agents**: Define agents using YAML for faster setup and versioning - [Declarative agent samples](./declarative-agents/) - **Agent Skills**: Build domain-specific knowledge bases from multiple sources—files, inline code, class libraries—for agents to discover and use - - [Skills design](./docs/decisions/0021-agent-skills-design.md) + - [Skills design](./docs/decisions/0028-agent-skills-design.md) - **AF Labs**: Experimental packages for cutting-edge features including benchmarking, reinforcement learning, and research initiatives - [Labs directory](./python/packages/lab/) - **DevUI**: Interactive developer UI for agent development, testing, and debugging workflows diff --git a/docs/features/code_act/dotnet-implementation.md b/docs/features/code_act/dotnet-implementation.md index 5a2b51ae3a..6d481cc687 100644 --- a/docs/features/code_act/dotnet-implementation.md +++ b/docs/features/code_act/dotnet-implementation.md @@ -1,7 +1,7 @@ # CodeAct .NET implementation This document describes the .NET realization of the CodeAct design in -[`docs/decisions/0024-codeact-integration.md`](../../decisions/0024-codeact-integration.md). +[`docs/decisions/0029-codeact-integration.md`](../../decisions/0029-codeact-integration.md). This document is intentionally focused on the .NET design and public API surface. The initial public .NET type described here is `HyperlightCodeActProvider`. Future .NET backends, such as Monty, should follow the same conceptual model with their own concrete provider types rather than through a public abstract base class or a public executor parameter. @@ -23,7 +23,7 @@ Implementation-free outcome: ## What is the problem being solved? -The cross-SDK problem statement and decision rationale live in the [ADR](../../decisions/0024-codeact-integration.md). The items below narrow that statement to .NET-specific design concerns: +The cross-SDK problem statement and decision rationale live in the [ADR](../../decisions/0029-codeact-integration.md). The items below narrow that statement to .NET-specific design concerns: - Today, the easiest way to prototype CodeAct in .NET is to manually configure an `AIFunction` and wire instructions — this is fragile and requires understanding internal sandbox lifecycle details. - There is no first-class .NET design that simultaneously covers Hyperlight-backed CodeAct now, future backend-specific providers, and both tool-enabled and interpreter modes. diff --git a/docs/features/code_act/python-implementation.md b/docs/features/code_act/python-implementation.md index 7f45190d33..ee86b1745a 100644 --- a/docs/features/code_act/python-implementation.md +++ b/docs/features/code_act/python-implementation.md @@ -1,7 +1,7 @@ # CodeAct Python implementation This document describes the Python realization of the CodeAct design in -[`docs/decisions/0024-codeact-integration.md`](../../decisions/0024-codeact-integration.md). +[`docs/decisions/0029-codeact-integration.md`](../../decisions/0029-codeact-integration.md). This document is intentionally focused on the Python design and public API surface. The initial public Python type described here is `HyperlightCodeActProvider`. Future Python backends, such as Monty, should follow the same conceptual model with their own concrete provider types rather than through a public abstract base class or a public executor parameter. @@ -23,7 +23,7 @@ Implementation-free outcome: ## What is the problem being solved? -The cross-SDK problem statement and decision rationale live in the [ADR](../../decisions/0024-codeact-integration.md). The items below narrow that statement to Python-specific design concerns: +The cross-SDK problem statement and decision rationale live in the [ADR](../../decisions/0029-codeact-integration.md). The items below narrow that statement to Python-specific design concerns: - Today, the easiest way to prototype CodeAct is to infer or reshape the agent's direct tool surface, which is fragile and hard to reason about. - In Python, inferring a CodeAct tool surface from generic agent tool configuration is fragile and hard to reason about. diff --git a/dotnet/src/Microsoft.Agents.AI.Hyperlight/README.md b/dotnet/src/Microsoft.Agents.AI.Hyperlight/README.md index 5f6efdb0f6..c5e4e1e4c5 100644 --- a/dotnet/src/Microsoft.Agents.AI.Hyperlight/README.md +++ b/dotnet/src/Microsoft.Agents.AI.Hyperlight/README.md @@ -1,6 +1,6 @@ # Microsoft.Agents.AI.Hyperlight -First-class [CodeAct](../../../docs/decisions/0024-codeact-integration.md) +First-class [CodeAct](../../../docs/decisions/0029-codeact-integration.md) support for the Microsoft Agent Framework, backed by the [Hyperlight](https://github.com/hyperlight-dev/hyperlight) VM-isolated sandbox.