ontology-atlas

Overview Schema Source Related Servers Discussions Admin

reclassify_concept

Destructive

Change a concept's kind, and optionally its slug or domain, in one previewable multi-file transaction. Preserves the UID, adds redirects, and defaults to dry-run.

Instructions

⚠ MULTI-FILE WRITE — change a concept kind and optionally its canonical slug/domain in one previewable transaction. The permanent UID is preserved. Redirects backlinks like rename_concept, and a referrer that lists the node under domains/capabilities/elements moves the entry to the list for the new kind when its own kind keeps that list; otherwise the entry stays and warnings names it. Replaces a generated starter body with the new kind template while preserving custom prose. Defaults to dry-run.

Input Schema

TableJSON Schema

Name	Required	Description
`body`	No	Optional explicit replacement body.
`slug`	Yes	Current canonical slug.
`domain`	No	New domain; required for capability/element.
`confirm`	No
`newKind`	Yes
`newSlug`	No	Optional new canonical slug.
`expected_mtime`	No

Output Schema

TableJSON Schema

Name	Required	Description
`ok`	Yes
`uid`	Yes
`dryRun`	Yes
`changed`	Yes
`newKind`	Yes
`newSlug`	Yes
`oldKind`	Yes
`oldSlug`	Yes
`warnings`	No
`bodyAction`	Yes
`canConfirm`	Yes	True only when repeating the call with confirm:true can perform the previewed change without another explicit safety opt-in.
`sourcePath`	Yes
`targetPath`	Yes
`wouldChange`	Yes	True only when the dry-run predicts a disk or Git change.
`previewReady`	Yes	True only when this response is a complete dry-run preview that an agent can review.
`blockedReasons`	Yes	Machine-readable human explanations for every condition currently blocking confirmation.
`backlinkUpdates`	Yes
`postWriteMaintenance`	No	Compact maintenance_plan summary for post-write follow-up. Bucket maps describe the remaining queue after the write.

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedv1.4.0Oct 1, 2026
- addedOutput schema / properties / warnings
```
Added value: +{
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}
```

Changed4 schema fields changedv1.3.0Sep 23, 2026

changedOutput schema / properties / postWriteMaintenance / properties / actions / items / properties / kind / enum

Previous value: -[
-  "inspect_compile_issue",
-  "break_dependency_cycle",
-  "canonicalize_graph_arrays",
-  "resolve_dangling_reference",
-  "add_missing_relation",
-  "materialize_external_element",
-  "unassigned_node",
-  "empty_domain",
-  "separate_evidence_from_concept",
-  "fold_bulk_siblings",
-  "retire_unearned_node",
-  "capability_without_evidence",
-  "rejudge_summary_membership"
-]New value: +[
+  "inspect_compile_issue",
+  "break_dependency_cycle",
+  "canonicalize_graph_arrays",
+  "resolve_dangling_reference",
+  "add_missing_relation",
+  "materialize_external_element",
+  "unassigned_node",
+  "empty_domain",
+  "separate_evidence_from_concept",
+  "fold_bulk_siblings",
+  "retire_unearned_node",
+  "capability_without_evidence",
+  "rejudge_summary_membership",
+  "definition_missing",
+  "boundary_missing",
+  "epistemic_exclusion",
+  "folder_only_evidence",
+  "slug_outside_kind_folder",
+  "uncertainty_missing",
+  "retire_starter_example"
+]

changedOutput schema / properties / postWriteMaintenance / properties / filters / properties / kinds / items / enum

Previous value: -[
-  "inspect_compile_issue",
-  "break_dependency_cycle",
-  "canonicalize_graph_arrays",
-  "resolve_dangling_reference",
-  "add_missing_relation",
-  "materialize_external_element",
-  "unassigned_node",
-  "empty_domain",
-  "separate_evidence_from_concept",
-  "fold_bulk_siblings",
-  "retire_unearned_node",
-  "capability_without_evidence",
-  "rejudge_summary_membership"
-]New value: +[
+  "inspect_compile_issue",
+  "break_dependency_cycle",
+  "canonicalize_graph_arrays",
+  "resolve_dangling_reference",
+  "add_missing_relation",
+  "materialize_external_element",
+  "unassigned_node",
+  "empty_domain",
+  "separate_evidence_from_concept",
+  "fold_bulk_siblings",
+  "retire_unearned_node",
+  "capability_without_evidence",
+  "rejudge_summary_membership",
+  "definition_missing",
+  "boundary_missing",
+  "epistemic_exclusion",
+  "folder_only_evidence",
+  "slug_outside_kind_folder",
+  "uncertainty_missing",
+  "retire_starter_example"
+]

