OMP Tandem

Overview Schema Source Related Servers Discussions Admin

tandem_review

Capture, read, or compare immutable review bundles against selected Git worktree, staged index, or commit snapshots to assess code changes without executing tests.

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.

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.

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

A4/5.0

Behavior4/5

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

With no annotations, the description carries the full burden and does so well: it discloses that bundles are immutable, that capture records requirements/checks/boundaries without executing tests, that author rationale is withheld until explicitly revealed, and that reads page from the captured bundle rather than the live working directory. It does not cover permissions, rate limits, or what state create persists.

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?

The core capability is front-loaded in the first sentence and the remaining sentences are information-dense with little filler. The run-on line-wrapped prose mixing source semantics, capture behavior, and assess scope is less scannable than short labeled lines would be.

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

Completeness5/5

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

For a multi-action, 8-parameter tool with an output schema present, the description covers the operationally important unknowns: source semantics, immutability, non-execution of tests, rationale withholding, and the snapshot-vs-live distinction. Return-value detail is legitimately delegated to the output schema.

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

Parameters3/5

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

Schema description coverage is reported at 0% across 8 parameters, so the description must compensate and only partly does: it explains request.source and review_id but says nothing about path, limit, offset, section, or the check/criteria shapes. It also refers to paging by 'next_offset', a name that does not exist among the input parameters, which risks confusion.

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 gives a specific verb set (capture, read, compare) and a well-defined resource (an immutable review bundle), and the action enum semantics (create/read/assess) are spelled out later. It does not, however, differentiate itself from the clearly related sibling tandem_review_run, so an agent must infer the boundary.

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?

It gives real conditional guidance: request.source selects base-to-worktree by default vs base-to-staged index, staged captures exclude unstaged/untracked content, and review_id can be bound to a think task for snapshot-only review. What is missing is any explicit when-not or named alternative (e.g. tandem_review_run), so the routing is only partly resolved.

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