OMP Tandem

Overview Schema Source Related Servers Discussions Admin

tandem_review

Capture an immutable review bundle of selected files, compare it with the current Git state, or assess applicability before applying changes. Use prepare to detect and repair selection conflicts without saving anything.

Instructions

Capture or read an immutable review bundle, or compare it with current selected files.

request.source selects base-to-worktree (default) or base-to-staged Git index material. Staged captures exclude unstaged/untracked content; source also governs applicability checks. Capture includes requirements, supplied checks and boundaries without executing tests. Bind review_id to a think task for snapshot-only review. Author rationale is withheld unless explicitly revealed in a comparison turn. Read pages by next_offset, not the live working directory. assess reports applicability at observation time, not whole-system correctness. prepare classifies the same request without saving anything: it reports every repairable selection conflict at once and proposes the corrected paths, which the caller decides whether to apply. It reserves nothing, so capture classifies the files again and a repaired request is a new request, not a retry.

Input Schema

TableJSON Schema

Name	Required	Default
`path`	No
`limit`	No
`action`	Yes
`offset`	No
`request`	No
`section`	No	manifest
`review_id`	No
`reveal_author`	No

Output Schema

TableJSON Schema

Name	Required	Description	Default
No arguments

Schema Changelog

Changes observed during successful MCP inspections.

Changed2 schema fields changedv3.10.0Sep 17, 2026

changedInput schema / properties / action / enum

Previous value: -[
-  "create",
-  "read",
-  "assess"
-]New value: +[
+  "create",
+  "prepare",
+  "read",
+  "assess"
+]

changedInput schema / properties / request / anyOf

