diff --git a/Taskfile.yml b/Taskfile.yml
index 4489530b..86fb4af8 100644
--- a/Taskfile.yml
+++ b/Taskfile.yml
@@ -6,7 +6,7 @@ vars:
   VERSION: 0.68.0
   BUILD_DIR: bin
   DIST_DIR: dist
-  ADL_SCHEMA_VERSION: v0.29.0
+  ADL_SCHEMA_VERSION: v0.29.1
   ADL_SCHEMA_URL: https://raw.githubusercontent.com/inference-gateway/adl/{{.ADL_SCHEMA_VERSION}}/schema/v1/schema.json
   ADL_SCHEMA_PATH: internal/schema/schema.json
 
diff --git a/internal/schema/schema.json b/internal/schema/schema.json
index 04c62cdd..5339ebc4 100644
--- a/internal/schema/schema.json
+++ b/internal/schema/schema.json
@@ -785,7 +785,7 @@
     },
     "DevelopmentConfig": {
       "type": "object",
-      "description": "Local development experience for the agent: sandboxed dev environments (flox, devcontainer, dockerCompose), AI-assistant integration (CLAUDE.md/AGENTS.md generation, claude-code provisioning), and extra sandbox-level dependencies (deps) for tools that don't belong to any single language's package manager (e.g. deno, kubectl, terraform).",
+      "description": "Local development experience for the agent: sandboxed dev environments (flox, devcontainer, dockerCompose), AI-assistant integration (shared AGENTS.md generation, coding-agent provisioning), and extra sandbox-level dependencies (deps) for tools that don't belong to any single language's package manager (e.g. deno, kubectl, terraform).",
       "properties": {
         "sandbox": { "$ref": "#/definitions/SandboxConfig" },
         "ai": { "$ref": "#/definitions/AIConfig" },
@@ -810,7 +810,7 @@
     },
     "AIConfig": {
       "type": "object",
-      "description": "Configures AI-assistant integration for the agent project: generation of AI-assistant documentation (CLAUDE.md, AGENTS.md) and provisioning of coding-agent orchestrators inside sandbox environments.",
+      "description": "Configures AI-assistant integration for the agent project: generation of AGENTS.md, the shared instructions file every supported orchestrator reads, and provisioning of coding-agent orchestrators inside sandbox environments.",
       "properties": {
         "orchestrators": { "$ref": "#/definitions/OrchestratorsConfig" }
       }
diff --git a/internal/schema/types.go b/internal/schema/types.go
index 10fb77ee..9f460566 100644
--- a/internal/schema/types.go
+++ b/internal/schema/types.go
@@ -19,8 +19,8 @@ type ADL struct {
 }
 
 // Configures AI-assistant integration for the agent project: generation of
-// AI-assistant documentation (CLAUDE.md, AGENTS.md) and provisioning of
-// coding-agent orchestrators inside sandbox environments.
+// AGENTS.md, the shared instructions file every supported orchestrator reads, and
+// provisioning of coding-agent orchestrators inside sandbox environments.
 type AIConfig struct {
 	// Orchestrators corresponds to the JSON schema field "orchestrators".
 	Orchestrators *OrchestratorsConfig `json:"orchestrators,omitempty,omitzero" yaml:"orchestrators,omitempty" mapstructure:"orchestrators,omitempty"`
@@ -320,8 +320,8 @@ type DevContainerConfig struct {
 }
 
 // Local development experience for the agent: sandboxed dev environments (flox,
-// devcontainer, dockerCompose), AI-assistant integration (CLAUDE.md/AGENTS.md
-// generation, claude-code provisioning), and extra sandbox-level dependencies
+// devcontainer, dockerCompose), AI-assistant integration (shared AGENTS.md
+// generation, coding-agent provisioning), and extra sandbox-level dependencies
 // (deps) for tools that don't belong to any single language's package manager
 // (e.g. deno, kubectl, terraform).
 type DevelopmentConfig struct {