changedOutput schema / properties / postWriteMaintenance / properties / nextExecutableAction / properties / kind / enum

Previous value: -[
-  "inspect_compile_issue",
-  "break_dependency_cycle",
-  "canonicalize_graph_arrays",
-  "resolve_dangling_reference",
-  "add_missing_relation",
-  "materialize_external_element",
-  "unassigned_node",
-  "empty_domain",
-  "separate_evidence_from_concept",
-  "fold_bulk_siblings",
-  "retire_unearned_node",
-  "capability_without_evidence",
-  "rejudge_summary_membership"
-]New value: +[
+  "inspect_compile_issue",
+  "break_dependency_cycle",
+  "canonicalize_graph_arrays",
+  "resolve_dangling_reference",
+  "add_missing_relation",
+  "materialize_external_element",
+  "unassigned_node",
+  "empty_domain",
+  "separate_evidence_from_concept",
+  "fold_bulk_siblings",
+  "retire_unearned_node",
+  "capability_without_evidence",
+  "rejudge_summary_membership",
+  "definition_missing",
+  "boundary_missing",
+  "epistemic_exclusion",
+  "folder_only_evidence",
+  "slug_outside_kind_folder",
+  "uncertainty_missing",
+  "retire_starter_example"
+]

changedOutput schema / properties / postWriteMaintenance / properties / nextReviewAction / properties / kind / enum

Previous value: -[
-  "inspect_compile_issue",
-  "break_dependency_cycle",
-  "canonicalize_graph_arrays",
-  "resolve_dangling_reference",
-  "add_missing_relation",
-  "materialize_external_element",
-  "unassigned_node",
-  "empty_domain",
-  "separate_evidence_from_concept",
-  "fold_bulk_siblings",
-  "retire_unearned_node",
-  "capability_without_evidence",
-  "rejudge_summary_membership"
-]New value: +[
+  "inspect_compile_issue",
+  "break_dependency_cycle",
+  "canonicalize_graph_arrays",
+  "resolve_dangling_reference",
+  "add_missing_relation",
+  "materialize_external_element",
+  "unassigned_node",
+  "empty_domain",
+  "separate_evidence_from_concept",
+  "fold_bulk_siblings",
+  "retire_unearned_node",
+  "capability_without_evidence",
+  "rejudge_summary_membership",
+  "definition_missing",
+  "boundary_missing",
+  "epistemic_exclusion",
+  "folder_only_evidence",
+  "slug_outside_kind_folder",
+  "uncertainty_missing",
+  "retire_starter_example"
+]

Changed8 schema fields changedv1.2.5Sep 15, 2026

addedOutput schema / properties / postWriteMaintenance / properties / actions / items / allOf

