From 15aed8f9ef2efc51851bb4e0aa7277e9060b6b57 Mon Sep 17 00:00:00 2001 From: John CSA <103165870+jluocsa@users.noreply.github.com> Date: Sat, 29 Aug 2026 19:38:37 -0700 Subject: [PATCH 1/2] docs(decisions): resolve duplicate ADR sequence numbers (0016, 0021, 0024) --- .../{0016-structured-output.md => 0036-structured-output.md} | 0 .../{0021-agent-skills-design.md => 0037-agent-skills-design.md} | 0 .../{0024-codeact-integration.md => 0038-codeact-integration.md} | 0 3 files changed, 0 insertions(+), 0 deletions(-) rename docs/decisions/{0016-structured-output.md => 0036-structured-output.md} (100%) rename docs/decisions/{0021-agent-skills-design.md => 0037-agent-skills-design.md} (100%) rename docs/decisions/{0024-codeact-integration.md => 0038-codeact-integration.md} (100%) diff --git a/docs/decisions/0016-structured-output.md b/docs/decisions/0036-structured-output.md similarity index 100% rename from docs/decisions/0016-structured-output.md rename to docs/decisions/0036-structured-output.md diff --git a/docs/decisions/0021-agent-skills-design.md b/docs/decisions/0037-agent-skills-design.md similarity index 100% rename from docs/decisions/0021-agent-skills-design.md rename to docs/decisions/0037-agent-skills-design.md diff --git a/docs/decisions/0024-codeact-integration.md b/docs/decisions/0038-codeact-integration.md similarity index 100% rename from docs/decisions/0024-codeact-integration.md rename to docs/decisions/0038-codeact-integration.md From c2ab48b623af335966b0d120f6ba885af55fee89 Mon Sep 17 00:00:00 2001 From: John CSA <103165870+jluocsa@users.noreply.github.com> Date: Sat, 29 Aug 2026 19:39:59 -0700 Subject: [PATCH 2/2] docs: update cross-references to renumbered ADRs --- 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 ac7041a813d..fad86ea1d43 100644 --- a/README.md +++ b/README.md @@ -56,7 +56,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/0037-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 5a2b51ae3a8..a665a8873e4 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/0038-codeact-integration.md`](../../decisions/0038-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/0038-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 7f45190d339..6d0151c3c00 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/0038-codeact-integration.md`](../../decisions/0038-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/0038-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 5f6efdb0f6f..bb38a7af64c 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/0038-codeact-integration.md) support for the Microsoft Agent Framework, backed by the [Hyperlight](https://github.com/hyperlight-dev/hyperlight) VM-isolated sandbox.