Previous value: -[
-  {
-    "properties": {
-      "author_proposal": {
-        "default": "",
-        "maxLength": 200000,
-        "type": "string"
-      },
-      "author_rationale": {
-        "default": "",
-        "maxLength": 200000,
-        "type": "string"
-      },
-      "base": {
-        "default": "HEAD",
-        "maxLength": 200,
-        "minLength": 1,
-        "type": "string"
-      },
-      "checks": {
-        "items": {
-          "properties": {
-            "code_fingerprint": {
-              "anyOf": [
-                {
-                  "pattern": "^[0-9a-f]{64}$",
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "default": null
-            },
-            "command": {
-              "anyOf": [
-                {
-                  "maxLength": 4000,
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "default": null
-            },
-            "name": {
-              "maxLength": 200,
-              "minLength": 1,
-              "type": "string"
-            },
-            "output": {
-              "maxLength": 1048576,
-              "type": "string"
-            },
-            "source": {
-              "default": "coordinator supplied",
-              "maxLength": 1000,
-              "type": "string"
-            }
-          },
-          "required": [
-            "name",
-            "output"
-          ],
-          "type": "object"
-        },
-        "maxItems": 32,
-        "type": "array"
-      },
-      "commit": {
-        "anyOf": [
-          {
-            "maxLength": 200,
-            "minLength": 1,
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "description": "Required with source=commit: the exact committed snapshot to review against base."
-      },
-      "context_paths": {
-        "description": "Explicit additional saved context; staged reviews use index bytes, never live files.",
-        "items": {
-          "type": "string"
-        },
-        "maxItems": 256,
-        "type": "array"
-      },
-      "corrective": {
-        "anyOf": [
-          {
-            "description": "Explicit prior exposure, never permission to reuse a prior verdict.",
-            "properties": {
-              "open_findings": {
-                "items": {
-                  "properties": {
-                    "expected_revision": {
-                      "minimum": 1,
-                      "type": "integer"
-                    },
-                    "finding_id": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "finding_id",
-                    "expected_revision"
-                  ],
-                  "type": "object"
-                },
-                "maxItems": 100,
-                "type": "array"
-              },
-              "previous_code_fingerprint": {
-                "pattern": "^[0-9a-f]{64}$",
-                "type": "string"
-              },
-              "previous_review_id": {
-                "type": "string"
-              }
-            },
-            "required": [
-              "previous_review_id",
-              "previous_code_fingerprint"
-            ],
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null
-      },
-      "criteria": {
-        "items": {
-          "type": "string"
-        },
-        "maxItems": 100,
-        "type": "array"
-      },
-      "external_boundaries": {
-        "items": {
-          "type": "string"
-        },
-        "maxItems": 100,
-        "type": "array"
-      },
-      "paths": {
-        "anyOf": [
-          {
-            "items": {
-              "type": "string"
-            },
-            "maxItems": 256,
-            "minItems": 1,
-            "type": "array"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null
-      },
-      "requirements": {
-        "maxLength": 200000,
-        "minLength": 1,
-        "type": "string"
-      },
-      "source": {
-        "default": "worktree",
-        "description": "Select worktree bytes, Git index bytes, or the tree of an existing commit compared with base. Staged and commit captures never read live files.",
-        "enum": [
-          "worktree",
-          "staged",
-          "commit"
-        ],
-        "type": "string"
-      }
-    },
-    "required": [
-      "requirements"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "properties": {
+      "author_proposal": {
+        "default": "",
+        "maxLength": 200000,
+        "type": "string"
+      },
+      "author_rationale": {
+        "default": "",
+        "maxLength": 200000,
+        "type": "string"
+      },
+      "base": {
+        "default": "HEAD",
+        "maxLength": 200,
+        "minLength": 1,
+        "type": "string"
+      },
+      "checks": {
+        "items": {
+          "properties": {
+            "code_fingerprint": {
+              "anyOf": [
+                {
+                  "pattern": "^[0-9a-f]{64}$",
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null
+            },
+            "command": {
+              "anyOf": [
+                {
+                  "maxLength": 4000,
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null
+            },
+            "name": {
+              "maxLength": 200,
+              "minLength": 1,
+              "type": "string"
+            },
+            "output": {
+              "maxLength": 1048576,
+              "type": "string"
+            },
+            "source": {
+              "default": "coordinator supplied",
+              "maxLength": 1000,
+              "type": "string"
+            }
+          },
+          "required": [
+            "name",
+            "output"
+          ],
+          "type": "object"
+        },
+        "maxItems": 32,
+        "type": "array"
+      },
+      "commit": {
+        "anyOf": [
+          {
+            "maxLength": 200,
+            "minLength": 1,
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Required with source=commit: the exact committed snapshot to review against base."
+      },
+      "context_paths": {
+        "description": "Explicit additional saved context; staged reviews use index bytes, never live files.",
+        "items": {
+          "type": "string"
+        },
+        "maxItems": 256,
+        "type": "array"
+      },
+      "corrective": {
+        "anyOf": [
+          {
+            "description": "Explicit prior exposure, never permission to reuse a prior verdict.",
+            "properties": {
+              "open_findings": {
+                "items": {
+                  "properties": {
+                    "expected_revision": {
+                      "minimum": 1,
+                      "type": "integer"
+                    },
+                    "finding_id": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "finding_id",
+                    "expected_revision"
+                  ],
+                  "type": "object"
+                },
+                "maxItems": 100,
+                "type": "array"
+              },
+              "previous_code_fingerprint": {
+                "pattern": "^[0-9a-f]{64}$",
+                "type": "string"
+              },
+              "previous_review_id": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "previous_review_id",
+              "previous_code_fingerprint"
+            ],
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null
+      },
+      "criteria": {
+        "items": {
+          "type": "string"
+        },
+        "maxItems": 100,
+        "type": "array"
+      },
+      "external_boundaries": {
+        "items": {
+          "type": "string"
+        },
+        "maxItems": 100,
+        "type": "array"
+      },
+      "paths": {
+        "anyOf": [
+          {
+            "items": {
+              "type": "string"
+            },
+            "maxItems": 256,
+            "minItems": 1,
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null
+      },
+      "requirements": {
+        "maxLength": 200000,
+        "minLength": 1,
+        "type": "string"
+      },
+      "review_directory": {
+        "default": "",
+        "description": "Directory inside the launch project whose Git state is reviewed, relative to the project root. Use it when the work lives in a nested repository or a subtree with its own history. Selected and context paths stay relative to the project root regardless. Empty means the project root itself.",
+        "maxLength": 4096,
+        "type": "string"
+      },
+      "source": {
+        "default": "worktree",
+        "description": "Select worktree bytes, Git index bytes, or the tree of an existing commit compared with base. Staged and commit captures never read live files.",
+        "enum": [
+          "worktree",
+          "staged",
+          "commit"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "requirements"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

Changed1 schema field changedv3.8.0Sep 16, 2026

changedInput schema / properties / request / anyOf

Previous value: -[
-  {
-    "properties": {
-      "author_proposal": {
-        "default": "",
-        "maxLength": 200000,
-        "type": "string"
-      },
-      "author_rationale": {
-        "default": "",
-        "maxLength": 200000,
-        "type": "string"
-      },
-      "base": {
-        "default": "HEAD",
-        "maxLength": 200,
-        "minLength": 1,
-        "type": "string"
-      },
-      "checks": {
-        "items": {
-          "properties": {
-            "code_fingerprint": {
-              "anyOf": [
-                {
-                  "pattern": "^[0-9a-f]{64}$",
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "default": null
-            },
-            "command": {
-              "anyOf": [
-                {
-                  "maxLength": 4000,
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "default": null
-            },
-            "name": {
-              "maxLength": 200,
-              "minLength": 1,
-              "type": "string"
-            },
-            "output": {
-              "maxLength": 1048576,
-              "type": "string"
-            },
-            "source": {
-              "default": "coordinator supplied",
-              "maxLength": 1000,
-              "type": "string"
-            }
-          },
-          "required": [
-            "name",
-            "output"
-          ],
-          "type": "object"
-        },
-        "maxItems": 32,
-        "type": "array"
-      },
-      "commit": {
-        "anyOf": [
-          {
-            "maxLength": 200,
-            "minLength": 1,
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null,
-        "description": "Required with source=commit: the exact committed snapshot to review against base."
-      },
-      "context_paths": {
-        "description": "Explicit additional saved context; staged reviews use index bytes, never live files.",
-        "items": {
-          "type": "string"
-        },
-        "maxItems": 256,
-        "type": "array"
-      },
-      "criteria": {
-        "items": {
-          "type": "string"
-        },
-        "maxItems": 100,
-        "type": "array"
-      },
-      "external_boundaries": {
-        "items": {
-          "type": "string"
-        },
-        "maxItems": 100,
-        "type": "array"
-      },
-      "paths": {
-        "anyOf": [
-          {
-            "items": {
-              "type": "string"
-            },
-            "maxItems": 256,
-            "minItems": 1,
-            "type": "array"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null
-      },
-      "requirements": {
-        "maxLength": 200000,
-        "minLength": 1,
-        "type": "string"
-      },
-      "source": {
-        "default": "worktree",
-        "description": "Select worktree bytes, Git index bytes, or the tree of an existing commit compared with base. Staged and commit captures never read live files.",
-        "enum": [
-          "worktree",
-          "staged",
-          "commit"
-        ],
-        "type": "string"
-      }
-    },
-    "required": [
-      "requirements"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "properties": {
+      "author_proposal": {
+        "default": "",
+        "maxLength": 200000,
+        "type": "string"
+      },
+      "author_rationale": {
+        "default": "",
+        "maxLength": 200000,
+        "type": "string"
+      },
+      "base": {
+        "default": "HEAD",
+        "maxLength": 200,
+        "minLength": 1,
+        "type": "string"
+      },
+      "checks": {
+        "items": {
+          "properties": {
+            "code_fingerprint": {
+              "anyOf": [
+                {
+                  "pattern": "^[0-9a-f]{64}$",
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null
+            },
+            "command": {
+              "anyOf": [
+                {
+                  "maxLength": 4000,
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null
+            },
+            "name": {
+              "maxLength": 200,
+              "minLength": 1,
+              "type": "string"
+            },
+            "output": {
+              "maxLength": 1048576,
+              "type": "string"
+            },
+            "source": {
+              "default": "coordinator supplied",
+              "maxLength": 1000,
+              "type": "string"
+            }
+          },
+          "required": [
+            "name",
+            "output"
+          ],
+          "type": "object"
+        },
+        "maxItems": 32,
+        "type": "array"
+      },
+      "commit": {
+        "anyOf": [
+          {
+            "maxLength": 200,
+            "minLength": 1,
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Required with source=commit: the exact committed snapshot to review against base."
+      },
+      "context_paths": {
+        "description": "Explicit additional saved context; staged reviews use index bytes, never live files.",
+        "items": {
+          "type": "string"
+        },
+        "maxItems": 256,
+        "type": "array"
+      },
+      "corrective": {
+        "anyOf": [
+          {
+            "description": "Explicit prior exposure, never permission to reuse a prior verdict.",
+            "properties": {
+              "open_findings": {
+                "items": {
+                  "properties": {
+                    "expected_revision": {
+                      "minimum": 1,
+                      "type": "integer"
+                    },
+                    "finding_id": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "finding_id",
+                    "expected_revision"
+                  ],
+                  "type": "object"
+                },
+                "maxItems": 100,
+                "type": "array"
+              },
+              "previous_code_fingerprint": {
+                "pattern": "^[0-9a-f]{64}$",
+                "type": "string"
+              },
+              "previous_review_id": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "previous_review_id",
+              "previous_code_fingerprint"
+            ],
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null
+      },
+      "criteria": {
+        "items": {
+          "type": "string"
+        },
+        "maxItems": 100,
+        "type": "array"
+      },
+      "external_boundaries": {
+        "items": {
+          "type": "string"
+        },
+        "maxItems": 100,
+        "type": "array"
+      },
+      "paths": {
+        "anyOf": [
+          {
+            "items": {
+              "type": "string"
+            },
+            "maxItems": 256,
+            "minItems": 1,
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null
+      },
+      "requirements": {
+        "maxLength": 200000,
+        "minLength": 1,
+        "type": "string"
+      },
+      "source": {
+        "default": "worktree",
+        "description": "Select worktree bytes, Git index bytes, or the tree of an existing commit compared with base. Staged and commit captures never read live files.",
+        "enum": [
+          "worktree",
+          "staged",
+          "commit"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "requirements"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

Changed1 schema field changedv3.5.0Sep 11, 2026

changedInput schema / properties / request / anyOf

Previous value: -[
-  {
-    "properties": {
-      "author_proposal": {
-        "default": "",
-        "maxLength": 200000,
-        "type": "string"
-      },
-      "author_rationale": {
-        "default": "",
-        "maxLength": 200000,
-        "type": "string"
-      },
-      "base": {
-        "default": "HEAD",
-        "maxLength": 200,
-        "minLength": 1,
-        "type": "string"
-      },
-      "checks": {
-        "items": {
-          "properties": {
-            "code_fingerprint": {
-              "anyOf": [
-                {
-                  "pattern": "^[0-9a-f]{64}$",
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "default": null
-            },
-            "command": {
-              "anyOf": [
-                {
-                  "maxLength": 4000,
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "default": null
-            },
-            "name": {
-              "maxLength": 200,
-              "minLength": 1,
-              "type": "string"
-            },
-            "output": {
-              "maxLength": 1048576,
-              "type": "string"
-            },
-            "source": {
-              "default": "coordinator supplied",
-              "maxLength": 1000,
-              "type": "string"
-            }
-          },
-          "required": [
-            "name",
-            "output"
-          ],
-          "type": "object"
-        },
-        "maxItems": 32,
-        "type": "array"
-      },
-      "context_paths": {
-        "description": "Explicit additional saved context; staged reviews use index bytes, never live files.",
-        "items": {
-          "type": "string"
-        },
-        "maxItems": 256,
-        "type": "array"
-      },
-      "criteria": {
-        "items": {
-          "type": "string"
-        },
-        "maxItems": 100,
-        "type": "array"
-      },
-      "external_boundaries": {
-        "items": {
-          "type": "string"
-        },
-        "maxItems": 100,
-        "type": "array"
-      },
-      "paths": {
-        "anyOf": [
-          {
-            "items": {
-              "type": "string"
-            },
-            "maxItems": 256,
-            "minItems": 1,
-            "type": "array"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null
-      },
-      "requirements": {
-        "maxLength": 200000,
-        "minLength": 1,
-        "type": "string"
-      },
-      "source": {
-        "default": "worktree",
-        "description": "Select worktree bytes or Git index bytes compared with base. Staged capture never reads live files.",
-        "enum": [
-          "worktree",
-          "staged"
-        ],
-        "type": "string"
-      }
-    },
-    "required": [
-      "requirements"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "properties": {
+      "author_proposal": {
+        "default": "",
+        "maxLength": 200000,
+        "type": "string"
+      },
+      "author_rationale": {
+        "default": "",
+        "maxLength": 200000,
+        "type": "string"
+      },
+      "base": {
+        "default": "HEAD",
+        "maxLength": 200,
+        "minLength": 1,
+        "type": "string"
+      },
+      "checks": {
+        "items": {
+          "properties": {
+            "code_fingerprint": {
+              "anyOf": [
+                {
+                  "pattern": "^[0-9a-f]{64}$",
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null
+            },
+            "command": {
+              "anyOf": [
+                {
+                  "maxLength": 4000,
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null
+            },
+            "name": {
+              "maxLength": 200,
+              "minLength": 1,
+              "type": "string"
+            },
+            "output": {
+              "maxLength": 1048576,
+              "type": "string"
+            },
+            "source": {
+              "default": "coordinator supplied",
+              "maxLength": 1000,
+              "type": "string"
+            }
+          },
+          "required": [
+            "name",
+            "output"
+          ],
+          "type": "object"
+        },
+        "maxItems": 32,
+        "type": "array"
+      },
+      "commit": {
+        "anyOf": [
+          {
+            "maxLength": 200,
+            "minLength": 1,
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Required with source=commit: the exact committed snapshot to review against base."
+      },
+      "context_paths": {
+        "description": "Explicit additional saved context; staged reviews use index bytes, never live files.",
+        "items": {
+          "type": "string"
+        },
+        "maxItems": 256,
+        "type": "array"
+      },
+      "criteria": {
+        "items": {
+          "type": "string"
+        },
+        "maxItems": 100,
+        "type": "array"
+      },
+      "external_boundaries": {
+        "items": {
+          "type": "string"
+        },
+        "maxItems": 100,
+        "type": "array"
+      },
+      "paths": {
+        "anyOf": [
+          {
+            "items": {
+              "type": "string"
+            },
+            "maxItems": 256,
+            "minItems": 1,
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null
+      },
+      "requirements": {
+        "maxLength": 200000,
+        "minLength": 1,
+        "type": "string"
+      },
+      "source": {
+        "default": "worktree",
+        "description": "Select worktree bytes, Git index bytes, or the tree of an existing commit compared with base. Staged and commit captures never read live files.",
+        "enum": [
+          "worktree",
+          "staged",
+          "commit"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "requirements"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

Changed1 schema field changedv3.3.0Sep 10, 2026

changedInput schema / properties / request / anyOf

Previous value: -[
-  {
-    "properties": {
-      "author_proposal": {
-        "default": "",
-        "maxLength": 200000,
-        "type": "string"
-      },
-      "author_rationale": {
-        "default": "",
-        "maxLength": 200000,
-        "type": "string"
-      },
-      "base": {
-        "default": "HEAD",
-        "maxLength": 200,
-        "minLength": 1,
-        "type": "string"
-      },
-      "checks": {
-        "items": {
-          "properties": {
-            "code_fingerprint": {
-              "anyOf": [
-                {
-                  "pattern": "^[0-9a-f]{64}$",
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "default": null
-            },
-            "command": {
-              "anyOf": [
-                {
-                  "maxLength": 4000,
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "default": null
-            },
-            "name": {
-              "maxLength": 200,
-              "minLength": 1,
-              "type": "string"
-            },
-            "output": {
-              "maxLength": 1048576,
-              "type": "string"
-            },
-            "source": {
-              "default": "coordinator supplied",
-              "maxLength": 1000,
-              "type": "string"
-            }
-          },
-          "required": [
-            "name",
-            "output"
-          ],
-          "type": "object"
-        },
-        "maxItems": 32,
-        "type": "array"
-      },
-      "criteria": {
-        "items": {
-          "type": "string"
-        },
-        "maxItems": 100,
-        "type": "array"
-      },
-      "external_boundaries": {
-        "items": {
-          "type": "string"
-        },
-        "maxItems": 100,
-        "type": "array"
-      },
-      "paths": {
-        "anyOf": [
-          {
-            "items": {
-              "type": "string"
-            },
-            "maxItems": 256,
-            "minItems": 1,
-            "type": "array"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "default": null
-      },
-      "requirements": {
-        "maxLength": 200000,
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "requirements"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "properties": {
+      "author_proposal": {
+        "default": "",
+        "maxLength": 200000,
+        "type": "string"
+      },
+      "author_rationale": {
+        "default": "",
+        "maxLength": 200000,
+        "type": "string"
+      },
+      "base": {
+        "default": "HEAD",
+        "maxLength": 200,
+        "minLength": 1,
+        "type": "string"
+      },
+      "checks": {
+        "items": {
+          "properties": {
+            "code_fingerprint": {
+              "anyOf": [
+                {
+                  "pattern": "^[0-9a-f]{64}$",
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null
+            },
+            "command": {
+              "anyOf": [
+                {
+                  "maxLength": 4000,
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null
+            },
+            "name": {
+              "maxLength": 200,
+              "minLength": 1,
+              "type": "string"
+            },
+            "output": {
+              "maxLength": 1048576,
+              "type": "string"
+            },
+            "source": {
+              "default": "coordinator supplied",
+              "maxLength": 1000,
+              "type": "string"
+            }
+          },
+          "required": [
+            "name",
+            "output"
+          ],
+          "type": "object"
+        },
+        "maxItems": 32,
+        "type": "array"
+      },
+      "context_paths": {
+        "description": "Explicit additional saved context; staged reviews use index bytes, never live files.",
+        "items": {
+          "type": "string"
+        },
+        "maxItems": 256,
+        "type": "array"
+      },
+      "criteria": {
+        "items": {
+          "type": "string"
+        },
+        "maxItems": 100,
+        "type": "array"
+      },
+      "external_boundaries": {
+        "items": {
+          "type": "string"
+        },
+        "maxItems": 100,
+        "type": "array"
+      },
+      "paths": {
+        "anyOf": [
+          {
+            "items": {
+              "type": "string"
+            },
+            "maxItems": 256,
+            "minItems": 1,
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null
+      },
+      "requirements": {
+        "maxLength": 200000,
+        "minLength": 1,
+        "type": "string"
+      },
+      "source": {
+        "default": "worktree",
+        "description": "Select worktree bytes or Git index bytes compared with base. Staged capture never reads live files.",
+        "enum": [
+          "worktree",
+          "staged"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "requirements"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

Addedv3.1.0Sep 9, 2026

TDQS

A3.8/5.0

Behavior4/5

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

With no annotations provided, the description carries the full burden and does substantial work: it discloses immutability ('immutable review bundle'), non-execution ('without executing tests'), author rationale withholding unless revealed, snapshot-vs-live semantics ('Read pages by next_offset, not the live working directory'), and the limited scope of assess ('applicability at observation time, not whole-system correctness'). Minor gaps remain around permissions and failure modes.

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

Conciseness2/5

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

The description is a dense wall of prose with no paragraph breaks, bullets, or action-mode segmentation. While the first sentence front-loads the purpose, later sentences are convoluted ('It reserves nothing, so capture classifies the files again and a repaired request is a new request, not a retry'). The length is partly justified by complexity, but the structure makes it hard to scan.

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?

Given the tool's complexity (8 parameters, four actions, an output schema), the description covers the most important semantics: actions, source selection, immutability, author gating, and prepare/assess distinctions. It leaves section/limit semantics implicit, but the presence of an output schema lowers the burden on describing return values.

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 description coverage is 0%, so the burden falls on the prose, and it adds real meaning for several parameters: request.source (worktree default, staged excludes untracked content), review_id (bind to a think task for snapshot-only review), reveal_author (rationale withheld unless revealed), and offset (paging via next_offset). However, path, limit, and especially section are left unexplained, so compensation is partial.

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

Purpose4/5

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

The opening sentence names a specific verb and resource ('Capture or read an immutable review bundle...') and the body clarifies the four action modes (create, prepare, read, assess). It does not explicitly differentiate from the sibling tandem_review_run, but the core purpose is distinguishable and concrete.

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

Usage Guidelines4/5

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

The description gives real when-to-use guidance for the action parameter: prepare 'reports every repairable selection conflict at once... without saving anything', while capture 'classifies the files again and a repaired request is a new request, not a retry'. It also explains source semantics (worktree vs staged) and read paging. It does not name sibling alternatives or exclusions, but internal action routing is well handled.

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

tandem_review

Instructions

Input Schema

Output Schema

Schema Changelog

TDQS

Other Tools