diff --git a/.changeset/patch-add-schema-descriptions.md b/.changeset/patch-add-schema-descriptions.md
new file mode 100644
index 00000000000..ac40c3c93d8
--- /dev/null
+++ b/.changeset/patch-add-schema-descriptions.md
@@ -0,0 +1,5 @@
+---
+"gh-aw": patch
+---
+
+Add schema descriptions for runs-on and concurrency fields
diff --git a/.github/workflows/go-logger.lock.yml b/.github/workflows/go-logger.lock.yml
index f64a2d2fd43..f412671046c 100644
--- a/.github/workflows/go-logger.lock.yml
+++ b/.github/workflows/go-logger.lock.yml
@@ -90,7 +90,7 @@ jobs:
         with:
           persist-credentials: false
       - name: Set up Node.js
-        uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020
+        uses: actions/setup-node@a0853c24544627f65ddf259abe73b1d18a591444
         with:
           cache: npm
           cache-dependency-path: pkg/workflow/js/package-lock.json
diff --git a/.github/workflows/technical-doc-writer.lock.yml b/.github/workflows/technical-doc-writer.lock.yml
index f0d8ec889d4..4d0e2910210 100644
--- a/.github/workflows/technical-doc-writer.lock.yml
+++ b/.github/workflows/technical-doc-writer.lock.yml
@@ -493,7 +493,7 @@ jobs:
         with:
           persist-credentials: false
       - name: Setup Node.js
-        uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020
+        uses: actions/setup-node@a0853c24544627f65ddf259abe73b1d18a591444
         with:
           cache: npm
           cache-dependency-path: docs/package-lock.json
diff --git a/.github/workflows/tidy.lock.yml b/.github/workflows/tidy.lock.yml
index ec16335d8d3..e5dff1b8d5a 100644
--- a/.github/workflows/tidy.lock.yml
+++ b/.github/workflows/tidy.lock.yml
@@ -454,7 +454,7 @@ jobs:
         with:
           persist-credentials: false
       - name: Set up Node.js
-        uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020
+        uses: actions/setup-node@a0853c24544627f65ddf259abe73b1d18a591444
         with:
           cache: npm
           cache-dependency-path: pkg/workflow/js/package-lock.json
diff --git a/.github/workflows/unbloat-docs.lock.yml b/.github/workflows/unbloat-docs.lock.yml
index 4ed225b63c4..6f638f2124d 100644
--- a/.github/workflows/unbloat-docs.lock.yml
+++ b/.github/workflows/unbloat-docs.lock.yml
@@ -846,7 +846,7 @@ jobs:
       - name: Checkout repository
         uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8
       - name: Setup Node.js
-        uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020
+        uses: actions/setup-node@2028fbc5c25fe9cf00d9f06a71cc4710d4507903
         with:
           cache: npm
           cache-dependency-path: docs/package-lock.json
diff --git a/pkg/parser/schemas/main_workflow_schema.json b/pkg/parser/schemas/main_workflow_schema.json
index 092dd7f1a85..b0f6fd239b8 100644
--- a/pkg/parser/schemas/main_workflow_schema.json
+++ b/pkg/parser/schemas/main_workflow_schema.json
@@ -1123,6 +1123,7 @@
       }
     },
     "runs-on": {
+      "description": "Runner type for workflow execution (GitHub Actions standard field). Typically configured at the job level instead.",
       "oneOf": [
         {
           "type": "string",
@@ -1161,6 +1162,7 @@
       "examples": [5, 10, 30]
     },
     "concurrency": {
+      "description": "Concurrency control to limit concurrent workflow runs (GitHub Actions standard field). Agentic workflows use enhanced concurrency management.",
       "oneOf": [
         {
           "type": "string",