Added value: +[
+  {
+    "if": {
+      "properties": {
+        "executable": {
+          "const": true
+        }
+      },
+      "required": [
+        "executable"
+      ]
+    },
+    "then": {
+      "properties": {
+        "proposedAction": {
+          "additionalProperties": false,
+          "properties": {
+            "args": {
+              "oneOf": [
+                {
+                  "additionalProperties": false,
+                  "properties": {
+                    "kind": {
+                      "enum": [
+                        "project",
+                        "domain",
+                        "capability",
+                        "element",
+                        "document",
+                        "vault-readme"
+                      ],
+                      "minLength": 1,
+                      "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                      "type": "string"
+                    },
+                    "slug": {
+                      "minLength": 1,
+                      "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                      "type": "string"
+                    },
+                    "title": {
+                      "minLength": 1,
+                      "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "slug",
+                    "kind",
+                    "title"
+                  ],
+                  "type": "object"
+                },
+                {
+                  "additionalProperties": false,
+                  "properties": {
+                    "from": {
+                      "minLength": 1,
+                      "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                      "type": "string"
+                    },
+                    "to": {
+                      "minLength": 1,
+                      "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                      "type": "string"
+                    },
+                    "type": {
+                      "enum": [
+                        "depends_on",
+                        "relates",
+                        "contains",
+                        "describes",
+                        "domains",
+                        "capabilities",
+                        "elements",
+                        "domain"
+                      ],
+                      "minLength": 1,
+                      "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                      "type": "string"
+                    },
+                    "why": {
+                      "description": "One-line rationale for this relation (\"A leans on B because ...\"). Stored in the SAME frontmatter write as the ref (relation_notes map) — write it whenever you know the reason; a graph edge without a why is a mind-map line, not an ontology claim.",
+                      "maxLength": 300,
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "from",
+                    "to",
+                    "type"
+                  ],
+                  "type": "object"
+                },
+                {
+                  "additionalProperties": false,
+                  "properties": {
+                    "expected_mtime": {
+                      "minimum": 0,
+                      "type": "number"
+                    },
+                    "frontmatter": {
+                      "additionalProperties": false,
+                      "properties": {
+                        "broader": {
+                          "items": {
+                            "minLength": 1,
+                            "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                            "type": "string"
+                          },
+                          "maxItems": 500,
+                          "type": "array"
+                        },
+                        "capabilities": {
+                          "items": {
+                            "minLength": 1,
+                            "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                            "type": "string"
+                          },
+                          "maxItems": 500,
+                          "type": "array"
+                        },
+                        "contains": {
+                          "items": {
+                            "minLength": 1,
+                            "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                            "type": "string"
+                          },
+                          "maxItems": 500,
+                          "type": "array"
+                        },
+                        "dependencies": {
+                          "items": {
+                            "minLength": 1,
+                            "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                            "type": "string"
+                          },
+                          "maxItems": 500,
+                          "type": "array"
+                        },
+                        "depends_on": {
+                          "items": {
+                            "minLength": 1,
+                            "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                            "type": "string"
+                          },
+                          "maxItems": 500,
+                          "type": "array"
+                        },
+                        "describes": {
+                          "items": {
+                            "minLength": 1,
+                            "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                            "type": "string"
+                          },
+                          "maxItems": 500,
+                          "type": "array"
+                        },
+                        "domains": {
+                          "items": {
+                            "minLength": 1,
+                            "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                            "type": "string"
+                          },
+                          "maxItems": 500,
+                          "type": "array"
+                        },
+                        "elements": {
+                          "items": {
+                            "minLength": 1,
+                            "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                            "type": "string"
+                          },
+                          "maxItems": 500,
+                          "type": "array"
+                        },
+                        "relates": {
+                          "items": {
+                            "minLength": 1,
+                            "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                            "type": "string"
+                          },
+                          "maxItems": 500,
+                          "type": "array"
+                        }
+                      },
+                      "type": "object"
+                    },
+                    "slug": {
+                      "minLength": 1,
+                      "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "slug",
+                    "frontmatter",
+                    "expected_mtime"
+                  ],
+                  "type": "object"
+                }
+              ]
+            },
+            "tool": {
+              "enum": [
+                "add_concept",
+                "add_relation",
+                "patch_concept"
+              ],
+              "minLength": 1,
+              "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+              "type": "string"
+            }
+          },
+          "required": [
+            "tool",
+            "args"
+          ],
+          "type": "object"
+        }
+      },
+      "required": [
+        "proposedAction"
+      ]
+    }
+  }
+]

changedOutput schema / properties / postWriteMaintenance / properties / actions / items / required

Previous value: -[
-  "id",
-  "phase",
-  "kind",
-  "severity",
-  "score",
-  "executable",
-  "reason",
-  "proposedAction"
-]New value: +[
+  "id",
+  "phase",
+  "kind",
+  "severity",
+  "score",
+  "executable",
+  "reason"
+]

addedOutput schema / properties / postWriteMaintenance / properties / nextExecutableAction / allOf

Added value: +[
+  {
+    "if": {
+      "properties": {
+        "executable": {
+          "const": true
+        }
+      },
+      "required": [
+        "executable"
+      ]
+    },
+    "then": {
+      "properties": {
+        "proposedAction": {
+          "additionalProperties": false,
+          "properties": {
+            "args": {
+              "oneOf": [
+                {
+                  "additionalProperties": false,
+                  "properties": {
+                    "kind": {
+                      "enum": [
+                        "project",
+                        "domain",
+                        "capability",
+                        "element",
+                        "document",
+                        "vault-readme"
+                      ],
+                      "minLength": 1,
+                      "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                      "type": "string"
+                    },
+                    "slug": {
+                      "minLength": 1,
+                      "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                      "type": "string"
+                    },
+                    "title": {
+                      "minLength": 1,
+                      "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "slug",
+                    "kind",
+                    "title"
+                  ],
+                  "type": "object"
+                },
+                {
+                  "additionalProperties": false,
+                  "properties": {
+                    "from": {
+                      "minLength": 1,
+                      "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                      "type": "string"
+                    },
+                    "to": {
+                      "minLength": 1,
+                      "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                      "type": "string"
+                    },
+                    "type": {
+                      "enum": [
+                        "depends_on",
+                        "relates",
+                        "contains",
+                        "describes",
+                        "domains",
+                        "capabilities",
+                        "elements",
+                        "domain"
+                      ],
+                      "minLength": 1,
+                      "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                      "type": "string"
+                    },
+                    "why": {
+                      "description": "One-line rationale for this relation (\"A leans on B because ...\"). Stored in the SAME frontmatter write as the ref (relation_notes map) — write it whenever you know the reason; a graph edge without a why is a mind-map line, not an ontology claim.",
+                      "maxLength": 300,
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "from",
+                    "to",
+                    "type"
+                  ],
+                  "type": "object"
+                },
+                {
+                  "additionalProperties": false,
+                  "properties": {
+                    "expected_mtime": {
+                      "minimum": 0,
+                      "type": "number"
+                    },
+                    "frontmatter": {
+                      "additionalProperties": false,
+                      "properties": {
+                        "broader": {
+                          "items": {
+                            "minLength": 1,
+                            "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                            "type": "string"
+                          },
+                          "maxItems": 500,
+                          "type": "array"
+                        },
+                        "capabilities": {
+                          "items": {
+                            "minLength": 1,
+                            "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                            "type": "string"
+                          },
+                          "maxItems": 500,
+                          "type": "array"
+                        },
+                        "contains": {
+                          "items": {
+                            "minLength": 1,
+                            "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                            "type": "string"
+                          },
+                          "maxItems": 500,
+                          "type": "array"
+                        },
+                        "dependencies": {
+                          "items": {
+                            "minLength": 1,
+                            "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                            "type": "string"
+                          },
+                          "maxItems": 500,
+                          "type": "array"
+                        },
+                        "depends_on": {
+                          "items": {
+                            "minLength": 1,
+                            "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                            "type": "string"
+                          },
+                          "maxItems": 500,
+                          "type": "array"
+                        },
+                        "describes": {
+                          "items": {
+                            "minLength": 1,
+                            "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                            "type": "string"
+                          },
+                          "maxItems": 500,
+                          "type": "array"
+                        },
+                        "domains": {
+                          "items": {
+                            "minLength": 1,
+                            "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                            "type": "string"
+                          },
+                          "maxItems": 500,
+                          "type": "array"
+                        },
+                        "elements": {
+                          "items": {
+                            "minLength": 1,
+                            "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                            "type": "string"
+                          },
+                          "maxItems": 500,
+                          "type": "array"
+                        },
+                        "relates": {
+                          "items": {
+                            "minLength": 1,
+                            "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                            "type": "string"
+                          },
+                          "maxItems": 500,
+                          "type": "array"
+                        }
+                      },
+                      "type": "object"
+                    },
+                    "slug": {
+                      "minLength": 1,
+                      "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "slug",
+                    "frontmatter",
+                    "expected_mtime"
+                  ],
+                  "type": "object"
+                }
+              ]
+            },
+            "tool": {
+              "enum": [
+                "add_concept",
+                "add_relation",
+                "patch_concept"
+              ],
+              "minLength": 1,
+              "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+              "type": "string"
+            }
+          },
+          "required": [
+            "tool",
+            "args"
+          ],
+          "type": "object"
+        }
+      },
+      "required": [
+        "proposedAction"
+      ]
+    }
+  }
+]

changedOutput schema / properties / postWriteMaintenance / properties / nextExecutableAction / required

Previous value: -[
-  "id",
-  "phase",
-  "kind",
-  "severity",
-  "score",
-  "executable",
-  "reason",
-  "proposedAction"
-]New value: +[
+  "id",
+  "phase",
+  "kind",
+  "severity",
+  "score",
+  "executable",
+  "reason"
+]

addedOutput schema / properties / postWriteMaintenance / properties / nextReviewAction / allOf

Added value: +[
+  {
+    "if": {
+      "properties": {
+        "executable": {
+          "const": true
+        }
+      },
+      "required": [
+        "executable"
+      ]
+    },
+    "then": {
+      "properties": {
+        "proposedAction": {
+          "additionalProperties": false,
+          "properties": {
+            "args": {
+              "oneOf": [
+                {
+                  "additionalProperties": false,
+                  "properties": {
+                    "kind": {
+                      "enum": [
+                        "project",
+                        "domain",
+                        "capability",
+                        "element",
+                        "document",
+                        "vault-readme"
+                      ],
+                      "minLength": 1,
+                      "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                      "type": "string"
+                    },
+                    "slug": {
+                      "minLength": 1,
+                      "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                      "type": "string"
+                    },
+                    "title": {
+                      "minLength": 1,
+                      "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "slug",
+                    "kind",
+                    "title"
+                  ],
+                  "type": "object"
+                },
+                {
+                  "additionalProperties": false,
+                  "properties": {
+                    "from": {
+                      "minLength": 1,
+                      "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                      "type": "string"
+                    },
+                    "to": {
+                      "minLength": 1,
+                      "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                      "type": "string"
+                    },
+                    "type": {
+                      "enum": [
+                        "depends_on",
+                        "relates",
+                        "contains",
+                        "describes",
+                        "domains",
+                        "capabilities",
+                        "elements",
+                        "domain"
+                      ],
+                      "minLength": 1,
+                      "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                      "type": "string"
+                    },
+                    "why": {
+                      "description": "One-line rationale for this relation (\"A leans on B because ...\"). Stored in the SAME frontmatter write as the ref (relation_notes map) — write it whenever you know the reason; a graph edge without a why is a mind-map line, not an ontology claim.",
+                      "maxLength": 300,
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "from",
+                    "to",
+                    "type"
+                  ],
+                  "type": "object"
+                },
+                {
+                  "additionalProperties": false,
+                  "properties": {
+                    "expected_mtime": {
+                      "minimum": 0,
+                      "type": "number"
+                    },
+                    "frontmatter": {
+                      "additionalProperties": false,
+                      "properties": {
+                        "broader": {
+                          "items": {
+                            "minLength": 1,
+                            "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                            "type": "string"
+                          },
+                          "maxItems": 500,
+                          "type": "array"
+                        },
+                        "capabilities": {
+                          "items": {
+                            "minLength": 1,
+                            "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                            "type": "string"
+                          },
+                          "maxItems": 500,
+                          "type": "array"
+                        },
+                        "contains": {
+                          "items": {
+                            "minLength": 1,
+                            "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                            "type": "string"
+                          },
+                          "maxItems": 500,
+                          "type": "array"
+                        },
+                        "dependencies": {
+                          "items": {
+                            "minLength": 1,
+                            "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                            "type": "string"
+                          },
+                          "maxItems": 500,
+                          "type": "array"
+                        },
+                        "depends_on": {
+                          "items": {
+                            "minLength": 1,
+                            "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                            "type": "string"
+                          },
+                          "maxItems": 500,
+                          "type": "array"
+                        },
+                        "describes": {
+                          "items": {
+                            "minLength": 1,
+                            "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                            "type": "string"
+                          },
+                          "maxItems": 500,
+                          "type": "array"
+                        },
+                        "domains": {
+                          "items": {
+                            "minLength": 1,
+                            "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                            "type": "string"
+                          },
+                          "maxItems": 500,
+                          "type": "array"
+                        },
+                        "elements": {
+                          "items": {
+                            "minLength": 1,
+                            "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                            "type": "string"
+                          },
+                          "maxItems": 500,
+                          "type": "array"
+                        },
+                        "relates": {
+                          "items": {
+                            "minLength": 1,
+                            "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                            "type": "string"
+                          },
+                          "maxItems": 500,
+                          "type": "array"
+                        }
+                      },
+                      "type": "object"
+                    },
+                    "slug": {
+                      "minLength": 1,
+                      "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "slug",
+                    "frontmatter",
+                    "expected_mtime"
+                  ],
+                  "type": "object"
+                }
+              ]
+            },
+            "tool": {
+              "enum": [
+                "add_concept",
+                "add_relation",
+                "patch_concept"
+              ],
+              "minLength": 1,
+              "pattern": "^(?!\\s)(?!.*\\s$)(?!.*\\u0000).+$",
+              "type": "string"
+            }
+          },
+          "required": [
+            "tool",
+            "args"
+          ],
+          "type": "object"
+        }
+      },
+      "required": [
+        "proposedAction"
+      ]
+    }
+  }
+]

changedOutput schema / properties / postWriteMaintenance / properties / nextReviewAction / required

Previous value: -[
-  "id",
-  "phase",
-  "kind",
-  "severity",
-  "score",
-  "executable",
-  "reason",
-  "proposedAction"
-]New value: +[
+  "id",
+  "phase",
+  "kind",
+  "severity",
+  "score",
+  "executable",
+  "reason"
+]

addedOutput schema / properties / postWriteMaintenance / properties / summary / properties / capabilitiesWithoutEvidence
```
Added value: +{
+  "minimum": 0,
+  "type": "integer"
+}
```

changedOutput schema / properties / postWriteMaintenance / properties / summary / required

Previous value: -[
-  "totalActions",
-  "filteredActions",
-  "remainingActions",
-  "executableActions",
-  "reviewActions",
-  "compileIssues",
-  "dependencyCycles",
-  "canonicalizationActions",
-  "danglingReferences",
-  "relationRecommendations",
-  "externalElementRefs",
-  "externalElementRefsIgnored",
-  "unassignedNodes",
-  "emptyDomains"
-]New value: +[
+  "totalActions",
+  "filteredActions",
+  "remainingActions",
+  "executableActions",
+  "reviewActions",
+  "compileIssues",
+  "dependencyCycles",
+  "canonicalizationActions",
+  "danglingReferences",
+  "relationRecommendations",
+  "externalElementRefs",
+  "externalElementRefsIgnored",
+  "unassignedNodes",
+  "emptyDomains",
+  "capabilitiesWithoutEvidence"
+]

First observedv0.13.0Sep 11, 2026

TDQS

A4.3/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already flag destructive/non-idempotent, and the description adds a lot beyond them: MULTI-FILE WRITE, previewable transaction, dry-run default, UID preservation, backlink redirection, referrer-list movement, body-template replacement, and a `warnings` field. This is exactly the extra consequence detail a mutation needs.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loads the most important signal (the ⚠ MULTI-FILE WRITE warning and dry-run default), and most sentences earn their place. The referrer-list sentence is dense and hard to parse, which mildly hurts readability but not overall economy.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a multi-file mutation with annotations and an output schema (so return values are covered), the description discloses consequences, dry-run behavior, and the warnings field. The main gap is the unexplained expected_mtime parameter and slightly ambiguous list-movement condition.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 57%, and the description compensates by explaining newKind/slug/domain/newSlug semantics, the body replacement rule, and the dry-run default tied to confirm. Only expected_mtime (optimistic-concurrency token) is left unexplained, so it adds meaningful value above the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb+resource (change a concept's kind, optionally slug/domain) and explicitly frames it against a sibling by referencing rename_concept's backlink behavior. An agent can distinguish it from rename_concept/patch_concept without opening schemas.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It compares itself to rename_concept for backlink redirects and notes the dry-run default, which gives context. However, it never states the condition that should make an agent choose reclassify_concept over rename_concept, patch_concept, or merge_concepts, so when-to-use is only implied.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.